Conceitos-chave

Agentes

Definição

Um agente no SquadOS é uma IA configurada com prompt de sistema, modelo de linguagem e, opcionalmente, ferramentas e bases de conhecimento — com comportamento e limitações definidos por você.

Um agente é uma IA configurada com um prompt de sistema, um modelo de linguagem e, opcionalmente, ferramentas e bases de conhecimento. Cada agente tem um comportamento específico definido por você.

Bases de Conhecimento

Definição

Bases de Conhecimento são coleções de documentos e informações da sua empresa indexadas pelo SquadOS e consultadas automaticamente pelo agente durante as conversas, usando recuperação semântica (RAG).

Bases de Conhecimento permitem que os agentes consultem documentos e informações da sua empresa. Os itens são indexados e recuperados automaticamente nas conversas (RAG).

Caixas de entrada

Definição

Uma caixa de entrada é um canal conectado — um número de WhatsApp, um bot do Telegram, uma página pública, um widget no site, um endpoint de API. Ela guarda as credenciais daquele canal e aponta para quem atende.

Caixas de entrada ficam em Caixas de Entrada, no menu do painel — não dentro do editor do agente. Isso muda duas coisas em relação ao modelo antigo de “gatilhos”:

• Um agente pode ter várias caixas. O mesmo agente atende WhatsApp Oficial, Telegram e página pública ao mesmo tempo, com o mesmo prompt.
• Uma caixa não precisa de agente. O destino pode ser atendimento humano: a mensagem entra e uma pessoa responde pela tela de Conversas, sem IA no meio.

Os canais disponíveis hoje são: WhatsApp Oficial (API da Meta), WhatsApp (QR Code), WhatsApp via Z-API, Uazapi ou Evolution, Instagram Direct, Instagram Comentários, Telegram, Página pública (app.squados.io/a/<endereço>), Widget e API.

Ver Visão geral dos gatilhos e Caixas de Entrada.

Ferramentas

Definição

Ferramentas são capacidades extras que você habilita no agente — ações nativas do SquadOS, integrações via Composio ou chamadas HTTP personalizadas que o modelo pode acionar durante uma conversa.

Ferramentas dão capacidades extras ao agente — desde ações nativas (gerar imagem, consultar base, transferir conversa, AutoPrompt, AutoLearn, etc.) até integrações externas via Composio (Google Calendar, Bubble, Gmail e centenas de outras) ou HTTP customizado.

AgentMaker

Definição

O AgentMaker é o copiloto de IA embutido no editor do agente que conversa com você para construir e refinar o prompt de sistema usando boas práticas de prompt engineering.

O AgentMaker é um copiloto de IA dentro do editor do agente. Ele conversa com você para construir e refinar o prompt de sistema usando boas práticas de prompt engineering. Aparece como botão Editar com AgentMaker na aba Prompt.

Em versões anteriores foi chamado de “Architect Copilot” — agora o nome oficial é AgentMaker.

Organização, Times e Papéis

Definição

Uma organização é o espaço compartilhado onde vivem todos os agentes, bases e usuários de uma conta. Papéis e times controlam o nível de acesso de cada membro.

Cada conta vive dentro de uma organização. Dentro dela, usuários têm um dos papéis:

• Proprietário (owner) — controle total, inclusive billing
• Administrador (admin) — configura agentes, bases, ferramentas, usuários
• Colaborador — usa o Hub e ajuda em conversas compartilhadas
• Usuário — usa o Hub para conversar com os agentes

Equipes (times) dentro da organização permitem agrupar usuários e controlar quais Categorias de Agentes cada grupo enxerga.