Capacidades do agente declarativo no TypeSpec para Microsoft 365 Copilot

O TypeSpec para Microsoft 365 Copilot fornece capacidades incorporadas que permitem aos agentes declarativos aceder aos serviços e recursos externos do Microsoft 365. As capacidades disponíveis incluem CodeInterpreter, CopilotConnectors, Dataverse, Email, GraphicArt, Meetings, OneDriveAndSharePoint, Pessoas, ScenarioModels, TeamsMessages e WebSearch. Cada capacidade pode ser configurada com parâmetros específicos para controlar o âmbito.

AgentCapabilities.CodeInterpreter

Indica que o agente declarativo pode gerar e executar código Python para resolver problemas matemáticos complexos, analisar dados, gerar visualizações e muito mais.

op codeInterpreter is AgentCapabilities.CodeInterpreter;

Exemplo

op codeInterpreter is AgentCapabilities.CodeInterpreter;

AgentCapabilities.CopilotConnectors

Indica que o agente declarativo pode procurar informações de terra nos conectores Copilot selecionados.

op copilotConnectors is AgentCapabilities.CopilotConnectors;

Parâmetros

Modelos

Conexão

Identifica um conector Copilot.

Propriedades

ContainerNameItem

Identifica um contentor pelo respetivo nome.

Propriedades

ContainerUrlItem

Identifica um contentor pelo respetivo URL.

Propriedades

ExternalIdItem

Identifica um item externo pelo respetivo ID.

Propriedades

ExternalUrlItem

Identifica um item externo pelo respetivo URL.

Propriedades

PathItem

Identifica um item externo pelo respetivo caminho.

Propriedades

Exemplo

// Basic Copilot connectors with no restrictions
op copilotConnectors is AgentCapabilities.CopilotConnectors;

// Specific connectors
op copilotConnectors is AgentCapabilities.CopilotConnectors<Connections = [
  {
    connectionId: "ticketsconnector123";
  },
  {
    connectionId: "wikiconnector123";
  }
]>;

// Specific connector with KQL filtering
op copilotConnectors is AgentCapabilities.CopilotConnectors<Connections = [
  {
    connectionId: "ticketsconnector123";
    additionalSearchTerms: "CreatedDate>=2024-01-01 AND Priority:High";
  }
]>;

// Multiple connectors with different filtering approaches
op copilotConnectors is AgentCapabilities.CopilotConnectors<Connections = [
  {
    connectionId: "ticketsconnector456";
    itemsByPath: [
      { path: "/projects/customer-portal" },
      { path: "/projects/mobile-app" }
    ];
    itemsByContainerName: [
      { containerName: "Engineering Projects" },
      { containerName: "Product Backlog" }
    ];
  },
  {
    connectionId: "wikiconnector789";
    additionalSearchTerms: "space:ENGINEERING AND lastModified>now()-30d";
    itemsByContainerUrl: [
      { containerUrl: "https://wiki.contoso.com/ENGINEERING" },
      { containerUrl: "https://wiki.contoso.com/PRODUCT" }
    ];
  },
  {
    connectionId: "databaseconnector012";
    itemsByExternalId: [
      { externalId: "customer001" },
      { externalId: "customer002" },
      { externalId: "customer007" }
    ];
  }
]>;

AgentCapabilities.Dataverse

Indica que o agente declarativo pode procurar informações no Microsoft Dataverse.

op dataverse is AgentCapabilities.Dataverse;

Parâmetros

Modelos

DataverseKnowledgeSource

Representa uma origem de conhecimento Dataverse.

Propriedades

DataverseTable

Representa uma tabela Dataverse.

Propriedades

Exemplo

// Basic Dataverse with no restrictions
op dataverse is AgentCapabilities.Dataverse;

// Dataverse with specific environment
op dataverse is AgentCapabilities.Dataverse<KnowledgeSources = [
  {
    hostName: "contoso.crm.dynamics.com";
  }
]>;

// Dataverse with specific tables
op dataverse is AgentCapabilities.Dataverse<KnowledgeSources = [
  {
    hostName: "contoso.crm.dynamics.com";
    tables: [
      { tableName: "account" },
      { tableName: "contact" },
      { tableName: "opportunity" }
    ];
  }
]>;

// Dataverse with skill and tables
op dataverse is AgentCapabilities.Dataverse<KnowledgeSources = [
  {
    hostName: "contoso.crm.dynamics.com";
    skill: "sales-assistant";
    tables: [
      { tableName: "account" },
      { tableName: "lead" }
    ];
  }
]>;

AgentCapabilities.Email

Indica que o agente declarativo pode procurar mensagens de e-mail nas caixas de correio às quais o utilizador tem acesso.

op email is AgentCapabilities.Email;

Parâmetros

Modelos

Pasta

Propriedades

Exemplo

// Basic email search with no restrictions
op email is AgentCapabilities.Email;

// Email search with specific well-known folders
op email is AgentCapabilities.Email<
  Folders = [
    { folderId: "Inbox" },
    { folderId: "SentItems" },
    { folderId: "Archive" }
  ]
>;

// Email search with shared mailbox access
op email is AgentCapabilities.Email<
  SharedMailbox = "support@contoso.com"
>;

// Email search with custom folders and shared mailbox
op email is AgentCapabilities.Email<
  Folders = [
    { folderId: "Inbox" }
  ],
  SharedMailbox = "legal@contoso.com"
>;

AgentCapabilities.GraphicArt

Indica que o agente declarativo pode criar imagens e imagens com base na entrada de texto do utilizador.

op graphicArt is AgentCapabilities.GraphicArt;

Exemplo

op graphicArt is AgentCapabilities.GraphicArt;

AgentCapabilities.Meetings

Indica que o agente declarativo pode procurar conteúdo da reunião.

op meetings is AgentCapabilities.Meetings;

Exemplo

op meetings is AgentCapabilities.Meetings;

AgentCapabilities.OneDriveAndSharePoint

Indica que o agente declarativo pode procurar informações de base no SharePoint e no OneDrive de um utilizador.

op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint;

Parâmetros

Modelos

SharePointIds

Contém um ou mais identificadores de objetos que identificam um recurso do SharePoint ou do OneDrive.

Propriedades

SharePointUrl

Representa o URL de um recurso do SharePoint ou do OneDrive.

Propriedades

Exemplo

// Basic OneDrive and SharePoint with no restrictions
op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint;

// URL-based filtering for specific sites
op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint<
  ItemsBySharePointIds = [],
  ItemsByUrl = [
    { url: "https://contoso.sharepoint.com/sites/Engineering" },
    { url: "https://contoso.sharepoint.com/sites/ProductManagement" },
    { url: "https://contoso-my.sharepoint.com/personal/john_contoso_com" }
  ]
>;

// ID-based filtering with comprehensive site and document library scoping
op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint<
  ItemsBySharePointIds = [
    {
      siteId: "12345678-1234-1234-1234-123456789012";
      searchAssociatedSites: true;
    },
    {
      siteId: "87654321-4321-4321-4321-210987654321";
      webId: "11111111-2222-3333-4444-555555555555";
      listId: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee";
    },
    {
      siteId: "99999999-8888-7777-6666-555555555555";
      webId: "ffffffff-dddd-cccc-3333-cccccccccccc";
      listId: "ffffffff-eeee-dddd-cccc-bbbbbbbbbbbb";
      itemId: "12121212-3434-5656-7878-909090909090";
    }
  ],
  ItemsByUrl = [
    { url: "https://contoso.sharepoint.com/sites/Engineering" }
  ]
>;

AgentCapabilities.People

Indica que o agente declarativo pode procurar informações sobre pessoas na organização.

op people is AgentCapabilities.People;

Exemplo

op people is AgentCapabilities.People;

AgentCapabilities.ScenarioModels

Indica que o agente declarativo pode utilizar modelos específicos de tarefas.

op scenarioModels is AgentCapabilities.ScenarioModels<Models = [
  { id: "model-id" }
]>;

Parâmetros

Modelos

ScenarioModel

Identifica um modelo específico de tarefas.

Propriedades

Exemplo

// Single specialized model for analytics
op scenarioModels is AgentCapabilities.ScenarioModels<Models = [
  { id: "financial-forecasting-model-v3" }
]>;

// Multiple models for different business scenarios
op scenarioModels is AgentCapabilities.ScenarioModels<Models = [
  { id: "sentiment-analysis-model" },
  { id: "document-classification-model" },
  { id: "risk-assessment-model" }
]>;

AgentCapabilities.TeamsMessages

Indica que o agente declarativo pode procurar em canais do Teams, equipas, reuniões, conversas 1:1 e conversas em grupo.

op teamsMessages is AgentCapabilities.TeamsMessages;

Parâmetros

Modelos

TeamsMessagesUrl

Identifica um canal do Teams, uma equipa ou um chat de reunião.

Propriedades

Exemplo

// Basic Teams messages with no restrictions
op teamsMessages is AgentCapabilities.TeamsMessages;

// Teams messages limited to specific channels and chats
op teamsMessages is AgentCapabilities.TeamsMessages<TeamsMessagesByUrl = [
  { url: "https://teams.microsoft.com/l/channel/19%3a123abc...%40thread.skype/General?groupId=12345&tenantId=67890" },
  { url: "https://teams.microsoft.com/l/chat/19%3ameeting_abc123...%40thread.v2/0?context=%7b%22Tid%22%3a%22...%22%7d" },
  { url: "https://teams.microsoft.com/l/channel/19%3a456def...%40thread.tacv2/Engineering?groupId=54321&tenantId=09876" }
]>;

// Teams messages for project-specific channels
op teamsMessages is AgentCapabilities.TeamsMessages<TeamsMessagesByUrl = [
  { url: "https://teams.microsoft.com/l/channel/19%3aprojectA...%40thread.tacv2/Development?groupId=11111&tenantId=22222" },
  { url: "https://teams.microsoft.com/l/channel/19%3aprojectA...%40thread.tacv2/Testing?groupId=11111&tenantId=22222" },
  { url: "https://teams.microsoft.com/l/chat/19%3astandup_daily...%40thread.v2/0?context=%7b%22Tid%22%3a%22...%22%7d" }
]>;

AgentCapabilities.WebSearch

Indica que o agente declarativo pode procurar na Web informações de ligação à terra.

op webSearch is AgentCapabilities.WebSearch;

Parâmetros

Modelos

SiteUrl

Indica um site onde um agente declarativo pode procurar conteúdo.

Propriedades

Exemplo

// Basic web search with no restrictions
op webSearch is AgentCapabilities.WebSearch;

// Web search limited to specific documentation sites
op webSearch is AgentCapabilities.WebSearch<Sites = [
  {
    url: "https://learn.microsoft.com";
  },
  {
    url: "https://docs.microsoft.com";
  },
  {
    url: "https://techcommunity.microsoft.com";
  }
]>;

// Web search for company-specific resources
op webSearch is AgentCapabilities.WebSearch<Sites = [
  {
    url: "https://company.com/knowledge-base";
  },
  {
    url: "https://support.company.com";
  }
]>;