Publique conectores personalizados do Copilot no Centro de administração do Microsoft 365

Ao usar o SDK dos conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph), você pode publicar seus conectores personalizados por meio do Centro de administração do Microsoft 365, da mesma forma que os conectores internos da Microsoft são publicados.

Observação

Leia o artigo Configuração do conector do Graph para entender as instruções gerais de configuração dos conectores do Graph.

Use as seguintes etapas para publicar uma conexão para seu conector personalizado:

  1. Verifique se o arquivo CustomConnectorPortMap.json está atualizado. Depois de desenvolver o código do conector personalizado, adicione o mapeamento da ID do conector e a porta em que ele está sendo executado nesse arquivo. Este arquivo está na pasta de instalação do agente do conector do Microsoft Graph.

    Captura de tela do mapeamento de porta no arquivo CustomConnectorPortMap.json.

    Observação

    • Você pode adicionar várias IDs de conector e suas informações de porta correspondentes a esse arquivo usando o formato Id> do <Conector:<Porta>. Cada conector exclusivo deve estar em execução em uma porta diferente.
    • Se você atualizou de uma versão da GCA inferior a 1.8.0.0, siga as etapas de solução de problemas para corrigir falhas de conexão.

  2. Adicione um conector Copilot no Centro de administração do Microsoft 365 na guia Fontes de Dados na seção Pesquisa & Inteligência. Para obter detalhes, consulte Adicionar um conector do Copilot no Centro de administração do Microsoft 365.

  3. Escolha Conector Personalizado e forneça o manifesto validado pelo aplicativo de teste.

  4. Dê um nome à conexão. Para obter detalhes, consulte Etapa 2: nomeie a conexão.

  5. Forneça a URL para a fonte de dados à qual você está se conectando e as credenciais para acessá-la. Escolha o agente do conector do Microsoft Graph e valide as informações fornecidas. Escolha Avançar.

  6. Forneça qualquer configuração extra, se exigido pelo conector. Você pode passar qualquer informação específica para a conexão com a fonte de dados.

    Por exemplo, se você estiver criando um conector para o Azure DevOps Services, os projetos que precisam ser indexados poderão ser os parâmetros extras. Para um conector Wiki, as subseções que precisam ser indexadas podem ser os parâmetros extras. A API para consultar o wiki pode usar os filtros especificados nos parâmetros extras e obter os itens da fonte de dados.

    Os dados no parâmetro são opacos para a plataforma. Ele é serializado e armazenado como uma cadeia de caracteres e passado para o conector. O conector pode desserializar esses dados conforme necessário e usá-los.

  7. Na página Atribuir rótulos de propriedade , atribua rótulos semânticos às propriedades de origem. O tipo de resultado padrão não funcionará se os rótulos semânticos não forem atribuídos.

  8. Gerenciar o esquema:

    • Selecione uma propriedade de conteúdo. Recomendamos que você selecione uma Propriedade de Conteúdo no menu suspenso de opções ou mantenha o padrão, se houver uma. Essa propriedade é usada para indexação de texto completo de conteúdo e para melhorar sua relevância de pesquisa.
    • Defina aliases para suas propriedades. Você pode adicionar aliases a suas propriedades na página Gerenciar esquema na coluna Alias . Aliases são nomes amigáveis para suas propriedades.
    • Defina os atributos de esquema de pesquisa. Você pode definir os atributos do esquema de pesquisa para controlar a funcionalidade de pesquisa de cada propriedade de origem. Um esquema de pesquisa ajuda a determinar quais resultados são exibidos na página de resultados da pesquisa e quais informações os usuários finais podem exibir e acessar.

    Para obter detalhes, consulte Etapa 7: Gerenciar esquema.

  9. Você pode gerenciar permissões de pesquisa com base em listas de controle de acesso (ACLs) que determinam quais usuários em sua organização podem acessar cada item. Somente Listas de Controle de Acesso baseadas no Microsoft Entra ID têm suporte para pessoas com acesso à fonte de dados. Para obter detalhes, consulte Etapa 5: Gerenciar permissões de pesquisa.

  10. Escolha as frequências de atualização dos rastreamentos. O intervalo de atualização determina com que frequência seus dados são sincronizados entre a fonte de dados e a Pesquisa da Microsoft. Para obter detalhes, consulte Etapa 8: Frequências de atualização.

  11. Revise os detalhes fornecidos e escolha Concluir. Para obter detalhes, consulte Etapa 9: Revisar conexão.

  12. Personalize a página de resultados da pesquisa configurando verticais e tipos de resultados. Para obter detalhes, consulte Etapa 10: Personalizar a página de resultados da pesquisa.

  13. Examine a conexão publicada na guia Fontes de dados para confirmar se a configuração da conexão funcionou. Para obter detalhes, consulte Etapa 11: confirmar se a configuração da conexão funcionou.

Conteúdo relacionado

  • Last updated on