Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O SDK de conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph) simplifica o processo de criação de conectores de alta qualidade, eficientes e resilientes para fontes de dados que não têm um conector predefinido, mas que você deseja indexar no Microsoft Graph.
O SDK inclui os componentes de estrutura e contrato para ajudá-lo a escrever o código e as ferramentas para testar seu código.
O SDK de conectores permite que você crie conectores personalizados do Copilot diretamente no IDE (ambiente de desenvolvimento integrado) do Visual Studio. Ele fornece tudo o que você precisa para criar, depurar e implantar seu conector personalizado.
Os itens ingeridos por meio de conexões criadas com o SDK consomem sua cota de itens. Para saber mais sobre como determinar quanta cota de item você tem e como comprar mais cota, confira requisitos de licenciamento e preços.
Componentes
O SDK de conectores inclui os seguintes componentes:
Modelo de conector personalizado: se você quiser desenvolver seu conector personalizado em C#, poderá baixar o modelo do Visual Studio Marketplace e começar rapidamente. Você também pode optar por desenvolver seu conector personalizado em qualquer um dos idiomas nesta lista.
Contratos: os contratos são arquivos de buffer de protocolo gRPC que contêm os contratos para interação entre a plataforma Microsoft (agente do conector do Microsoft Graph) e o código do conector personalizado.
Agente do conector do Microsoft Graph: um componente de software leve que gerencia as funcionalidades e coordenadas do conector entre o Centro de administração do Microsoft 365 e o código do conector personalizado.
Baixe a versão mais recente do agente do conector e execute o assistente de configuração de instalação. Para obter mais informações, consulte Agente do conector do Microsoft Graph.
Utilitário de teste do SDK de conectores: inclui cenários de teste predefinidos que você pode usar para testar o código do conector personalizado e se comunicar com a plataforma do agente do conector.
Recursos do agente do conector do Microsoft Graph
O agente do conector é criado na mesma plataforma de conector robusta usada para executar os conectores internos da Microsoft.
Ele inclui os seguintes recursos:
Obter dados do conector: o agente pode se conectar ao conector personalizado para obter dados da fonte usando a lógica implementada pelo conector.
Centro de administração do Microsoft 365: o agente permite que você configure, gerencie e monitore seus conectores personalizados por meio do Centro de administração do Microsoft 365.
Agendamento e gerenciamento de rastreamento: o agente é capaz de rastrear a fonte de dados por meio de rastreamentos completos e incrementais. Os rastreamentos completos (baseados em listas ou no Microsoft Graph) percorrem todos os seus dados periodicamente em um intervalo definido por você. Os rastreamentos incrementais são mais frequentes e rastreiam a fonte de dados do carimbo de data/hora/ponto de verificação anterior em um intervalo definido por você.
Detecção de exclusão, diferença e ciclo: o agente é capaz de detectar itens excluídos da fonte de dados com base nos itens enviados pelo conector durante rastreamentos completos periódicos. Em seguida, o agente também se encarrega de excluir o item do índice da Microsoft.
O agente também detecta itens que foram alterados desde o último rastreamento, calculando um hash do item e comparando-o com o hash do item visto anteriormente. Para tornar os rastreamentos mais rápidos, o agente envia os dados para serem indexados somente quando o item for alterado.
O agente também detecta itens duplicados que surgem de fontes de dados que têm itens vinculados (como sites) e ignora o rastreamento desses itens.
Mapeamento de identidade: o agente do conector permite a marcação de ACLs (Listas de Controle de Acesso) em seus dados para habilitar a filtragem de segurança. Você pode habilitar a filtragem de segurança com base no Microsoft Entra ID ou ACLs da sua fonte de dados.
Ingestão do Microsoft Graph: o agente ingere os dados no Microsoft Graph depois de recebê-los do conector personalizado.
Observação
Os seguintes recursos não estão disponíveis no momento:
- Travessia de fonte de dados baseada em gráficos durante rastreamentos; por exemplo, atravessando estruturas de pastas.
- A capacidade de gerenciar permissões de pesquisa com base no controle de acesso da sua fonte de dados.
Você pode começar a usar C# com nossos conectores de exemplo ou em outras linguagens com suporte usando os contratos da página SDK de conectores do Copilot no GitHub.