Experiência do agente
Projete o que um modelo vê para que ele possa encontrar o que precisa, agir com segurança e gastar contexto na tarefa. Isso é orientação, não uma lista de verificação.
- Comece com contexto mínimo: exponha primeiro o propósito, as ações disponíveis e as restrições; carregue instruções detalhadas quando necessário.
- Torne a descoberta explícita: todo recurso adiado precisa de uma descrição clara e de uma forma confiável de recuperá-lo.
- Mantenha restrições críticas visíveis: permissões, efeitos destrutivos e validação necessária aparecem antes da ação relevante.
- Prefira saídas limitadas: retorne resultados concisos com identificadores ou caminhos para recuperar detalhes; evite despejar logs ou documentos inteiros.
- Use localidade: inclua uma quantidade limitada de contexto adjacente provavelmente necessário junto com o resultado de uma operação. Por exemplo, entregue uma resposta de thread com algumas mensagens anteriores. Marque omissões e truncamentos explicitamente e forneça uma maneira de recuperar mais.
- Avalie o trabalho total: economizar contexto só é útil se não causar mais buscas, leituras repetidas ou erros.
Definições de ferramentas
- Remova restrições óbvias. Omita regras que o modelo aprende com o resultado da chamada, como um arquivo ausente falhando ao ler ou um envio falhado não sendo entregue.
- Descreva comportamento, não implementação. Diga o que a ferramenta faz e retorna; omita mecanismos internos, marcadores de saída que o modelo vê nos resultados e detalhes de imposição.
- Coloque regras de parâmetro no parâmetro. Valores padrão, intervalos, emparelhamentos e regras de quando definir pertencem à descrição ou esquema desse parâmetro; uma descrição que varia com a configuração geralmente significa que a parte variável pertence a um parâmetro.
- Diga cada fato uma vez. Não repita a definição da ferramenta em sua seção de instruções do sistema, a descrição de um parâmetro na descrição da ferramenta ou as regras de uma ferramenta em outra.
- Meça a mudança. Compare os tokens do primeiro prompt antes e depois de uma alteração na definição da ferramenta.
Habilidades e instruções do agente
- A descrição é o gatilho. A descrição de uma habilidade informa quando usá-la nas palavras que um usuário ou tarefa usaria; o corpo informa como.
- Mantenha o arquivo de entrada curto e detalhe os links. Coloque o fluxo de trabalho e as proteções no arquivo da habilidade; mova exemplos de calibração e referências longas para arquivos carregados sob demanda, vinculados diretamente do arquivo de entrada.
- Declare limites de escopo explicitamente. "Orientação, não uma lista de verificação" ou "relate descobertas sem editar" muda como um modelo aplica o fluxo de trabalho.
- Aponte para a fonte da verdade. As instruções vinculam o documento original em vez de reafirmá-lo, para que não se desviem.