Tools: Visão Geral

Entendendo as Tools e quando usá-las

No Zaia Endless, as Tools são o que estende as capacidades de um Agente além de seu Role + Prompt principal.

Por padrão, um Agente só pode responder usando as instruções definidas em seu Prompt.
Sempre que você quiser que um Agente interaja com dados, acione ações, integre com sistemas ou escale para humanos, você precisa criar e configurar as Tools apropriadas.

Como o Agente usa as Tools

Os Agentes decidem usar uma Tool com base na descrição da Tool.

Se o Agente determinar que uma Tool é necessária, mas as entradas obrigatórias estiverem faltando, ele vai primeiro pedir ao usuário a informação que falta
Assim que todas as properties obrigatórias estiverem disponíveis, o Agente executa a Tool
Se toda a lógica e informação couber dentro do Prompt, nenhuma Tool é necessária

💡 Boa prática: As Tools só devem ser criadas quando forem realmente necessárias. Menos Tools levam a um comportamento mais previsível.

Tipos de Tools no Zaia Endless

Abaixo estão as Tools atualmente disponíveis na plataforma e quando usar cada uma.

📡 HTTP Request

Permite que o Agente realize chamadas de API para serviços externos.

Métodos suportados:
GET, POST, PUT, DELETE, PATCH

Use quando:

Integrar com sistemas de terceiros
Buscar ou enviar dados para APIs externas

⚙️ Code Execution

Permite que o Agente execute trechos de código personalizados.

Use quando:

Realizar cálculos
Transformar dados
Aplicar lógica personalizada não coberta por outras Tools

🌐 Web Search

Permite que o Agente pesquise na web por informações atualizadas.

Use quando:

A informação não está disponível nas Knowledge Bases
É necessário contexto em tempo real ou externo

🎫 Ticket Creation

Cria um ticket e transfere a conversa para um humano no CRM do Endless.

Importante:

Requer que um CRM Team já exista
Essa é a única forma nativa de escalar uma conversa para humanos

🏷️ Chat Tagging

Permite que o Agente classifique chats com um conjunto pré-aprovado de tags depois de responder.

Use quando:

Categorizar conversas sem criar um ticket
Manter Chat History e Tickets filtráveis por tópico ou intenção
Preservar tags manuais fora do escopo da Tool

🚫 External User Blocking

Permite que o Agente principal do chat bloqueie um usuário externo após confirmar uma conversa de bot para bot.

Use quando:

O Agente tiver certeza absoluta de que o usuário externo é outro bot
Você precisar interromper futuras mensagens desse usuário externo

A tool está disponível apenas nos canais de chat externos suportados.

✉️ Message Sending

Permite que o Agente envie mensagens para números de telefone específicos com base em uma condição definida.

Use quando:

Enviar notificações
Acionar mensagens de saída
Automatizar alertas ou confirmações

⏰ Follow Up

Permite que o Agente envie mensagens de follow-up após inatividade na conversa.

Use quando:

Reengajar usuários
Lembrar usuários de concluir uma ação
Continuar conversas automaticamente

📚 Knowledge Base Search

Permite que o Agente pesquise dentro de uma Knowledge Base criada no Zaia Endless.

Use quando:

A informação é grande ou dinâmica demais para o Prompt
Você precisa de documentação ou FAQs estruturadas e pesquisáveis

📄 PDF Reader

Permite que o Agente leia e extraia informações de arquivos PDF.

Permite que o Agente leia e raciocine sobre o conteúdo completo de um PDF como um único documento contextual, sem divisão em blocos ou fragmentação semântica.

📊 Table Tools

As tables são bancos de dados nativos dentro do Zaia Endless.
Cada tipo de interação requer sua própria Tool.

Table Tools disponíveis:

Table Row Insertion — insere novos registros
Table Row Update — atualiza registros existentes
Table Row Semantic Search — busca por significado usando linguagem natural
Table Row Similarity Search — busca por similaridade vetorial (correspondências mais próximas)

Use quando:

Gerenciar leads, clientes, tickets ou dados estruturados
Persistir informações entre conversas

⚠️ As tables precisam ser criadas antes de configurar suas Tools.

🔄 Workflow Execution

Executa um Workflow pré-construído.

Use quando:

Orquestrar processos de múltiplas etapas
Automatizar lógica de negócio (por exemplo, pagamentos, onboarding, aprovações)

🧠 Contextual Memory

Permite que o Agente armazene e recupere informações entre conversas.

Exemplos:

Nome
Empresa
Orçamento
Preferências

A memória funciona como variáveis dinâmicas, e o Agente se baseia na descrição da Tool para entender o que deve ser extraído e armazenado.

Boas práticas

Mantenha simples — Se a informação cabe no Prompt, não crie uma Tool
Respeite as dependências — Crie o recurso primeiro (Table, Workflow, CRM Team)
Escreva descrições claras — Sempre explique as Tools em linguagem natural
Teste internamente — Use o Internal Chat para validar o comportamento da Tool antes de publicar

Resumo

As Tools são o que torna os Agentes ativos dentro do Zaia Endless.

Elas conectam seu Agente a:

Knowledge Bases
Tables
Workflows
APIs externas
Humanos

Mas lembre-se:
Mais Tools = mais complexidade.
Comece simples e adicione apenas o que seu Agente realmente precisa.