Fonctionnalités de l’agent déclaratif dans TypeSpec pour Microsoft 365 Copilot

TypeSpec for Microsoft 365 Copilot fournit des fonctionnalités intégrées qui permettent aux agents déclaratifs d’accéder aux services Microsoft 365 et aux ressources externes. Les fonctionnalités disponibles incluent CodeInterpreter, CopilotConnectors, Dataverse, Email, GraphicArt, Meetings, OneDriveAndSharePoint, Personnes, ScenarioModels, TeamsMessages et WebSearch. Chaque fonctionnalité peut être configurée avec des paramètres spécifiques pour contrôler l’étendue.

AgentCapabilities.CodeInterpreter

Indique que l’agent déclaratif peut générer et exécuter du code Python pour résoudre des problèmes mathématiques complexes, analyser des données, générer des visualisations, etc.

op codeInterpreter is AgentCapabilities.CodeInterpreter;

Exemple

op codeInterpreter is AgentCapabilities.CodeInterpreter;

AgentCapabilities.CopilotConnectors

Indique que l’agent déclaratif peut rechercher des informations de mise à la terre dans les connecteurs Copilot sélectionnés.

op copilotConnectors is AgentCapabilities.CopilotConnectors;

Paramètres

Modèles

Connection

Identifie un connecteur Copilot.

Propriétés

ContainerNameItem

Identifie un conteneur par son nom.

Propriétés

ContainerUrlItem

Identifie un conteneur par son URL.

Propriétés

ExternalIdItem

Identifie un élément externe par son ID.

Propriétés

ExternalUrlItem

Identifie un élément externe par son URL.

Propriétés

PathItem

Identifie un élément externe par son chemin d’accès.

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut rechercher des informations dans Microsoft Dataverse.

op dataverse is AgentCapabilities.Dataverse;

Paramètres

Modèles

DataverseKnowledgeSource

Représente une source de connaissances Dataverse.

Propriétés

DataverseTable

Représente une table Dataverse.

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut effectuer des recherches dans les e-mails dans les boîtes aux lettres auxquelles l’utilisateur a accès.

op email is AgentCapabilities.Email;

Paramètres

Modèles

Folder

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut créer des images et des illustrations en fonction de l’entrée de texte de l’utilisateur.

op graphicArt is AgentCapabilities.GraphicArt;

Exemple

op graphicArt is AgentCapabilities.GraphicArt;

AgentCapabilities.Meetings

Indique que l’agent déclaratif peut rechercher le contenu de la réunion.

op meetings is AgentCapabilities.Meetings;

Exemple

op meetings is AgentCapabilities.Meetings;

AgentCapabilities.OneDriveAndSharePoint

Indique que l’agent déclaratif peut rechercher des informations de base dans SharePoint et OneDrive d’un utilisateur.

op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint;

Paramètres

Modèles

SharePointIds

Contient un ou plusieurs identificateurs d’objet qui identifient une ressource SharePoint ou OneDrive.

Propriétés

SharePointUrl

Représente l’URL d’une ressource SharePoint ou OneDrive.

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut rechercher des informations sur les personnes dans le organization.

op people is AgentCapabilities.People;

Exemple

op people is AgentCapabilities.People;

AgentCapabilities.ScenarioModels

Indique que l’agent déclaratif peut utiliser des modèles spécifiques à une tâche.

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

Paramètres

Modèles

ScenarioModel

Identifie un modèle spécifique à une tâche.

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut effectuer des recherches dans les canaux Teams, les équipes, les réunions, les conversations 1:1 et les conversations de groupe.

op teamsMessages is AgentCapabilities.TeamsMessages;

Paramètres

Modèles

TeamsMessagesUrl

Identifie un canal Teams, une équipe ou une conversation de réunion.

Propriétés

Exemple

// 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

Indique que l’agent déclaratif peut rechercher des informations de base sur le web.

op webSearch is AgentCapabilities.WebSearch;

Paramètres

Modèles

SiteUrl

Indique un site qu’un agent déclaratif peut rechercher du contenu.

Propriétés

Exemple

// 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";
  }
]>;