Collega Google Vertex AI a Microsoft Agent 365

Usa questa guida per collegare gli agenti AI di Google Vertex a Microsoft Agent 365.

Prima di iniziare

• Conferma che l'amministratore AI di Agent 365 possa creare connessioni nel interfaccia di amministrazione di Microsoft 365.
• Chiedi all'amministratore della piattaforma l'ID e la regione del progetto Google Cloud.
• Crea un account del servizio Google Cloud e una chiave JSON per quell'account.
• Usa il progetto e la regione in cui gli agenti sono dispiegati.

Creare l'account di servizio

Concedi all'account di servizio le autorizzazioni Vertex AI necessarie per l'individuazione e la gestione degli agenti:

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

La chiave JSON deve contenere l'intero documento della chiave del conto di servizio, inclusi i bracciali di apertura e chiusura. Non inserire solo il private_key valore.

Aggiungi permessi di osservabilità

Per raccogliere dati di osservabilità, assegnare allo stesso account di servizio questi ruoli:

Ruolo	ID del ruolo	Purpose
Visualizzatore dati BigQuery	roles/bigquery.dataViewer	Leggi le tabelle di traccia esportate
Utente del processo BigQuery	roles/bigquery.jobUser	Esegui query per recuperare gli intervalli
Visualizzatore di monitoraggio	roles/monitoring.viewer	Metriche di conteggio delle richieste e latenza di lettura
Utente di Cloud Trace	roles/cloudtrace.user	Leggi le zone di traccia della nuvola

Servono entrambi i ruoli di BigQuery. Data Viewer permette di leggere le tabelle, mentre Job User consente di eseguire le query che recuperano i risultati.

Configura la telemetria di Google Cloud

Sul progetto in cui hai schierato l'agente:

1. Abilita l'API Vertex AI.
2. Abilita l'API di BigQuery.
3. Abilita l'API Cloud Trace.
4. Abilita l'API di monitoraggio del cloud.
5. Abilita la raccolta telemetrica sull'agente schierato.
6. Abilita l'esportazione BigQuery di Trace Analytics.
7. Conferma che il trace_analytics_link set di dati e la sua _AllSpans vista esistano.

L'Agent 365 non può abilitare per te la raccolta dei dati di telemetria o l'esportazione delle tracce.

Creare la connessione

1. Apri l'interfaccia di amministrazione di Microsoft 365.
2. Seleziona agenti>Tutti gli agenti.
3. Nelle piattaforme connesse, seleziona Gestisci.
4. Seleziona + Collega una piattaforma e scegli Google Vertex AI.
5. Inserisci l'ID del progetto, la regione e la chiave JSON completa dell'account di servizio.
6. Convalidare le credenziali.
7. Salva la connessione.
8. Seleziona agenti di sincronizzazione.

Verificare la connessione

Conferma che gli agenti previsti siano importati. Una connessione può validare e importare agenti senza restituire telemetria se il progetto, la regione, i ruoli, le API o l'esportazione delle tracce non sono configurati correttamente.

Troubleshoot

Sintomo	Causa possibile	Resolution
Gli agenti vengono importati ma non viene visualizzata alcuna attività	L'osservabilità non è configurata	Completa i passaggi relativi a ruoli, API, telemetria ed esportazione delle tracce.
Nessuno span, ma sono presenti metriche	I ruoli BigQuery o l'esportazione di tracce mancano	Assegna entrambi i ruoli di BigQuery e abilita l'esportazione delle tracce.
Le query falliscono anche se le tabelle sono leggibili	roles/bigquery.jobUser è mancante	Assegna il ruolo BigQuery Job User all'account di servizio.
Nessuna metrica di conteggio richieste o latenza	Manca il ruolo di monitoraggio o l’API	Concedere Monitoring Viewer e abilitare Cloud Monitoring API.
_AllSpans non esiste	L'esportazione Trace Analytics BigQuery non è abilitata	Abilita l'esportazione e verifica il dataset e la visualizzazione.
Gli agenti vengono importati ma la telemetria è vuota	L'ambito della connessione non corrisponde all'ambito di distribuzione	Usa il progetto e la regione dell'agente dispiegato.

Per problemi di connessione che non sono specifici di Google Vertex AI, vedi Risoluzione problemi delle piattaforme connesse.