> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas do bot

> As ferramentas disponíveis para o bot e seus parâmetros de configuração

## Ferramentas em nível de bot

A seção **Ferramentas** do bot (não do agente) é o repositório central de ferramentas **personalizadas** disponíveis para esse bot. É diferente da [aba Ferramentas dentro de cada agente](/pt-BR/construccion/agentes/herramientas) — aqui é onde as ferramentas são definidas, e a partir dos agentes elas são atribuídas.

<Info>
  Esta visão mostra apenas as ferramentas **customizadas** criadas para o seu bot — integrações com sistemas externos, consultas a APIs, etc. As **funções gerais** da plataforma (Encerrar Conversa, Transferir para Agente Humano, Detectar Correio de Voz, etc.) não aparecem aqui: essas são ativadas por agente, na [aba Ferramentas de cada agente](/pt-BR/construccion/agentes/herramientas).
</Info>

<img src="https://mintcdn.com/inceptia/2xrQ5P1QkQTHz4UH/images/construccion/herramientas-bot/01-herramientas-bot.png?fit=max&auto=format&n=2xrQ5P1QkQTHz4UH&q=85&s=e1b38f98c3f81c60b621fc636f987f45" alt="Tabela de ferramentas customizadas atribuídas ao bot" width="1440" height="900" data-path="images/construccion/herramientas-bot/01-herramientas-bot.png" />

Cada ferramenta tem três componentes:

| Campo            | Descrição                                                                                                |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Nome**         | Identificador da ferramenta — como o agente a referencia.                                                |
| **Documentação** | Descrição funcional: o que faz, quando usar, o que retorna. O LLM lê isso para decidir se deve chamá-la. |
| **Parâmetros**   | Os dados que a ferramenta precisa para ser executada, com seus tipos e descrições.                       |

***

## Como as ferramentas funcionam

Quando o agente decide chamar uma ferramenta, a plataforma:

<Steps>
  <Step title="Extrai os parâmetros">
    O LLM identifica os valores necessários a partir do contexto da conversa e dos parâmetros do arquivo de campanha.
  </Step>

  <Step title="Executa a ferramenta">
    A plataforma chama o serviço externo (API, banco de dados, etc.) com os parâmetros extraídos.
  </Step>

  <Step title="Retorna o resultado ao agente">
    O resultado é incorporado ao contexto do LLM para que o agente possa usá-lo em sua resposta.
  </Step>
</Steps>

<Info>
  A configuração técnica das ferramentas (endpoints, credenciais, lógica de integração) é feita pela Inceptia. A partir da plataforma, você só gerencia quais ferramentas estão disponíveis e como são documentadas para o agente.
</Info>