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

Canais (Gatilhos)

Definição

Canais (chamados de Gatilhos no editor) são os pontos de contato onde o agente recebe e responde mensagens — WhatsApp, Telegram, widget web, URL pública, API REST ou agendamento.

Canais são os pontos de contato onde o agente conversa com o usuário. No SquadOS, eles aparecem como Gatilhos dentro do editor do agente. Os canais nativos hoje são:

• URL Pública — link único /a/:slug para qualquer pessoa conversar
• Widget de Site — bolinha de chat embedável em qualquer site externo
• Telegram
• WhatsApp QR Code (não oficial, via Baileys)
• WhatsApp Oficial (API Meta)
• API REST (chamadas server-side autenticadas com token)
• Agendamento (cron)

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 para humano, 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.