Agent 365 SDK Validierungscheckliste

Verwenden Sie diese Agent 365 SDK Validierungscheckliste, nachdem Sie einen Agenten integriert und bevor Sie ihn bereitstellen. Es ist der letzte Schritt im Onboarding-Weg: Agent 365 Skills oder manuelle Einrichtung setzt die Integration um. Diese Prüfungen helfen Ihnen, sicherzustellen, dass jede Fähigkeit funktioniert, damit Sie sie mit Sicherheit einsetzen können.

Wenn dein Coding-Assistant die interne Agent 365 Validate & Diagnose-Funktion anbietet, auch genannt a365-code-validator, kannst du ihn bitten, diese Agent 365-Integration für einen Code-Level Preflight zu validieren. Es überprüft das Projekt auf Instrumentelücken, Microsoft Entra-Artefakte, Messaging, Werkzeugzugriff und verwandte Konfigurationen. Verfügbarkeit und Invocation hängen vom Assistenten und dem Skills-Paket ab. Verwenden Sie die Checkliste, um die Ergebnisse in Ihrer Zielumgebung zu bestätigen. Der Validator ersetzt nicht End-to-End-Tests oder Plattformüberprüfungen.

Die Fähigkeitsabschnitte sind unabhängig, also überspringe alle Fähigkeiten, die du nicht übernommen hast. Die Abschnitte Verhalten, Konfiguration und Bereitstellung gelten für jede Integration.

Arbeiten Sie diese Checkliste durch, wenn Sie:

  • Ich habe einen Agenten an Bord genommen und möchte die Integration vor dem Einsatz bestätigen.
  • Du hast einem bereits integrierten Agenten eine Funktion hinzugefügt.
  • Ich habe einen Agenten von einem anderen Team übernommen und muss noch feststellen, was konfiguriert ist.

Verifizieren Sie bestehendes Verhalten

Das SDK erweitert deinen Agenten, daher sollte die Integration nicht ändern, wie der Agent bereits funktioniert.

  • Der Agent startet ohne neue Fehler.
  • Der Agent antwortet auf eine normale Anfrage wie vor der Integration.
  • Modellaufrufe, Ororchestration und Werkzeugausführung verhalten sich wie zuvor.

Note

Wenn sich das Kernverhalten geändert hat, untersuchen Sie es vor der Bereitstellung. Generierter Code, Abhängigkeitskonflikte, Konfiguration und SDK-Kompatibilität sind alles mögliche Ursachen. Informationen hierzu finden Sie unter Problembehandlung.

Identität überprüfen

  • Der Agenten-Identitätsblueprint ist bei Microsoft Entra registriert.
  • Eine Agentenidentität existiert, die aus diesem Bauplan erstellt wird. Die Fähigkeit make-a365-agent erzeugt sie auf dem Standard-Agentenpfad und make-ai-teammate auf dem KI-Teamkameraden-Pfad; siehe Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365.
  • Mindestens ein Sponsor wird zugewiesen.
  • Wenn der Agent ein Benutzerkonto benötigt, existiert dieses Konto und ist mit der Agentenidentität verknüpft.
  • Wenn der Agent ein Benutzerkonto hat, werden erforderliche Lizenzen zugewiesen und abhängige Ressourcen wie ein Postfach bereitgestellt.
  • API-Berechtigungen und Microsoft Graph-Scopes werden korrekt gewährt und scoped.
  • Der Agent authentifiziert sich und handelt unter der erwarteten Identität.

Important

Agenten mit eigenem Benutzerkonto stehen nur Mietern zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen. Überspringe die Benutzerkonto-Prüfungen, wenn dein Mieter nicht registriert ist.

Note

Nachdem Sie Lizenzen zugewiesen haben, ist die Ressourcenbereitstellung für ein Benutzerkonto typischerweise innerhalb von 10 bis 15 Minuten abgeschlossen, kann aber bis zu 24 Stunden dauern.

Observabilität überprüfen

  • Mindestens ein Nutzer im Tenant hat eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen. Ohne diese Lizenz wird die Telemetrie verworfen, obwohl die Aufnahme HTTP 200 zurückgibt.
  • Die Observabilitätspakete werden installiert und konfiguriert.
  • Eine Testanfrage erzeugt Spannen für Agentenaufruf, Werkzeugausführung und Inferenz.
  • Der Run hat eine gültige invoke_agent Spannweite an seiner Wurzel. Ohne eine bleiben die Spannweiten im Defender Advanced Hunting abfragbar, erreichen aber nicht die drei Oberflächen.
  • Telemetrie erscheint in Microsoft Defender, Microsoft Purview und im Microsoft 365 Admin Center.
  • Die Spannattribute entsprechen den erwarteten Operationen.

Werkzeuge überprüfen

Schließen Sie diesen Abschnitt aus, wenn der Agent die Server des Model Context Protocol (MCP) aufruft.

  • Eine Microsoft 365 Copilot-Lizenz ist im Mieter verfügbar. Work IQ MCP ist in der Vorschau und benötigt eines.
  • Der Agent entdeckt die MCP-Server, auf die er Zugriff haben sollte.
  • Eine Testwerkzeug-Aufrufung gelingt von Anfang zu Ende.
  • Die Agentenlaufzeit erkennt einen Werkzeugfehler, gibt einen kontrollierten Fehler zurück und bleibt verfügbar.

Benachrichtigungen überprüfen

Füllen Sie diesen Abschnitt aus, wenn der Agent eine Benachrichtigung erhält.

  • Der Agent erhält Benachrichtigungen von den konfigurierten Quellen wie Teams, Outlook, Word-Kommentaren oder E-Mails.
  • Der Agent reagiert wie vorgesehen auf eine Testbenachrichtigung.

Important

Benachrichtigungen erfordern das Benutzerkonto eines Agenten, das nur Mietern zur Verfügung steht, die am Frontier-Vorschauprogramm teilnehmen. Überspringen Sie diesen Abschnitt, wenn Ihr Mieter nicht eingeschrieben ist.

Überprüfen der Konfiguration

  • Speichere Zugangsdaten und Geheimnisse sicher und binde sie nicht zur Quellcode.
  • Getrennte Entwicklungs-, Test- und Produktionsumgebungen.
  • Stellen Sie sicher, dass die Integration in Ihrem Zielhost funktioniert.

Bestätigen Sie die Einsatzbereitschaft

  • Alle relevanten Prüfungen bestehen.
  • Führen Sie mindestens einen End-to-End-Test in einer nicht-produktionsfähigen Umgebung durch.
  • Überprüfen Sie die Telemetrie nach der Bereitstellung, um die Gesundheit des Agenten zu bestätigen.

Fehlgeschlagene Prüfungen lösen

Führe den entsprechenden Einrichtungsschritt erneut aus oder bitte deinen Codierassistenten, die spezifische Funktion auszuführen.

  • Identitätsprüfungen: siehe Agentenidentität.
  • Beobachtbarkeit, Werkzeuge und Benachrichtigungsprüfungen: Führen Sie die Matching-Fähigkeit aus Agent 365 Skills erneut aus.

Für häufige Symptome und deren Lösungen siehe Fehlerbehebung. Für Symptome, die speziell für das Skills-basierte Setup sind, siehe die Fehlerbehebungstabelle in Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365.

Für Antworten auf verwandte Fragen siehe häufig gestellte Fragen zum Agent 365 SDK.

Verwandte Inhalte

  • Last updated on