Criar Agente Declarativo TypeSpec

Crie um agente declarativo TypeSpec completo para o Microsoft 365 Copilot com a seguinte estrutura:

Requisitos

Gere um arquivo main.tsp com:

1. Declaração do Agente

   • Use o decorador @agent com um nome e descrição descritivos
   • O nome deve ter 100 caracteres ou menos
   • A descrição deve ter 1.000 caracteres ou menos

2. Instruções

   • Use o decorador @instructions com diretrizes claras de comportamento
   • Defina o papel, a especialidade e a personalidade do agente
   • Especifique o que o agente deve e não deve fazer
   • Mantenha em menos de 8.000 caracteres

3. Iniciadores de Conversa

   • Inclua 2-4 decoradores @conversationStarter
   • Cada um com um título e um exemplo de consulta
   • Torne-os diversos e mostre diferentes capacidades

4. Capacidades (com base nas necessidades do usuário)

   • WebSearch - para conteúdo da web com escopo opcional de site
   • OneDriveAndSharePoint - para acesso a documentos com filtragem de URL
   • TeamsMessages - para acesso a canais/chats do Teams
   • Email - para acesso a e-mails com filtragem de pasta
   • People - para pesquisa de pessoas na organização
   • CodeInterpreter - para execução de código Python
   • GraphicArt - para geração de imagens
   • GraphConnectors - para conteúdo do conector Copilot
   • Dataverse - para acesso a dados do Dataverse
   • Meetings - para acesso a conteúdo de reuniões

Estrutura do Modelo

import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";

using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;

@agent({
  name: "[Agent Name]",
  description: "[Agent Description]"
})
@instructions("""
  [Detailed instructions about agent behavior, role, and guidelines]
""")
@conversationStarter(#{
  title: "[Starter Title 1]",
  text: "[Example query 1]"
})
@conversationStarter(#{
  title: "[Starter Title 2]",
  text: "[Example query 2]"
})
namespace [AgentName] {
  // Add capabilities as operations here
  op capabilityName is AgentCapabilities.[CapabilityType]<[Parameters]>;
}

Melhores Práticas

• Use nomes de agentes descritivos e baseados em funções (por exemplo, "Assistente de Suporte ao Cliente", "Ajudante de Pesquisa")
• Escreva as instruções na segunda pessoa ("Você é...")
• Seja específico sobre a especialidade e as limitações do agente
• Inclua iniciadores de conversa diversos que demonstrem diferentes recursos
• Inclua apenas as capacidades que o agente realmente precisa
• Escopo de capacidades (URLs, pastas, etc.) quando possível para melhor desempenho
• Use strings entre aspas triplas para instruções de várias linhas

Exemplos

Pergunte ao usuário:

1. Qual é o propósito e o papel do agente?
2. Quais capacidades ele precisa?
3. A quais fontes de conhecimento ele deve acessar?
4. Quais são as interações típicas do usuário?

Em seguida, gere a definição completa do agente TypeSpec.