Configurar detalhes e instruções do agente

Nos detalhes e instruções do agente, defina o agente e o seu comportamento. Esta definição molda o tom, o âmbito e o estilo de resposta do agente.

  • Os agentes baseados no GitHub Copilot harness utilizam instruções como principal mecanismo para controlar o seu comportamento. O ambiente de execução de orquestração melhorado interpreta estas instruções ao responder aos utilizadores. As instruções orientam o agente sobre o que fazer, como responder e o que evitar.
  • Os agentes alimentados pelo arnês de chat Copilot dependem de instruções para decidir que recursos (ferramentas, conhecimento, tópicos ou outros agentes) chamar para responder a uma consulta do utilizador ou a um gatilho autónomo. Usam instruções para preencher as entradas de qualquer ferramenta com base no contexto disponível e geram uma resposta para o utilizador final.

Configure os seguintes elementos no separador Build para agentes suportados pela infraestrutura do GitHub Copilot ou no separador Configure para agentes suportados pela infraestrutura de chat do Copilot.

  • Nome do agente: um campo de nome editável onde define o nome a apresentar do agente.
  • Ícone do agente: um ícone para o agente. Pode substituir o ícone predefinido e a sua cor por algo mais representativo.
  • Instruções: orientação em linguagem natural que molda o comportamento, o tom e o âmbito do agente.

Configure os dados e instruções do seu agente

  1. Abra o seu agente no Copilot Studio.

  2. Selecione o separador Build ou Configure, consoante o harness do seu agente.

  3. Para atualizar o nome do agente:

    • Para agentes alimentados pelo harness GitHub Copilot, selecione o campo de nome e insira um novo nome.
    • Para agentes alimentados pelo chat harness do Copilot, selecione Editar na secção Detalhes e depois selecione o campo nome para inserir um novo nome. O comprimento máximo do nome é de 42 caracteres. O nome não pode incluir colchetes angulares (< e >). No campo de Descrição , pode também fornecer uma breve descrição do que o agente irá fazer.
  4. Para substituir ou personalizar o ícone do agente:

    • Para agentes alimentados pelo harness GitHub Copilot, selecione o ícone existente. No diálogo Alterar ícone do agente, selecione um novo ícone do catálogo ou carregue o ícone que pretende. O ícone deve estar em formato PNG, e o seu tamanho deve ser de 100 KB ou menos. Selecione Cores para escolher uma cor diferente ou adicione uma cor de destaque. Selecione Aplicar para guardar as alterações.
    • Para agentes alimentados pelo chat harness do Copilot, selecione Editar, selecione o ícone Alterar e depois selecione o ícone Alterar para carregar um novo ícone. O ícone deve estar em formato PNG. Para melhor desempenho, use um tamanho de 192x192 píxeis e 100 KB. Selecione Guardar para guardar as alterações.
  5. Na secção Instruções, selecione o espaço sob Instruções e comece a escrever. Introduza instruções em linguagem natural que orientam o comportamento do agente. Seja específico quanto ao propósito, tom e limites do agente. Selecione Guardar.

Escreva instruções eficazes

As instruções são a ferramenta mais importante para moldar o comportamento dos agentes nos agentes. Instruções bem elaboradas ajudam o agente a manter-se no assunto, responder no tom adequado e lidar corretamente com situações excecionais.

Considere incluir:

  • O propósito e função principal do agente.
  • O tom e o estilo que o agente deve usar (formal, amigável, conciso).
  • Assuntos ou tarefas que o agente deve recusar ou redirecionar.
  • Como o agente deve lidar com a entrada do utilizador pouco clara ou ambígua.
  • Quaisquer gatilhos de escalonamento ou transferência.

Sugestão

Comece com uma descrição clara e simples do propósito do agente e expanda a partir daí. Pode atualizar as instruções iterativamente enquanto testa o comportamento do agente.

Para orientações gerais sobre como escrever instruções para agentes, consulte Escrever instruções para agentes. (Algumas orientações desse artigo são específicas para o modelo baseado em tópicos do standard harness.)

Passos seguintes