As práticas recomendadas a seguir podem ajudar você a criar agentes de playbook robustos.
Metas concisos
As metas devem ser uma descrição concisa do propósito do manual.
Fornecer instruções de qualidade
As instruções precisam:
- refletem a abordagem passo a passo para resolver um problema do usuário final
- ser frases concisas em linguagem natural de instruções de alto nível
- Ser direto e especificar os cenários para usos das ferramentas
Pelo menos um exemplo para cada playbook
É necessário ter pelo menos um exemplo para cada playbook, mas é recomendável ter pelo menos quatro. Os exemplos devem incluir cenários do cenário ideal.
Sem exemplos suficientes, é provável que um roteiro resulte em um comportamento imprevisível. Se o agente não estiver respondendo ou se comportando da maneira esperada, a causa provavelmente será a falta de exemplos ou a definição incorreta de exemplos. Tente melhorar seus exemplos ou adicionar novos.
Precisão de instruções e exemplos
É útil escrever instruções instrucionais claras e descritivas, mas são a qualidade e a quantidade dos exemplos que determinam a precisão do comportamento do agente. Em outras palavras, passe mais tempo escrevendo exemplos completos do que escrevendo instruções perfeitamente precisas.
Campo "OperationId" do esquema da ferramenta
Ao definir esquemas para suas ferramentas, o valor de operationId é importante.
As instruções do seu playbook mencionarão esse valor.
Veja a seguir as recomendações de nomenclatura para esse campo:
- Somente letras, números e sublinhados.
- Precisa ser exclusivo entre todos os
operationIds descritos no esquema. - Precisa ser um nome significativo que reflita a capacidade fornecida.
Validação do esquema da ferramenta
É preciso validar o esquema da ferramenta. Use o Editor do Swagger para verificar a sintaxe do esquema da openAPI 3.0.
Gerar um esquema com o Bard
O Bard pode gerar um esquema para você. Por exemplo, tente "criar um exemplo de esquema da openAPI 3.0 para o Google Agenda"?
Manuais específicos
Evite criar playbooks muito grandes e complexos. Cada manual precisa cumprir uma tarefa específica e clara. Se você tiver um manual complexo, considere dividi-lo em subplaybooks menores.
Evitar loops e recursão
Não crie loops ou recursão ao vincular agentes do playbook nas suas instruções.