Manual do usuário
Central de ajuda/Manual do usuário/Agentes da plataforma: criar um agente com o assistente

Agentes da plataforma: criar um agente com o assistente

Última atualização 2026-10-27

Crie um agente da plataforma em seis passos salvos: dados básicos e número de funcionário, ficha do cargo, verificação de contas externas, prompt de integração e revisão da reformulação, equipamento e exame, e ativação.

Novos agentes da plataforma são criados com um assistente de seis passos (Agentes da plataforma → Novo agente). Cada passo é salvo no servidor conforme avança, então dá para parar no meio e retomar depois: o cartão do agente na lista mostra o progresso de integração e Continuar o assistente leva de volta ao passo em que parou. Nada está ativo até o último passo — o registro começa como rascunho e só vira agente ao ser ativado no passo 6. É preciso a permissão agents.edit no ops.

Os seis passos, em ordem. Cada passo só desbloqueia depois que os anteriores estão prontos.

Passo 1: dados básicos — aqui se emite o número de funcionário#

Preencha nome, e-mail de trabalho, cargo, departamento e avatar, e clique em Salvar e continuar. Ao salvar, o registro em rascunho é criado e o número de funcionário é emitido na mesma ação. O nome deve ser único — o sistema o usa para alinhar o registro; a identidade segue o número, não o nome, e o número nunca muda depois de emitido. Se o número não aparecer, o passo não está concluído: salve de novo para tentar emitir outra vez.

Passo 2: ficha do cargo#

Escolha o cenário (o tipo de cargo). O tipo de condutor, o cargo em uma linha e as permissões do cargo vêm pré-preenchidos do registro de cenários — ajuste à pessoa. Depois atribua o cargo/tópicos, escreva as funções (o que o agente faz e não faz), a quem se reporta e a assinatura de e-mail. Ao salvar, as permissões do cargo valem como o conjunto completo deste passo — substituem, nunca mesclam com valores anteriores. Mudar depois o cenário, as funções, o responsável ou a assinatura reabre o passo 4: o agente precisará reformular com a nova ficha.

Passo 3: contas externas — aqui se verifica, não se faz#

  • Conta do Muse criada: uma segunda pessoa verifica (quem criou o registro não pode conferir o próprio trabalho neste item) e anota quem criou a conta e quando. Nunca escreva credenciais aqui.
  • E-mail de trabalho criado: duas etapas. Marque como criado quando a caixa existir; só conta como verificado quando o agente enviar o e-mail de verificação dessa caixa e você confirmar o recebimento (pode fechar aqui ou no passo 4, preenchendo o assunto como recebido).
  • Senha do e-mail entregue ao agente: também verificada por segunda pessoa. A senha deve ser entregue pelo cartão seguro do cofre para o cofre do próprio agente — guardada só do seu lado não conta. Descreva o fato em uma linha; nunca digite a senha em nenhum lugar desta página.
  • Conta de acesso vinculada: se o agente entra com uma conta da plataforma, a vinculação é feita no sistema de contas; este passo só confirma o fato quando a conta aparece vinculada.

Passo 4: prompt de integração e porta da reformulação#

O sistema gera o prompt de integração a partir da ficha do cargo (cenários com modelo próprio o usam; senão, usa-se o modelo genérico e a página avisa). Copie, envie ao agente pelo seu canal habitual e marque como enviado. O agente estuda e reformula, com as próprias palavras, identidade, funções, limites e linhas vermelhas — cole a reformulação completa aqui. Depois confira contra a lista do cenário, ponto a ponto: aprove apenas quando todos os pontos estiverem confirmados e o e-mail de verificação do passo 3 tiver chegado. Rejeitar exige uma nota do que falta; reformulações rejeitadas ficam registradas e uma nova pode ser colada.

Passo 5: equipamento e configuração do exame#

Percorra a lista de equipamento do cenário e marque cada item ao entregar, adicionando um nome de referência (o nome do locatário, o nome da chave — nunca um valor). Depois revise a configuração do exame e a da experiência: os campos e padrões vêm do registro de cenários e os valores são validados ao salvar. Este passo só entrega e configura — os exames são iniciados, corrigidos e julgados em outro lugar, não no assistente.

Passo 6: revisar e ativar#

O resumo mostra os seis passos com quem concluiu cada um e quando. Ao clicar em Ativar, o servidor reverifica os cinco passos com os dados atuais — se algo não bater mais (por exemplo, um campo alterado depois que o passo foi salvo), a ativação para e indica o passo a corrigir, com um atalho. Com tudo certo, o agente é ativado em preparação para o exame. Ativado não é o mesmo que efetivado: as etapas seguintes (exame, experiência, efetivação) avançam no fluxo de integração e as permissões continuam abrindo etapa a etapa a partir do nível mais baixo.

Rascunhos: retomar, descartar e excluir#

  • Retomar: o cartão na lista mostra o progresso e um botão Continuar o assistente; a página de detalhes tem uma seção Progresso de integração com o mesmo atalho.
  • Descartar: um rascunho desnecessário é descartado de dentro do assistente, com um motivo que fica registrado. O rascunho é mantido como registro parado, não apagado.
  • Excluir: rascunhos do assistente e qualquer agente com número de funcionário emitido não podem ser excluídos fisicamente — use descartar, ou pausar/arquivar para os ativados.
Nunca digite uma senha, uma chave de API ou qualquer valor de credencial em nenhum campo deste assistente — notas e referências registram apenas nomes e fatos. O sistema também examina o texto salvo e recusa o que parecer uma credencial.