Conceitos-chave

Use este glossário para distinguir as partes do SquadOS antes de configurar uma jornada. Os nomes em negrito são os mesmos usados na interface em português.

Organização, membros e acesso

Uma organização é o ambiente isolado onde ficam agentes, bases, ferramentas, caixas, contatos, conversas, automações e configurações. Uma pessoa pode participar de mais de uma organização e alternar entre elas; dados e permissões sempre pertencem à organização ativa.

Cada membro recebe uma ou mais Funções. As capacidades dessas funções são somadas e determinam quais páginas e ações a pessoa pode acessar. Os pacotes atuais são Administrador, Agentes IA, Atendimento e Colaborador; Personalizado permite selecionar capacidades para uma pessoa específica. O Proprietário é único, tem acesso total e não é uma função selecionável.

Equipes são o modelo legado de algumas organizações. Nesse modelo, elas também limitam categorias de agentes e opções de modelo. Não trate Equipe e Função como sinônimos. Veja Usuários, Funções e Equipes.

Agentes IA

Um Agente IA combina:

• um prompt com objetivo, contexto e regras;
• um modelo de linguagem;
• configurações de resposta, segurança e processamento de anexos;
• opcionalmente, bases, blocos de contexto e ferramentas.

O agente usa somente a configuração que foi salva. Um rascunho aberto no editor ainda não altera chats, Caixas de Entrada ou automações. Desativar o agente preserva a configuração, mas impede novas respostas em canais e automações. Consulte Criar Agentes IA.

Conhecimento

Uma Base de Conhecimento é uma coleção de itens que podem ser pesquisados pelo agente. Arquivos, textos, páginas rastreadas e outros itens precisam terminar o processamento antes de ficarem pesquisáveis. Conectar uma base ao agente disponibiliza a ferramenta de busca, mas não obriga uma consulta em toda mensagem: o runtime e o modelo decidem quando chamá-la conforme o pedido e as instruções do agente.

Um Bloco de Contexto é diferente: quando está vinculado e ativo, seu texto é enviado por inteiro em cada resposta do agente. Use blocos para regras e fatos curtos que sempre devem estar presentes; use bases para acervos maiores que devem ser pesquisados sob demanda.

O AutoLearn registra perguntas que o agente não conseguiu responder pelas bases. A oportunidade só vira conteúdo depois de revisão e aprovação humanas; ela não treina o modelo nem publica conhecimento sozinha. Veja Bases de Conhecimento.

Ferramentas

Uma ferramenta permite que o agente consulte dados ou execute uma ação. O catálogo da organização reúne quatro origens:

• ações nativas do SquadOS;
• integrações do Composio;
• endpoints HTTP personalizados;
• ferramentas descobertas em servidores MCP.

Disponibilizar uma ferramenta no catálogo não a conecta automaticamente a todos os agentes. Ela precisa ser adicionada ao agente e, quando aplicável, ter ações e credenciais configuradas. Durante uma conversa, o modelo decide se deve chamá-la com base no nome, na descrição, nos parâmetros e no prompt. Portanto, ferramenta conectada não significa ferramenta executada em toda mensagem. Veja Ferramentas da organização.

Caixas de Entrada e canais

Uma Caixa de Entrada é o ponto de entrada configurado para um canal externo. Ela guarda a conexão necessária e define se novas mensagens vão para um Agente IA ou para atendimento humano. O roteamento também pode variar por agenda, exceções de data e destino fora do horário.

Os tipos atuais incluem WhatsApp QR Code, Z-API, Uazapi, Evolution e WhatsApp Oficial; Telegram; Instagram Direct e Comentários; Página pública; Widget; e API. Um agente pode receber mensagens de várias caixas, e uma caixa pode funcionar sem agente quando o destino é humano.

Caixas são administradas em Caixas de Entrada, fora do editor do agente. A área histórica da documentação ainda usa “triggers” no endereço, mas o nome atual da interface para canais de entrada é Caixas de Entrada. Veja Caixas de Entrada.

Contatos e conversas

Um Contato representa a pessoa atendida e reúne sua identidade, atributos, tags e histórico relacionado dentro da organização.

Uma Conversa é o encadeamento de mensagens recebido por uma caixa ou canal. Ela tem estado operacional, responsável, contato, agente e controle de IA próprios. Na tela Conversas, a equipe pode assumir, transferir, pausar, encerrar ou reativar o atendimento, conforme suas capacidades. Desligar a IA numa conversa não desativa o agente inteiro.

Em termos simples: a caixa recebe, o roteamento escolhe o destino, a conversa registra o atendimento e o contato identifica a pessoa. Veja Gerenciar conversas.

Hub

O Hub é o espaço interno e autenticado para membros da organização. Nele, uma pessoa pode conversar diretamente com Agentes IA e, quando tiver acesso, usar Salas, mensagens diretas e reuniões.

Uma conversa do Hub não é uma fila de atendimento externo e não aparece como uma Caixa de Entrada. Não use Conversas do painel para procurar um chat interno do Hub. O que cada membro enxerga depende de suas capacidades e do acesso às categorias de agentes. Veja Visão geral do Hub.

Automações

Uma Automação é um fluxo que começa por um gatilho de evento ou tempo e percorre condições e ações conectadas. Ela pode enviar mensagens, atualizar dados, aguardar, ramificar ou chamar recursos de IA, conforme os nós configurados.

Enquanto você edita, o grafo ainda é um rascunho local. Salvar valida o grafo e cria uma nova versão já publicada; não existe uma segunda ação de publicação. O interruptor Ativar é separado: numa automação ativa, a versão salva passa a valer para novas execuções; numa automação inativa, ela fica guardada até a ativação. Execuções que já começaram continuam na versão anterior. Os resultados ficam no histórico da automação. Veja Automações.

AgentMaker

O AgentMaker é o assistente de IA do editor. No modo de Agente, ele analisa a configuração salva e pode propor mudanças no prompt e nas ferramentas. No modo de Automação, ele ajuda a montar ou revisar o grafo do fluxo.

As propostas aparecem para revisão. Aplicar uma proposta altera o formulário ou o grafo em edição, mas não substitui a etapa normal de salvar. Consulte AgentMaker.

Como as peças se conectam

• Atendimento externo: canal → Caixa de Entrada → roteamento → Agente IA ou pessoa → Conversa vinculada ao Contato.
• Uso interno: membro autenticado → Hub → Agente IA, Sala, mensagem direta ou reunião.
• Execução automática: evento ou horário → Automação publicada → condições e ações.
• Resposta do agente: configuração salva → modelo → contexto aplicável → ferramentas chamadas quando necessário → resposta.

Esses fluxos podem se cruzar, mas continuam tendo controles próprios. Por exemplo, uma automação pode iniciar uma ação relacionada a um contato, e uma ferramenta pode transferir uma conversa; isso não transforma a automação em Caixa de Entrada nem o Hub em fila de atendimento.