Trabalhar com a API de conectores do Copilot

Os conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph) trazem dados externos para o Microsoft Graph e aprimoram as experiências inteligentes do Microsoft 365. Você pode criar um conector personalizado para integração com serviços que não estão disponíveis como conectores desenvolvidos pela Microsoft. Para criar conectores personalizados, use a API REST de conectores do Copilot. Os itens ingeridos por meio de conexões criadas com as APIs consomem sua cota de itens. Para obter mais informações sobre como determinar quanta cota de item você tem e comprar cota adicional, consulte requisitos e preços de licenciamento.

Você pode usar a API de conectores do Copilot para:

1. Criar e gerenciar conexões de dados externos.
2. Defina e registre o esquema dos tipos de dados externos.
3. Ingerir itens de dados externos no Microsoft Graph.
4. Sincronizar grupos externos.

Criar e gerenciar conexões de dados externos.

O recurso externalConnection (API de conexão externa) é um contêiner lógico para seus dados externos que você pode gerenciar como uma única unidade.

Para obter mais informações, consulte Criar, atualizar e excluir conexões no Microsoft Graph.

Definir e registrar o esquema dos tipos de dados externos

O esquema de conexão (API de esquema) determina como seu conteúdo é usado em várias experiências do Microsoft 365. O esquema é uma lista simples de todas as propriedades que você planeja adicionar à conexão junto com seus atributos, rótulos e aliases. Você deve registrar o esquema antes de ingerir itens no Microsoft Graph.

Para obter mais informações, consulte Registrar e atualizar esquema para a conexão do Microsoft Graph.

Ingerir itens de dados externos no Microsoft Graph.

Os itens adicionados por seu aplicativo ao serviço Pesquisa da Microsoft são representados pelo recurso externalItem (API de item externo) no Microsoft Graph.

Para obter mais informações, consulte Criar, atualizar e excluir itens adicionados pelo seu aplicativo por meio de conectores do Copilot.

Sincronizar grupos externos

Os itens no serviço externo podem ter acesso concedido ou negado por meio da ACL a diferentes tipos de grupos que não são do Microsoft Entra. Por exemplo, os itens do Salesforce podem ter conjuntos de permissões e perfis, enquanto os itens do ServiceNow podem ter grupos locais. Ao ingerir esses itens no Microsoft Graph, você precisará respeitar essas ACLs.

Você pode usar a API de grupo externo para definir permissões em itens externos ingeridos no Microsoft Graph. Um externalGroup representa um grupo que não é do Microsoft Entra ou uma construção semelhante a um grupo e determina as permissões no conteúdo em sua fonte de dados externa.

Para obter mais informações, consulte Usar grupos externos para gerenciar permissões para fontes de dados de conectores do Microsoft Graph.

Próxima etapa