Solucionar problemas com o SDK de conectores do Copilot

Este artigo descreve alguns dos problemas mais comuns com o SDK de conectores do Microsoft 365 Copilot e como solucioná-los.

Itens ausentes do índice

Se itens que existiam anteriormente estiverem ausentes no índice, isso pode ser devido à lógica de detecção de exclusão na plataforma. Os itens ausentes de uma resposta bem-sucedida no OperationStatus que já estão no índice serão removidos do índice.

Se o conector enviar respostas de falhas transitórias e mais de 10% dos itens resultarem em falhas de rastreamento, os itens que não estiverem incluídos nos dois últimos rastreamentos serão excluídos.

Lidar com alterações na porta do conector

Quando o conector precisa ser executado em uma porta diferente, você precisa atualizar o arquivo de configuração do mapa de portas com os novos valores. Ao editar o arquivo de configuração do mapa de portas, você deve reiniciar o serviço GCA para que as alterações entrem em vigor. Para reiniciar o serviço, abra services.msc e reinicie GcaHostService.

Falha de conexão após a atualização da GCA

Se você notar falhas de conexão após a atualização de uma versão GCA 1.8.0.0 ou inferior, siga as seguintes etapas:

1. Abra o Painel de Controle da GCA. Em Programas e recursos, selecione o agente do conector do Graph na lista de programas e escolha Reparar.
2. Atualize a nova configuração do arquivo de mapa de porta com as configurações anteriores.
3. Retome todas as conexões com falha do Centro de administração do Microsoft 365.

O serviço do conector não está disponível

Se os rastreamentos estiverem falhando com um erro de conector indisponível na porta especificada, verifique o seguinte:

1. O conector está realmente sendo executado na porta especificada e não travou e não está preso.
2. A porta especificada no arquivo de configuração do mapa de portas está correta.
3. Se o arquivo de configuração do mapa de portas tiver sido editado, reinicie o GcaHostService.

Manipular erros de RPC

Se você vir algum erro de RPC durante a comunicação entre a plataforma do agente do conector do Microsoft Graph e o conector, poderá procurar os códigos de erro na página de códigos de status.

Se o código de erro for Desconhecido, provavelmente há uma exceção sem tratamento no código do conector. Certifique-se de enviar uma resposta com o status da operação de êxito/falha em todos os casos.

Localizando o arquivo de log do conector personalizado

Se você estiver usando o GraphConnectorsTemplate para desenvolver seu conector personalizado, a pasta AppData da conta de usuário atual será usada para armazenar logs por padrão. Você também pode fornecer um caminho absoluto para armazenar logs no arquivo ConnectorServer.cs do modelo. A conta de usuário deve ter acesso ao caminho absoluto que você forneceu.

A seguir estão os locais do caminho do log, dependendo do seu caso de uso:

• Conector não hospedado como um serviço do Windows:

  C:\Users\{User Account}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Conector hospedado como um serviço do Windows na conta SISTEMA LOCAL:

  C:\Windows\system32\config\systemprofile\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Conector hospedado como um serviço do Windows na conta virtual:

  C:\Windows\ServiceProfiles\{Network Service Name}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

• Conector hospedado como um serviço do Windows na conta SISTEMA LOCAL:

  C:\Windows\ServiceProfiles\LocalService\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log
  

Erros ao hospedar um conector como um serviço do Windows

O serviço falhou ao iniciar devido ao erro de acesso negado

Use as etapas a seguir para garantir que o caminho do executável esteja acessível para a conta LocalService.

1. Clique com o botão direito do mouse na pasta que contém o executável e escolha Propriedades.

2. Abra a guia Segurança e, em Nomes de grupo ou de usuário, escolha Editar.

3. Escolha Adicionar.

4. Insira 'LOCAL SERVICE' como o nome do objeto e escolha Verificar nomes.

   

5. Escolha OK em cada caixa de diálogo.

O serviço falha ao iniciar com nenhum erro

Se o serviço não for iniciado, Marque os logs de erro do visualizador de eventos. Abra o visualizador de eventos e vá para Aplicativo de logs > do Windows e Sistema de logs > do Windows.

Mais ajuda

Se precisar de mais ajuda para solucionar um problema, você pode levantar um problema ou iniciar uma discussão sobre tópicos relevantes por meio de nosso repositório GitHub.

Você também pode entrar em contato com a equipe de conectores do Copilot para obter mais ajuda e solução de problemas.

Conteúdo relacionado

• Práticas recomendadas