Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você pode usar conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph) para trazer dados de serviços externos para o Microsoft Graph. A API de conectores do Copilot permite indexar dados externos para criar experiências inteligentes no Microsoft 365, como o Copilot e a Pesquisa da Microsoft.
As solicitações para indexar dados são executadas em nome de um aplicativo sem a presença de um usuário conectado por meio de um token de acesso com permissão de aplicativo.
Criar um conector Copilot personalizado
A criação de um conector Copilot personalizado envolve quatro etapas:
- Crie um registro de aplicativo do Entra ID (anteriormente conhecido como Azure Active Directory). Juntamente com a solicitação para o Microsoft Graph, você envia o nome do registro do aplicativo e as permissões de API de que seu aplicativo precisa. O Microsoft Graph responde com informações sobre o registro do aplicativo recém-criado.
- Crie uma conexão externa. Cada conexão requer uma ID, um nome e uma descrição exclusivos.
- Crie o esquema para a conexão externa. O esquema define a forma do conteúdo externo que você ingerirá por meio dessa conexão do Microsoft Graph. A criação do esquema é uma operação de execução prolongada. Depois de enviar o esquema para criar a conexão, o Microsoft Graph responde com uma URL que você pode usar para marcar o status da operação. O esquema está sendo provisionado desde que o status da operação seja
inprogress. Quando o provisionamento for concluído, a operação retornará umcompletedstatus. - 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 conexão externa e envie-o para o Microsoft Graph como um item externo. Junto com o item, inclua informações sobre quem tem permissão para acessá-lo, também conhecido como ACL (lista de controle de acesso).
Veja a seguir um diagrama de sequência que ilustra as quatro etapas para criar um conector Copilot.
Casos de uso comuns
A tabela a seguir lista casos de uso comuns para a API de conectores do Copilot.
| Casos de uso | Recursos REST | Confira também |
|---|---|---|
| Ações de configuração | ||
| Criar, atualizar ou excluir uma conexão | externalConnection | Métodos de externalConnection |
| Registrar um esquema para os dados externos | schema | métodos de esquema |
| Ações de indexação | ||
| Adicionar, atualizar ou excluir um item personalizado no índice | externalItem | métodos de externalItem |
Limitações conhecidas
A seguir estão as limitações conhecidas atuais:
- Um aplicativo é limitado a 25 operações simultâneas em uma conexão.
- O tamanho máximo de uma
externalItementidade é de 30 MB.