Adicionar ferramentas e Base de conhecimento

As ferramentas permitem que o agente consulte sistemas e execute ações durante a conversa. A Base de conhecimento permite que ele responda a partir dos documentos da sua empresa.

Por exemplo: o agente pode consultar o carrinho de um cliente em tempo real e responder a uma pergunta sobre a política de devolução da empresa usando um documento.

Etapa 1: Configurar uma ferramenta

Nas configurações do agente, adicione uma ferramenta do tipo API HTTP externa. Dê a ela um nome claro, como consultar_carrinho, e configure o endpoint que fornece os dados do carrinho.

Para testar com uma API pública de exemplo, use:```text GET https://dummyjson.com/carts/1

![Configuração de ferramenta nas opções do agente](/images/tool%20description.png)

## Etapa 2: Enviar um documento

Abra **Base de conhecimento** no painel e clique em **Enviar documento**. Clique em **Escolher arquivo** ou arraste e solte um documento, como a política de devolução ou as perguntas frequentes da empresa. Clique em **Enviar e processar** e aguarde o status **Concluído**.

No editor do agente selecione o documento em **Base de conhecimento**, na seção **Fontes do agente**. Salve as alterações.

![Enviar documento para a Base de conhecimento](/images/tool%20attachment.png)

## Etapa 3: Orientar o agente no prompt

Nas instruções do agente, explique quando consultar a ferramenta e quando usar o documento. Por exemplo:```text
Quando o usuário perguntar sobre os itens ou o valor do carrinho, consulte a ferramenta consultar_carrinho antes de responder.

Quando o usuário perguntar sobre a política de devolução, consulte o documento da Base de conhecimento antes de responder.
```Salve as instruções.

## Etapa 4: Testar

Inicie uma conversa de teste e pergunte sobre o carrinho. Depois, pergunte: *"Qual é a política de devolução de produtos da empresa?"* Confira se o agente consulta a ferramenta ou o documento adequado antes de responder.

## Próximos passos

- [Configurar ferramentas HTTP](/pt/voice-agent/tools/http-api)
- [Gerenciar a Base de conhecimento](/pt/voice-agent/knowledge-base)