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

Proteção nativa do Agente principal do chat. Quando a plataforma confirma um loop recente de mensagens repetidas, ela abre um ticket humano e pausa o Agente. O contato não é bloqueado.

Ligue ou desligue por agente em Capacidades Extras → Detector de bots e edite o Prompt do detector de bots. Guia: Detector de bots.

✉️ 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)

📋 Avaliação de resolução

Pede ao contato que indique se a demanda foi Resolvido, Parcialmente resolvido ou Não resolvido.

Use quando:

Medir se o atendimento do Agente resolveu a demanda
Permitir que o atendente humano envie a mesma avaliação ao concluir o ticket
Acompanhar as respostas no Analytics e abrir cada conversa em uma nova aba

Guia: Avaliação de resolução.

📝 Request User Input

Mostra um formulário no chat para o contato escolher opções ou preencher dados curtos. O envio é a próxima mensagem.

Use quando:

Precisar de uma escolha (única ou várias) ou de um dado curto antes de continuar
O atendimento for no Widget, no Vibe Agent, no chat interno ou nos Workers

A tool é nativa: não há cadastro em Ferramentas. Guia: Request User Input.

🪪 Identidade do contato

O Agente já recebe o contato da conversa atual: ID, nome, telefone e identificador do canal, quando cadastrados.

Use quando:

O Agente precisa do contato da conversa para gravar um lead, chamar uma API ou enviar uma mensagem
O telefone e o identificador do canal podem ser diferentes (por exemplo, LID do WhatsApp)

Não há cadastro em Ferramentas. Guia: Identidade do contato.

🧠 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.

Vincular a Agentes na criação

No final do formulário de Nova Ferramenta, o campo Quais agentes devem usar isto? escolhe quais Agentes passam a usar aquela Tool no mesmo envio.

O campo é opcional. Sem Agentes, a Tool fica só no catálogo e o toast oferece Vincular a agentes.

O mesmo campo existe ao criar MCP, Knowledge Base e Table. Guia: Vincular a Agentes.

Última execução

Na lista de Ferramentas do Builder, a coluna Última execução indica quando cada Tool foi chamada pela última vez. Use - como sinal de que a Tool ainda não rodou (ou não tem execução registrada).

Guia completo: Como ver a última execução dos assets.

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
Avaliação de resolução do atendimento
Formulário no Widget e nos chats da plataforma
Identidade do contato da conversa atual

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