Verbinden Sie Google Vertex AI mit Microsoft Agent 365

Nutzen Sie diesen Leitfaden, um Google Vertex KI-Agenten mit Microsoft Agent 365 zu verbinden.

Bevor Sie anfangen

  • Bestätigen Sie, dass der Agent 365 KI-Administrator Verbindungen im Microsoft 365 Admin Center herstellen kann.
  • Fragen Sie den Plattformadministrator nach der Google Cloud-Projekt-ID und Region.
  • Erstelle ein Google-Cloud-Servicekonto und einen JSON-Schlüssel für dieses Konto.
  • Verwenden Sie das Projekt und die Region, in der die Agenten eingesetzt werden.

Erstellen des Dienstkontos

Gewähren Sie dem Dienstkonto die für die Agentenentdeckung und -verwaltung erforderlichen Vertex-AI-Berechtigungen:

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

Der JSON-Schlüssel muss das vollständige Dienstkontoschlüssel-Dokument enthalten, einschließlich der öffnenden und schließenden geschweiften Klammern. Gib nicht nur den Wert private_key ein.

Hinzufügen von Observabilitätsberechtigungen

Um Observabilitätsdaten zu sammeln, gewähren Sie demselben Service-Konto folgende Rollen:

Role Rollen-ID Purpose
BigQuery Data Viewer roles/bigquery.dataViewer Exportierte Trace-Tabellen lesen
BigQuery-Auftragsbenutzer roles/bigquery.jobUser Führe Abfragen aus, um Spans abzurufen
Überwachungsviewer roles/monitoring.viewer Metriken für die Anzahl von Leseanforderungen und die Latenz
Cloud Trace-Nutzer roles/cloudtrace.user Lesen Sie Cloud Trace-Spannweiten

Du brauchst beide BigQuery-Rollen. Data Viewer ermöglicht das Lesen von Tabellen, während Job User das Ausführen von Abfragen ermöglicht, die Ergebnisse abrufen.

Google Cloud-Telemetrie konfigurieren

Zum Projekt, bei dem du den Agenten eingesetzt hast:

  1. Aktivieren Sie die Vertex AI API.
  2. Aktivieren Sie die BigQuery-API.
  3. Aktivieren Sie die Cloud Trace API.
  4. Aktivieren Sie die Cloud-Monitoring-API.
  5. Aktivieren Sie die Telemetriesammlung beim eingesetzten Agenten.
  6. Aktivieren Sie den Export von Trace Analytics BigQuery.
  7. Bestätigen Sie, dass der trace_analytics_link Datensatz und seine Ansicht _AllSpans existieren.

Agent 365 kann die Telemetrieerfassung oder den Trace-Export für Sie nicht aktivieren.

Erstellen der Verbindung

  1. Öffnen Sie das Microsoft 365 Admin Center.
  2. Auswählen Agenten>Alle Agenten.
  3. Wählen Sie unter Connected Platforms"Verwalten" aus.
  4. Wählen Sie + Plattform verbinden aus und dann Google Vertex AI.
  5. Geben Sie den JSON-Schlüssel für Projekt-ID, Region und vollständiges Servicekonto ein.
  6. Validieren Sie die Anmeldedaten.
  7. Speichern Sie die Verbindung.
  8. Wählen Sie Synchronisierungs-Agents.

Die Verbindung prüfen

Bestätigen Sie, dass die erwarteten Agenten importiert wurden. Eine Verbindung kann Agenten validieren und importieren, ohne Telemetrie zurückzugeben, wenn Projekt, Region, Rollen, APIs oder Trace-Export nicht korrekt konfiguriert sind.

Troubleshoot

Symptom Wahrscheinliche Ursache Resolution
Agents importieren, aber keine Aktivität erscheint Observabilität ist nicht konfiguriert Erledigen Sie die Rollen-, API-, Telemetrie- und Trace-Export-Schritte.
Keine Spannweiten, aber Metriken erscheinen BigQuery-Rollen oder Trace-Export fehlen Erteile beide BigQuery-Rollen und aktiviere den Trace-Export.
Abfragen scheitern, obwohl Tabellen lesbar sind roles/bigquery.jobUser fehlt Dem Dienstkonto die Rolle „BigQuery Job User“ gewähren.
Keine Anfrageanzahl- oder Latenzmetriken Überwachungsrolle oder die API fehlt Weisen Sie die Rolle „Monitoring Viewer“ zu und aktivieren Sie die Cloud Monitoring API.
_AllSpans existiert nicht Der Export von Trace Analytics BigQuery ist nicht aktiviert Aktivieren Sie den Export und überprüfen Sie den Datensatz und die Ansicht.
Agenten importieren, aber die Telemetrie ist leer Der Verbindungsbereich entspricht nicht dem Bereitstellungsbereich Verwenden Sie das Projekt und die Region des eingesetzten Agenten.

Für Verbindungsprobleme, die nicht spezifisch für Google Vertex AI sind, siehe Troubleshoot connected platforms.

  • Zuletzt aktualisiert um