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

# Usar Ferramentas Externas e Conhecimento

> Faça seu agente agir durante a chamada, não apenas conversar. Conecte-o a dados ao vivo e aos seus documentos da empresa.

Você tornou o agente acessível por chamadas telefônicas reais. Agora vamos torná-lo útil durante a chamada.

Seu agente consegue manter uma conversa. Mas ele consegue verificar um pedido ou responder corretamente a uma pergunta sobre uma política? É sobre isso que esta página trata.

Existem duas maneiras de conectar informações reais ao seu agente. Uma **tool** (ferramenta) serve para qualquer coisa ao vivo, dados que mudam ou uma ação que precisa acontecer, como verificar um pedido ou consultar disponibilidade. Uma **Knowledge Base** (base de conhecimento) serve para qualquer coisa escrita, como sua política de devolução ou um FAQ, que não muda de uma chamada para outra.

No exemplo abaixo, um agente de suporte a pedidos consulta dados de carrinho ao vivo por uma API e responde perguntas sobre políticas a partir de um documento na base de conhecimento.

## Etapa 1: Criar a ferramenta

Abra o nó onde acontece a maior parte da conversa, neste caso o nó de suporte principal da Maya. Role para baixo e clique em **Create a Tool** e escolha **External HTTP API**. Dê a ela o nome `get_cart_details`.

<Note>
  A descrição é o que mais importa aqui. É ela que o agente lê para decidir quando chamar a ferramenta. Escreva-a de forma simples: *"Use esta ferramenta quando o chamador perguntar sobre detalhes do carrinho. Ela retorna os produtos do carrinho, quantidades, total e total com desconto."*
</Note>

Para o endpoint, esta demonstração usa o [dummyjson.com](https://dummyjson.com), uma API pública de exemplo. Copie exatamente esta URL e teste você mesmo, sem precisar de backend:

```
GET https://dummyjson.com/carts/1
```

Sem autenticação, sem parâmetros. É uma requisição GET porque você está buscando informações, não alterando nada. Em seu próprio ambiente, ela apontaria para o seu CRM ou sistema de pedidos.

Salve a ferramenta.

## Etapa 2: Anexar a ferramenta ao nó

Criar a ferramenta não é suficiente por si só. Volte ao nó da Maya e selecione `get_cart_details` em Tools e salve.

<Warning>
  Uma ferramenta só fica disponível depois de anexada ao nó que precisa dela. Se você pular isso, a ferramenta existe, mas o agente nunca a chamará.
</Warning>

## Etapa 3: Enviar um documento para a Knowledge Base

Clique em **Upload Document** ou vá direto para **Knowledge Base Files**. Escolha o documento que o agente deve consultar — uma política de devolução, um FAQ de envio, o que seus clientes realmente perguntam.

A Tig.ai divide o documento em blocos e o indexa automaticamente e, em seguida, recupera apenas as seções relevantes durante uma conversa. Envie o arquivo e aguarde o status ficar **Completed**.

## Etapa 4: Anexar o documento ao nó

Mesma regra da ferramenta. Volte ao nó da Maya, role até **Knowledge Base Documents** e anexe o arquivo.

<Warning>
  Enviar o arquivo não é suficiente por si só. O documento precisa ser anexado ao nó onde o agente deve usá-lo.
</Warning>

## Etapa 5: Informar ao agente quando usar cada um

No prompt do nó, deixe explícito qual mecanismo responde a qual pergunta. Não deixe isso no improviso:

```
If the caller asks about cart contents, order items, quantities, total, or discounts,
use the get_cart_details tool before answering.

For questions about returns, refunds, or cancellations,
use the attached Knowledge Base document.
```

Salve o nó.

## Etapa 6: Testar

Inicie uma Web Call e teste os dois casos:

* *"Oi, Maya, o que tem no meu carrinho?"* Observe a transcrição. Maya decide que a ferramenta é relevante, chama a API e responde com base na resposta em vez de adivinhar.
* *"Qual é a política de devolução?"* Maya recupera a resposta do documento e responde com base nesse contexto.

Essa é a diferença que importa: para detalhes do carrinho, Maya usa a ferramenta porque os dados mudam de chamada para chamada. Para a política de devolução, ela usa a Knowledge Base porque essa resposta vive em um documento e não muda. As ferramentas conectam seu agente aos sistemas. A Knowledge Base o conecta a documentos. Juntos, seu agente começa a parecer conectado ao seu negócio real, e não apenas recitando um roteiro.

## Próximos passos

Agora você tem o ciclo completo: as chamadas são disparadas automaticamente, os dados entram e saem, seu número está conectado e o agente pode agir com base em dados ao vivo e nos seus próprios documentos.

* **Referência completa de ferramentas**: tipos de parâmetros, autenticação e práticas recomendadas em [Ferramentas HTTP API](/pt/voice-agent/tools/http-api).
* **Referência completa da Knowledge Base**: comportamento de chunking e configuração de embeddings em [Knowledge Base](/pt/voice-agent/knowledge-base).