> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/otimizacao-do-agente/como-usar-as-ferramentas-e-integracoes-do-agente.md).

# Como usar as Ferramentas e Integrações do agente

A aba **Ferramentas / Integrações** em **Agente > Canais e Integrações** permite conectar seu agente a ferramentas externas (CRMs, bases de documentos, mecanismos de busca e APIs personalizadas). Cada ferramenta ativada pode ser chamada pelo agente durante uma conversa para executar ações ou recuperar informações em tempo real.

#### Como as ferramentas funcionam

Quando uma ferramenta está ativa, o agente pode chamá-la automaticamente durante a conversa sempre que o contexto exigir. Por exemplo, criar um contato no CRM quando um lead é qualificado, ou recuperar um documento da base de conhecimento quando o lead faz uma pergunta específica.

As ferramentas são organizadas em cinco categorias: **Ativas**, **Documentos**, **CRM**, **Pesquisa** e **Personalizado**.

***

#### Ferramentas Ativas

A aba **Ativas** mostra todas as ferramentas que estão habilitadas para este agente no momento. Use-a para ter uma visão consolidada do que está em execução.

***

#### Ferramentas de Documentos

Permitem que o agente consulte uma base de conhecimento durante a conversa. Ideal para responder perguntas sobre produtos, preços, políticas ou qualquer conteúdo que você queira disponibilizar ao agente.

| Ferramenta                                            | O que faz                                                                                             |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Ferramenta de Recuperação de Documentos               | Recupera documentos relevantes da sua base de conhecimento com base na pergunta do lead               |
| Ferramenta de Recuperação e Reordenação de Documentos | Recupera documentos e os reordena por relevância antes de enviar ao agente (mais precisa, mais lenta) |

**Quando usar Recuperação simples:** para bases de conhecimento menores, onde a velocidade de resposta é prioridade.

**Quando usar Recuperação e Reordenação:** para bases de conhecimento maiores ou quando a precisão das respostas é mais importante que a velocidade.

***

#### Ferramentas de CRM

Permitem que o agente crie, atualize e gerencie registros no seu CRM diretamente durante a conversa. As ferramentas de CRM se conectam ao seu CRM via ApiDeck (veja Como conectar seu CRM via ApiDeck).

| Ferramenta                               | O que faz                                                 |
| ---------------------------------------- | --------------------------------------------------------- |
| Ferramenta de Criação de Contato CRM     | Cria um novo contato no CRM quando um lead é identificado |
| Ferramenta de Atualização de Contato CRM | Atualiza informações de um contato existente no CRM       |
| Ferramenta de Reunião com Contato CRM    | Agenda e gerencia reuniões com contatos do CRM            |
| Ferramenta de Oportunidade CRM           | Cria ou atualiza oportunidades de vendas no CRM           |
| Ferramenta de Criar Lead CRM             | Cria um novo lead (registro distinto de contato) no CRM   |
| Ferramenta de Atualizar Lead CRM         | Atualiza informações de leads existentes no CRM           |

> **Atenção:** Antes de ativar ferramentas de CRM, certifique-se de que seu CRM está conectado via ApiDeck em **Agente > Canais e Integrações > Ferramentas / Integrações**. Ferramentas de CRM ativadas sem conexão ativa falharão silenciosamente.

***

#### Ferramentas de Pesquisa

Permitem que o agente consulte dados em mecanismos de busca externos.

<table><thead><tr><th width="277.37890625">Ferramenta</th><th>O que faz</th></tr></thead><tbody><tr><td>Ferramenta Meilisearch</td><td>Pesquisa e recupera dados usando o Meilisearch</td></tr><tr><td>Ferramenta Elasticsearch SQL</td><td>Consulta dados usando Elasticsearch SQL</td></tr></tbody></table>

Essas ferramentas são indicadas para equipes que mantêm catálogos de produtos, inventários ou bases de dados estruturadas em Meilisearch ou Elasticsearch e querem que o agente consulte esses dados em tempo real durante a conversa.

***

#### Ferramentas Personalizadas

Permitem que seu agente se conecte a qualquer API externa ou fluxo de trabalho de IA.

<table><thead><tr><th width="313.7890625">Ferramenta</th><th>O que faz</th></tr></thead><tbody><tr><td>Ferramenta de Requisição HTTP</td><td>Faz requisições HTTP personalizadas para APIs externas (GET, POST, PUT, DELETE)</td></tr><tr><td>Ferramenta OpenAI Agent Builder</td><td>Constrói e integra fluxos de trabalho de IA conversacional usando o OpenAI Agent Builder</td></tr></tbody></table>

A **Ferramenta de Requisição HTTP** é a mais versátil. Use-a para conectar o agente a qualquer API que não tenha uma ferramenta nativa na plataforma (sistemas de agendamento, ERPs, plataformas de e-commerce, webhooks internos, entre outros).

#### Como ativar uma ferramenta

1. Acesse **Agente > Canais e Integrações** e clique na aba **Ferramentas / Integrações**.
2. Clique na categoria desejada (Documentos, CRM, Pesquisa ou Personalizado).
3. Clique no card da ferramenta que deseja ativar.
4. Configure os parâmetros necessários (credenciais, endpoints, etc.) conforme solicitado.
5. Salve a configuração. A ferramenta aparecerá automaticamente na aba **Ativas**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/otimizacao-do-agente/como-usar-as-ferramentas-e-integracoes-do-agente.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.