Agentes e SuperAgentes

Um Agente é a unidade com que as pessoas conversam no Chat. Ele reúne um modelo de IA, instruções em texto e o acesso ao conhecimento e às ferramentas do workspace.

Agentes pertencem a um workspace e são criados no Admin. Nada no Chat cria um Agente.

Do que um Agente é feito

O formulário de criação organiza o Agente em seções, e cada uma responde a uma pergunta diferente:

• Dados básicos: nome, modelo, logo e descrição. Nome e descrição são o que a pessoa lê na hora de escolher o Agente.
• Prompt de resposta ao usuário: as instruções permanentes. Define tom, formato e limites do que ele deve responder.
• Coleções: o conhecimento que ele consulta antes de responder.
• MCPs e Integrações: as ferramentas que ele pode acionar.
• Sub-agentes: outros Agentes que ele chama como apoio.
• Opções avançadas: temperatura e máximo de tokens por resposta.

Só nome, modelo e prompt são obrigatórios. Um Agente sem coleções e sem ferramentas é válido: ele responde com o modelo e o prompt, como um chat comum.

Rascunho e publicado

Todo Agente tem dois estados. Rascunho existe só no Admin; publicado aparece no seletor de Agentes do Chat, para as pessoas do workspace.

Você escolhe entre eles ao salvar, na opção Publicar ao salvar. Um Agente criado e não publicado some da vista de quem usa a plataforma, o que é útil enquanto você ainda está ajustando o prompt.

Como o Agente responde

A cada mensagem, o Agente monta a resposta nesta ordem:

1. Se tem Coleções associadas, busca os trechos relevantes nelas.
2. Se tem MCPs ou Integrações, decide se precisa acionar alguma ferramenta, respeitando o limite de iterações configurado.
3. Junta tudo ao prompt e ao histórico da conversa e pede a resposta ao modelo.

Sem Coleções associadas, o passo 1 não acontece, e a plataforma nem consulta o mecanismo de busca. É a associação de Coleções que liga o RAG, não uma chave separada.

Sub-agentes

Um Agente pode expor a si mesmo como ferramenta e chamar outros Agentes como apoio. O Agente principal continua sendo quem fala com a pessoa; os sub-agentes trabalham por trás.

Isso serve para dividir responsabilidades, como um Agente que sabe da política de RH e outro que sabe do catálogo de produtos, em vez de inchar um prompt só.

SuperAgentes

Um SuperAgente é um agente que já existe fora da AUMO e que a organização registra por URL. A plataforma o trata como um endpoint compatível com a Responses API.

As diferenças que importam:

• Onde nasce: o Agente é construído dentro da AUMO; o SuperAgente é registrado apontando para um sistema externo.
• Quem registra: SuperAgentes entram no catálogo da Organização e depois são liberados para cada workspace.
• O que você configura: no SuperAgente você informa nome e endpoint. Prompt, modelo e conhecimento são responsabilidade de quem mantém o serviço do outro lado.

Próximos passos

• Entenda o conhecimento que alimenta o Agente em Coleções e conhecimento.
• Veja de onde vêm os modelos disponíveis em Provedores e modelos.
• Monte um Agente do zero em Seu primeiro agente.