HeadOfficeOS Documentação
Construir IAgentes
HEADOFFICE OS / DOCUMENTAÇÃO

Criar seu primeiro IAgente

Do card de criação a um cargo específico, útil e verificável.

Edição de 7 de outubro de 2026 • Português

Antes de abrir o formulário

Escreva uma frase no formato: “Este agente ajuda [público] a [resultado], usando [fontes/ferramentas], e chama [responsável] quando [exceção].”

Evite começar por “um assistente que faz tudo”. Se você não consegue listar três situações de sucesso e três limites, o escopo ainda precisa de definição.

Criação manual

ATLAS DEMO · PASSO A PASSO Dentro do time que você escolheu, abra Criar IAgente e clique em Criar manualmente.
Dentro do time que você escolheu, abra Criar IAgente e clique em Criar manualmente.

Encontre o time

Em Início, localize o time que será responsável pelo agente. Passe o mouse sobre o card Criar IAgente para revelar as duas opções.

Escolha Criar manualmente

O formulário Criar novo IAgente abre no contexto daquele time.

Preencha a identidade e o cargo

Informe nome, cargo, pronomes, idioma e descrição do cargo. A interface também oferece Adicionar arquivo.

Revise antes de criar

Confira missão e contexto. Criar confirma a operação. Depois da criação, abra a engrenagem do novo agente e revise o setup e as demais configurações.

ATLAS DEMO · PASSO A PASSO Formulário preenchido com Atlas Demo. Após revisar os dados, clique em Criar.
Formulário preenchido com Atlas Demo. Após revisar os dados, clique em Criar.

O que escrever em cada campo

CampoExemplo editorialPor quê
NomeLiaIdentidade curta e fácil de reconhecer
CargoAnalista de triagem de suporteFunção específica, sem prometer resolução universal
PronomesEla/DelaCoerência de apresentação
IdiomaPortuguês (BR)Consistência com o público
Descrição do cargoIdentificar o problema, consultar artigos aprovados, coletar contexto e encaminhar exceçõesDefine trabalho e fronteiras
Descrição de cargo — triagem de suporte
Você é Lia, analista de triagem de suporte da [empresa].
Sua missão é identificar o problema do cliente, localizar a orientação aprovada na base de conhecimento e registrar um encaminhamento útil.
Atenda em português do Brasil. Faça uma pergunta por vez quando faltar contexto.
Resolva somente os casos documentados e dentro das permissões disponíveis.
Encaminhe para [equipe responsável] os incidentes de acesso, cobrança contestada, indisponibilidade e casos sem fonte confiável.
Resultado esperado: problema classificado, contexto suficiente, orientação com fonte ou encaminhamento com próximo passo.
Não prometa prazos, reembolsos ou correções que não estejam confirmados.

Construir com Iara

A segunda opção do card é Construir com Iara. Use-a para descrever o problema em linguagem natural e trabalhar uma proposta de agente. Prepare contexto da empresa, público, resultado desejado e sistemas existentes.

A opção foi identificada na interface. A contratação assistida completa não foi executada nesta documentação; revise o plano que a Iara apresentar e confirme cada decisão que criar recursos ou contratar agentes.

Critério de conclusão

O objetivo desta etapa é ter o agente criado e identificável no time. Isso ainda não comprova prontidão operacional. O próximo passo é resolver o setup, adicionar fontes, testar e revisar os canais.

Sobre a demonstração

Atlas Demo é apenas o nome usado no exemplo. Escolha o nome e a função do seu IAgente. Acesse a aula completa, com narração e oito passos ilustrados para acompanhar cada campo.

Nesta página