Utilizar a API de conectores Copilot

Pode utilizar conectores Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph) para transferir dados de serviços externos para o Microsoft Graph. A API de conectores Copilot permite-lhe indexar dados externos para poder utilizar experiências inteligentes no Microsoft 365, como o Copilot e o Microsoft Search.

Os pedidos para indexar dados são realizados em nome de uma aplicação sem a presença de um utilizador com sessão iniciada através de um token de acesso com permissão de aplicação.

Criar um conector Copilot personalizado

A criação de um conector Copilot personalizado envolve quatro passos:

1. Crie um Entra ID (anteriormente conhecido como registo de aplicações do Azure Active Directory). Juntamente com o pedido ao Microsoft Graph, submeta o nome do registo de aplicações e as permissões da API de que a sua aplicação precisa. O Microsoft Graph responde com informações sobre o registo de aplicações recentemente criado.
2. Crie uma ligação externa. Cada ligação requer um ID, um nome e uma descrição exclusivos.
3. Crie o esquema para a ligação externa. O esquema define a forma de conteúdo externo que irá ingerir através desta ligação do Microsoft Graph. A criação do esquema é uma operação de execução prolongada. Depois de submeter o esquema para criar a ligação, o Microsoft Graph responde com um URL que pode utilizar para marcar o status da operação. O esquema está a ser aprovisionado desde que a operação status seja inprogress. Quando o aprovisionamento estiver concluído, a operação devolverá uma completed status.
4. Ingerir conteúdo externo. Para cada item externo, extraia-o do repositório de conteúdo de origem, transforme-o para que corresponda ao esquema da sua ligação externa e submeta-o no Microsoft Graph como um item externo. Juntamente com o item, inclua informações sobre quem tem permissão para aceder ao mesmo, também conhecida como lista de controlo de acesso (ACL).

Segue-se um diagrama de sequência que ilustra os quatro passos para criar um conector Copilot.

Casos de uso comuns

A tabela seguinte lista os casos de utilização comuns da API de conectores Copilot.

Limitações conhecidas

A seguir estão as limitações conhecidas atuais:

• Uma aplicação está limitada a 25 operações simultâneas numa ligação.
• O tamanho máximo de uma entidade externalItem é 4 MB.

Conteúdo relacionado

• Descrição geral dos conectores copilot