Recursos do agente declarativo no TypeSpec para o Microsoft 365 Copilot

O TypeSpec para Microsoft 365 Copilot fornece recursos internos que permitem que agentes declarativos acessem serviços e recursos externos do Microsoft 365. Os recursos disponíveis incluem CodeInterpreter, CopilotConnectors, Dataverse, Email, GraphicArt, Meetings, OneDriveAndSharePoint, People, ScenarioModels, TeamsMessages e WebSearch. Cada funcionalidade pode ser configurada com parâmetros específicos para controlar o escopo.

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 pesquisar conectores Copilot selecionados para obter informações de aterramento.

op copilotConnectors is AgentCapabilities.CopilotConnectors;

Parâmetros

Modelos

Conexão

Identifica um conector Copilot.

Propriedades

ContainerNameItem

Identifica um contêiner pelo nome.

Propriedades

ContainerUrlItem

Identifica um contêiner por sua URL.

Propriedades

ExternalIdItem

Identifica um item externo por sua ID.

Propriedades

ExternalUrlItem

Identifica um item externo por sua URL.

Propriedades

PathItem

Identifica um item externo por seu 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 pesquisar informações no Microsoft Dataverse.

op dataverse is AgentCapabilities.Dataverse;

Parâmetros

Modelos

DataverseKnowledgeSource

Representa uma fonte de conhecimento do Dataverse.

Propriedades

DataverseTable

Representa uma tabela do 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 pesquisar mensagens de email nas caixas de correio às quais o usuário 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 arte com base na entrada de texto do usuário.

op graphicArt is AgentCapabilities.GraphicArt;

Exemplo

op graphicArt is AgentCapabilities.GraphicArt;

AgentCapabilities.Meetings

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

op meetings is AgentCapabilities.Meetings;

Exemplo

op meetings is AgentCapabilities.Meetings;

AgentCapabilities.OneDriveAndSharePoint

Indica que o agente declarativo pode pesquisar o SharePoint e o OneDrive de um usuário para obter informações básicas.

op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint;

Parâmetros

Modelos

SharePointIds

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

Propriedades

SharePointUrl

Representa a 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 pesquisar 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 usar modelos específicos de tarefa.

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

Parâmetros

Modelos

Modelo de cenário

Identifica um modelo específico da tarefa.

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 pesquisar canais, equipes, reuniões, chats 1:1 e chats em grupo do Teams.

op teamsMessages is AgentCapabilities.TeamsMessages;

Parâmetros

Modelos

TeamsMessagesUrl

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

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 pesquisar na web por informações básicas.

op webSearch is AgentCapabilities.WebSearch;

Parâmetros

Modelos

SiteUrl

Indica um site que um agente declarativo pode pesquisar 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";
  }
]>;