Conecte o Google Vertex AI ao Microsoft Agent 365

Use este guia para conectar agentes do Google Vertex AI ao Microsoft Agent 365.

Antes de começar

  • Confirme se o administrador de IA do Agent 365 pode criar conexões no Centro de administração do Microsoft 365.
  • Pergunte ao administrador da plataforma o ID do projeto Google Cloud e a região.
  • Crie uma conta de serviço Google Cloud e uma chave JSON para essa conta.
  • Use o projeto e a região onde os agentes são implantados.

Criar a conta de serviço

Conceda à conta de serviço as permissões de IA Vertex necessárias para descoberta e gerenciamento de agentes:

aiplatform.reasoningEngines.list
aiplatform.reasoningEngines.get
aiplatform.reasoningEngines.delete

A chave JSON deve conter o documento completo da chave da conta de serviço, incluindo as chaves de abertura e fechamento. Não insira apenas o private_key valor.

Adicionar permissões de observabilidade

Para coletar dados de observabilidade, conceda estas funções à mesma conta de serviço:

Função ID da função Purpose
Visualizador de Dados do BigQuery roles/bigquery.dataViewer Leia tabelas de traços exportadas
Usuário do Trabalho do BigQuery roles/bigquery.jobUser Execute consultas para recuperar os intervalos
Visualizador de monitoramento roles/monitoring.viewer Métricas de contagem de requisições e latência de leitura
Usuário do Cloud Trace roles/cloudtrace.user Leia os spans do Cloud Trace

Você precisa das duas funções do BigQuery. O Data Viewer permite ler as tabelas, enquanto o Job User permite executar as consultas que recuperam os resultados.

Configurar a telemetria do Google Cloud

No projeto onde você implantou o agente:

  1. Ative a API Vertex AI.
  2. Ative a API do BigQuery.
  3. Ative a API Cloud Trace.
  4. Ative a API de Monitoramento da Nuvem.
  5. Ative a coleta de telemetria no agente implantado.
  6. Ative a exportação do Trace Analytics para o BigQuery.
  7. Confirme que o trace_analytics_link conjunto de dados e sua _AllSpans visão existem.

O Agent 365 não consegue ativar a coleta de telemetria ou a exportação de rastreamento para você.

Criar a conexão

  1. Abra o Centro de administração do Microsoft 365.
  2. Selecionar Agentes>Todos os Agentes.
  3. Nas plataformas conectadas, selecione Gerenciar.
  4. Selecione + Conecte uma plataforma e escolha Google Vertex AI.
  5. Insira o ID do projeto, a região e a chave JSON completa da conta de serviço.
  6. Valide as credenciais.
  7. Salve a conexão.
  8. Selecione Sincronizar agentes.

Verificar a conexão

Confirme que os agentes esperados são importados. Uma conexão pode validar e importar agentes sem retornar telemetria se o projeto, região, funções, APIs ou exportação de rastreamento não estiverem configurados corretamente.

Troubleshoot

Sintoma Causa provável Resolução
Agentes importam, mas nenhuma atividade aparece A observabilidade não está configurada Complete as etapas de funções, API, telemetria e rastreamento-exportação.
Sem abrangências, mas métricas aparecem Funções do BigQuery ou exportação de traços estão ausentes Conceda as duas funções do BigQuery e ative a exportação de rastreamentos.
Consultas falham embora as tabelas sejam legíveis roles/bigquery.jobUser está desaparecido Conceda o Usuário do Trabalho do BigQuery à conta do serviço.
Sem contagem de requisições ou métricas de latência A função de monitoramento ou a API está faltando Conceda o Visualizador de Monitoramento e ative a API de Monitoramento em Nuvem.
_AllSpans não existe A exportação do Trace Analytics no BigQuery não está ativada Ative a exportação e verifique o conjunto de dados e a visualização.
Os agentes são importados, mas a telemetria está vazia O escopo da conexão não corresponde ao escopo de implantação Use o projeto e a região do agente implantado.

Para problemas de conexão que não são específicos do Google Vertex AI, veja Solucionar problemas em plataformas conectadas.

  • Última atualização em