julián medina

Agentes

Qual documentação um agente de IA precisa para entender seu negócio

Por Julián Medina · Diretor da SourcingUp e criador da CommerceUp

Necessita de regras actuais, definições partilhadas, partes responsáveis e exemplos de decisões. Documentação útil explica como agir em uma situação específica e permite distinguir uma instrução atual de uma referência histórica.

Organize por decisões

Uma pasta com centenas de arquivos não garante um contexto útil. Comece pelas dúvidas que surgem durante o trabalho: qual preço usar, o que significa um status ou quem aprova uma exceção. Indique onde está a principal fonte de cada resposta. Quando dois documentos se contradizem, o agente precisa de uma regra para parar ou consultar.

Adicione exemplos com seus motivos

Uma decisão anterior ajuda mais quando preserva a razão e a condição que a tornou válida. Por exemplo, uma exceção de entrega concedida a um cliente não deve tornar-se uma promessa geral. Documentar o escopo evita que um caso especial seja interpretado como uma política permanente.

Atribuir manutenção

Cada área deve saber qual documentação é responsável pela revisão e qual evento requer atualização. Uma mudança de preço, uma nova ferramenta ou uma política modificada são gatilhos específicos. Em seguida, tente perguntas afetadas por essa mudança; atualizar um arquivo não prova que o agente está recuperando a versão correta.

Para colocar em prática

De onde vem esse visual?

Guia de Julián Medina. Os cenários propostos são ilustrativos; Eles não representam resultados medidos do cliente. Meu trabalho na SourcingUp.