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.
O SDK Microsoft 365 Copilot conectores (anteriormente conectores do Microsoft Graph) simplifica o processo de criação de conectores de alta qualidade, eficientes e resilientes para origens de dados que não têm um conector pré-criado, mas que pretende indexar no Microsoft Graph.
O SDK inclui a estrutura e os componentes do contrato para ajudá-lo a escrever o código e as ferramentas para testar o seu código.
O SDK de conectores permite-lhe criar conectores Copilot personalizados diretamente no ambiente de desenvolvimento integrado (IDE) do Visual Studio. Fornece tudo o que precisa para criar, depurar e implementar o conector personalizado.
Os itens ingeridos através de ligações criadas com o SDK consomem a quota de itens. Para saber mais sobre como determinar a quota de itens que tem e como comprar mais quota, veja requisitos de licenciamento e preços.
Componentes
O SDK de conectores inclui os seguintes componentes:
Modelo de conector personalizado: se quiser desenvolver o conector personalizado em C#, pode transferir o modelo a partir do Visual Studio Marketplace e começar rapidamente. Também pode optar por desenvolver o conector personalizado em qualquer um dos idiomas desta lista.
Contratos: os contratos são ficheiros de memória intermédia de protocolo gRPC que contêm os contratos de 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 gere as capacidades e coordenadas do conector entre o Centro de administração do Microsoft 365 e o código do conector personalizado.
Transfira a versão mais recente do agente do conector e execute a configuração de instalação assistente. Para obter mais informações, veja Agente do conector do Microsoft Graph.
Utilitário de teste do SDK de conectores: inclui cenários de teste pré-criados que pode utilizar para testar o código do conector personalizado e comunicar com a plataforma do agente do conector.
Capacidades do agente do conector do Microsoft Graph
O agente do conector baseia-se na mesma plataforma de conectores robusta que é utilizada para executar os conectores incorporados da Microsoft.
Inclui as seguintes capacidades:
Obter dados do conector: o agente pode ligar-se ao conector personalizado para obter dados da origem com a lógica implementada pelo conector.
Centro de administração do Microsoft 365 integração: o agente permite-lhe configurar, gerir e monitorizar os seus conectores personalizados através do Centro de administração do Microsoft 365.
Agendamento e gestão da pesquisa: o agente é capaz de pesquisar a origem de dados através de pesquisas completas e pesquisas incrementais. As pesquisas completas (baseadas em listas ou baseadas no Microsoft Graph) analisam periodicamente todos os seus dados num intervalo definido por si. As pesquisas incrementais são mais frequentes e pesquisam a origem de dados do carimbo de data/ponto de verificação de data/hora anterior num intervalo definido por si.
Eliminação, diferença e deteção de ciclos: o agente é capaz de detetar itens eliminados da sua origem de dados com base nos itens enviados pelo conector durante pesquisas completas periódicas. Em seguida, o agente também trata de eliminar o item do índice da Microsoft.
O agente também deteta itens que mudaram desde a última pesquisa ao calcular um hash do item e compará-lo com o hash do item visto anteriormente. Para tornar as pesquisas mais rápidas, o agente envia os dados para serem indexados apenas quando o item for alterado.
O agente também deteta itens duplicados que surgem de origens de dados que têm itens ligados (como sites) e ignora a pesquisa destes itens.
Mapeamento de identidade: o agente do conector permite a carimbação de Controle de Acesso Listas (ACLs) nos seus dados para permitir a limitação de segurança. Pode ativar a limitação de segurança com base em Microsoft Entra ID ou ACLs da sua origem de dados.
Ingestão do Microsoft Graph: o agente ingere os dados no Microsoft Graph depois de os receber do conector personalizado.
Observação
As seguintes capacidades não estão atualmente disponíveis:
- Percurso de origem de dados baseado em gráficos durante pesquisas; por exemplo, percorrer as estruturas de pastas.
- A capacidade de gerir permissões de pesquisa com base no controlo de acesso da sua origem de dados.
Pode começar em C# com os nossos conectores de exemplo ou noutros idiomas suportados através dos contratos da página do SDK dos conectores Copilot no GitHub.