Conceitos-Chave

Zaia Endless é construída em torno de um conjunto de conceitos fundamentais.
Entendê-los vai ajudar você a projetar Agentes de forma mais eficaz e evitar complexidade desnecessária.

Console, White Label e workspace

Console é a superfície administrativa para gerenciar workspaces.

Use-o para administração de workspace, faturamento, planos, checkout, slots e acesso global.

White Label é a oferta da plataforma com marca própria.

Use-o para domínios personalizados, identidade visual, branding e permissões relacionadas.

Workspace é o ambiente operacional de um cliente ou caso de uso.

Cada workspace mantém sua própria configuração, membros e assinatura.

Agente

A unidade central da Endless.
Definido por Role + Prompt + Settings.

Exemplo: “Assistente especializado em dados financeiros de clientes.”

Boa prática: comece com a configuração mais simples (Role + Prompt) e adicione Tools, Knowledge ou capacidades avançadas somente se necessário.

Role

Uma frase curta que resume o que o Agente faz.
Ajuda a posicionar o propósito do Agente.

Exemplo: “Agente de suporte ao cliente para produtos SaaS.”

Prompt

O conjunto principal de instruções que define como o Agente se comporta.
Suporta até 5000 caracteres.

Exemplo:
“Você é um assistente de vendas. Sempre pergunte ao cliente o nome dele e o produto de interesse. Seja educado e objetivo.”

Temperature

Controla a criatividade das respostas do Agente:

0% → Totalmente metódico (ideal para Agentes factuais, como os de finanças ou jurídico).
100% → Altamente criativo (ideal para brainstorming ou marketing).

Effort

Define quantos passos o Agente pode dar para chegar a uma resposta.
Intervalo: 10–100.

Effort baixo (10–20): tarefas simples, Agentes no estilo FAQ.
Effort alto (80–100): Agentes complexos que orquestram múltiplas Tools e Workflows.

Planning

Quando ativado, o Agente cria um plano no início da execução, considerando as Tools e recursos disponíveis.

Recomendado para:
Agentes que operam em ambientes complexos ou que executam lógica com múltiplas etapas.

Reasoning

Controla a profundidade de raciocínio aplicada pelo Agente ao gerar respostas.

Modos disponíveis:

Low: respostas mais rápidas, adequadas para conversas simples e FAQs.
Medium: raciocínio equilibrado para a maioria dos casos de uso de negócio.
High: análise mais profunda e pensamento estruturado, ideal para tomada de decisão ou resolução de problemas complexos.

⚠️ Níveis de reasoning mais altos podem aumentar o tempo de resposta.

Tools

Extensões que permitem ao Agente ir além do Prompt.
Cada Tool precisa ser explicitamente criada e vinculada.

Exemplos:

Memory Tool → Salva variáveis como nome, prazo ou orçamento.
Table Tools → Insere, atualiza ou busca dados de Table.
Workflow Tool → Executa um Workflow.
Ticket Tool → Transfere a conversa para um Team do CRM.
HTTP Tool → Conecta-se a APIs externas.

Boa prática: adicione apenas as Tools que seu Agente realmente vai usar.

Knowledge Base (KB)

Um repositório estruturado de documentos, FAQs ou políticas.
Os Agentes podem pesquisar KBs usando o Knowledge Base Search Tool.

Tables

Bancos de dados nativos da Zaia Endless.
Usados para armazenar e consultar dados estruturados, como leads, registros de CRM ou estoque.

Operações disponíveis via Tools:

Insert
Update
Search
Busca semântica / por similaridade

Workflows

Sequências de etapas que automatizam a lógica de negócio.
Os Workflows precisam ser criados primeiro e depois vinculados usando um Workflow Execution Tool.

Exemplo:
“Verificar disponibilidade do produto → calcular prazo de entrega → retornar o resultado ao usuário.”

MCP (Managed Connector Provider)

Integrações nativas com aplicações externas.
Exigem uma Connection (OAuth ou API Key) para serem ativadas.

Exemplos:

Google Calendar → Criar ou listar eventos
Gmail → Buscar e-mails
Supabase → Consultar bancos de dados externos
Notion / Airtable → Gerenciar conteúdo

Connection

Autenticação que habilita MCPs ou Canais.
Sem uma Connection, o Agente não consegue acessar o serviço externo.

CRM Team

Grupos de operadores humanos que podem receber conversas dos Agentes.
Precisam ser criados antes de adicionar um Ticket Tool.

Ticket Tool

A única forma suportada de os Agentes transferirem conversas para humanos.
Sempre vinculado a um CRM Team.

Channels

Onde o Agente interage com os usuários.

Opções disponíveis:

Widget (Web)
WhatsApp
Instagram
API

Boa prática:
Teste o Agente primeiro usando o chat interno (sem necessidade de canal) e só depois publique em canais externos.

Conditional Prompts (Avançado)

Conditional Prompts permitem definir instruções que só são executadas quando condições específicas são atendidas.

Elas substituem o antigo conceito de Tasks e permitem um comportamento mais flexível e sensível ao contexto.

Exemplos:

Se o usuário disser “finalizar” → Executa um prompt de encerramento.
Se o usuário pedir um humano → Aciona o Ticket Tool.
Se a conversa atingir determinado contexto → Muda o comportamento do Agente dinamicamente.

Boas práticas:

Mantenha as condições específicas e sem sobreposição.
Use Conditional Prompts para lógica, não para a identidade central do Agente.
Evite encadeamentos excessivos para manter clareza e desempenho.