Colocar um agente na mão do time

Publicar um Agente é um clique. Colocá-lo em uso por um time envolve três coisas que a tela de publicação não menciona: quem consegue acessá-lo, quanto ele vai custar e como você saberá se está funcionando.

Este guia cobre essas três.

Antes de publicar

Uma conferência curta evita a maior parte dos problemas do primeiro dia:

• Os documentos estão Ativos. Coleções em indexação fazem o Agente responder como se estivesse vazio.
• O modelo continua habilitado no workspace. Um modelo retirado quebra o Agente sem aviso.
• Uma pergunta real foi testada, e a referência citada sustenta a resposta.

Quem vai conseguir usar

Conversar no Chat exige apenas ser membro do workspace. Nenhum papel administrativo é necessário, e Usuário basta.

O caminho para incluir alguém tem dois passos, em telas diferentes:

1. A pessoa precisa pertencer à organização. Se ainda não pertence, alguém com papel de Admin a convida.
2. A pessoa precisa ser adicionada ao workspace, pelo Proprietário dele.

Estimar e limitar o custo

Antes de abrir para muita gente, vale ter uma noção de ordem de grandeza.

Deixe o Agente rodar com um grupo pequeno por alguns dias e observe em Observabilidade o consumo por modelo, e em Painel o uso por Agente. A partir daí:

• Defina um teto de Workspace com folga sobre o pico observado, não sobre a média.
• Considere um teto por Usuário, que é o que protege contra um caso isolado consumindo o mês inteiro.

Começar apertado gera bloqueio no primeiro dia de uso intenso, e a correção acaba virando uma política permanentemente alta.

Comunicar o que ele faz

O nome e a descrição do Agente são a única instrução que a maioria das pessoas vai ler. Elas aparecem no seletor do Chat.

Descreva o trabalho e o limite: "Dúvidas sobre políticas de RH: férias, despesas e benefícios" diz mais que "Assistente de RH", e reduz perguntas fora de escopo.

As primeiras semanas

Três telas, em ordem de utilidade:

• Registros › Avaliação das Respostas: onde os problemas aparecem primeiro. Volume baixo é normal; as pessoas avaliam pouco, e quase sempre quando algo deu errado.
• Registros › Conversas: o que as pessoas de fato perguntam. Costuma render a segunda versão do prompt e uma lista de documentos que faltavam.
• Painel: se o uso se sustenta depois da novidade passar.

Mudar um agente em uso

Não existe rascunho de um Agente já publicado. Salvar uma alteração coloca essa alteração em produção na conversa seguinte de todo mundo.

Para mudanças grandes, duplique o Agente, ajuste a cópia como rascunho e só então substitua.

Próximos passos

• Ajuste as instruções a partir do que você leu em Escrever o prompt.
• Configure os tetos em Definir limites.