Resolver problemas com o SDK dos conectores Copilot

Este artigo descreve alguns dos problemas mais comuns com o SDK dos conectores Microsoft 365 Copilot e como resolvê-los.

Itens em falta no índice

Se os itens que existiam anteriormente estiverem em falta no índice, tal poderá dever-se à lógica de deteção de eliminação na plataforma. Os itens em falta numa resposta bem-sucedida em OperationStatus que já se encontram no índice serão removidos do índice.

Se o conector enviar respostas de falha transitórias e mais de 10% dos itens resultarem em falhas de pesquisa, os itens que não estão incluídos nas duas últimas pesquisas serão eliminados.

Processar alterações à porta do conector

Quando o conector precisar de ser executado numa porta diferente, tem de atualizar o ficheiro de configuração do mapa de portas com os novos valores. Quando edita o ficheiro de configuração do mapa de portas, tem de reiniciar o serviço GCA para que as alterações entrem em vigor. Para reiniciar o serviço, abra services.msc e reinicie o GcaHostService.

Falha de ligação após a atualização do GCA

Se notar falhas de ligação após atualizar a partir de uma versão GCA 1.8.0.0 ou inferior, siga os seguintes passos:

1. Abra o painel Controlo do GCA. Em Programas e funcionalidades, selecione Agente do conector do Graph na lista de programas e selecione Reparar.
2. Atualize a nova configuração do ficheiro de mapa de portas com as configurações anteriores.
3. Retomar quaisquer ligações falhadas de Centro de administração do Microsoft 365.

O serviço do conector está indisponível

Se as pesquisas estiverem a falhar com um conector indisponível no erro de porta especificado, verifique o seguinte:

1. O conector está, de facto, em execução na porta especificada e não falhou e não está bloqueado.
2. A porta especificada no ficheiro de configuração do mapa de portas está correta.
3. Se o ficheiro de configuração do mapa de portas tiver sido editado, certifique-se de que reinicia o GcaHostService.

Processar erros de RPC

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

Se o código de erro for Desconhecido, é provável que exista uma exceção não processada no código do conector. Certifique-se de que envia uma resposta com a operação de êxito/falha status em todos os casos.

Localizar o ficheiro de registo do conector personalizado

Se estiver a utilizar o GraphConnectorsTemplate para desenvolver o conector personalizado, a pasta AppData da conta de utilizador atual é utilizada para armazenar registos por predefinição. Também pode fornecer um caminho absoluto para armazenar registos no ficheiro ConnectorServer.cs do modelo. A conta de utilizador deve ter acesso ao caminho absoluto que forneceu.

Seguem-se as localizações do caminho de registo, consoante o seu caso de utilização:

• Conector não alojado como um serviço Windows:

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

• Conector alojado como um serviço Windows na conta DO SISTEMA LOCAL:

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

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

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

• Conector alojado como um serviço Windows na conta DO SISTEMA LOCAL:

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

Erros ao alojar um conector como um serviço Windows

Falha ao iniciar o serviço devido a um erro de acesso negado

Utilize os seguintes passos para se certificar de que o caminho do executável está acessível para a conta LocalService.

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

2. Abra o separador Segurança e, em Nomes de grupos ou utilizadores, selecione Editar.

3. Escolha Adicionar.

4. Introduza "SERVIÇO LOCAL" como o nome do objeto e selecione Verificar Nomes.

   

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

O serviço não inicia com qualquer erro

Se o serviço não iniciar, marcar os registos de erros do visualizador de eventos. Abra o visualizador de eventos e aceda a Registos do Windows Sistema de registos >>da Aplicação e do Windows.

Mais ajuda

Se precisar de mais ajuda para resolver um problema, pode levantar um problema ou iniciar um debate sobre tópicos relevantes através do nosso repositório do GitHub.

Também pode contactar a equipa de conectores copilot para obter mais ajuda e resolução de problemas.

Conteúdo relacionado

• Práticas recomendadas