Escrever instruções efetivas para o agente
As instruções são o mecanismo principal para controlar um agente operado pela estrutura do GitHub Copilot. O runtime de orquestração interpreta as instruções junto com a solicitação do usuário, o conhecimento disponível e outros componentes do agente.
Incluir os principais elementos de instrução
Instruções efetivas descrevem os seguintes elementos:
- Função e finalidade: identifique o agente e o resultado que ele dá suporte.
- Comportamento: explicar como o agente deve abordar solicitações e usar o contexto.
- Requisitos de fundamentação: Indique em quais fontes o agente deve se basear e como deve lidar com informações ausentes.
- Estilo de tom e resposta: defina o nível de detalhes, idioma e formato.
- Limites: identificar tarefas proibidas e assuntos fora do escopo.
- Esclarecimento: informe ao agente quando fazer perguntas de acompanhamento.
- Escalonamento: Defina quando e para onde o agente deve encaminhar o usuário.
Você pode organizar instruções com títulos e listas para que cada regra tenha uma finalidade clara. O exemplo a seguir estabelece um ponto de partida para um agente de informações de benefícios:
# Role and purpose
You are the Contoso Benefits Assistant. Help employees understand company benefit programs by using the approved knowledge sources.
# Response approach
- Ask a clarifying question when the employee's request is ambiguous.
- Give concise answers in plain language.
- Cite the relevant source when one is available.
- State when the approved sources don't contain an answer.
# Boundaries and escalation
- Don't determine whether an employee is personally eligible for a benefit.
- Don't provide legal, tax, medical, or financial advice.
- Direct personal eligibility and enrollment decisions to Human Resources at benefits@contoso.com.
Tornar as instruções observáveis
Escreva regras que produzem o comportamento que você pode testar. Ser útil é subjetivo. Fazer uma pergunta de esclarecimento quando o funcionário não identificar o programa de benefícios descreve uma resposta observável.
Evite combinar regras não relacionadas em um parágrafo longo. Instruções separadas facilitam a identificação de qual regra precisa ser revisão após um teste com falha. Use termos consistentes para a mesma equipe, origem ou processo para que o agente não precise inferir se dois nomes se referem à mesma coisa.
Instruções orientam o comportamento do modelo, mas não fornecem imposição determinística. Os controles de segurança, as permissões de origem e os processos organizacionais permanecem necessários. Trate as instruções como especificações de comportamento que exigem testes e não como controles de acesso.
Para obter mais informações, consulte Configurar detalhes e instruções do agente.
Note
Reconhecemos que pessoas diferentes gostam de aprender de maneiras diferentes. Você pode optar por concluir este módulo em formato baseado em vídeo ou ler o conteúdo como texto e imagens. O texto contém mais detalhes do que os vídeos, portanto, em alguns casos, talvez você queira se referir a ele como material complementar à apresentação de vídeo.