Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365

In diesem Quickstart verbindest du einen bestehenden Agenten mit Agent 365, indem du Agent 365 Skills in deinem Codierungsassistenten nutzt. Der Pfad beginnt mit der Registrierung des Agenten, fügt dann die von dir gewählten Fähigkeiten hinzu und endet mit der Validierung. Wenn du einen KI-Teamkollegen baust, der das Frontier-Vorschauprogramm benötigt, kannst du es auch lokal testen.

Jeder Schritt nennt die Fähigkeit, die sie behandelt, und zeigt eine Beispielanforderung an. Du rufst eine Fähigkeit auf, indem du das Ergebnis angibst, nicht indem du den Namen der Fähigkeit eingibst.

Voraussetzungen

  • Ein bestehender Agent auf einem unterstützten Stack: Python, Node.jsoder .NET.
  • Ein Microsoft-Tenant mit aktiviertem Agent 365. Melden Sie sich als globaler Administrator an oder als Agent-ID-Entwickler mit einem globalen Administrator, der die OAuth-Berechtigungen abschließen kann.
  • Ein Azure-Abonnement mit Berechtigung zur Erstellung von Ressourcen.
  • Ein unterstützter Coding-Assistent: Claude Code, GitHub Copilot CLI oder VS Code Agent-Modus.
  • Die GitHub-CLI (gh), mit der die Skills installiert wurden.

Die Lizenzierung hängt davon ab, welche Fähigkeiten du anwendest:

  • Identität: Keine zusätzliche Lizenz. Der Mieter muss Agent 365 aktiviert haben.
  • Observability. Mindestens ein Nutzer im Tenant mit einer Microsoft 365 E7- oder Microsoft Agent 365-Lizenz. Ohne sie wird die Telemetrie stillschweigend abgebrochen.
  • Werkzeugbildung (Arbeits-IQ). Eine Microsoft 365 Copilot-Lizenz. Work IQ MCP ist in der Vorschau.
  • Benachrichtigungen: Ein Benutzerkonto eines Agenten, nur für Mieter im Frontier-Vorschauprogramm verfügbar.

Tip

Bestätigen Sie zunächst, dass das SDK der richtige Integrationsmechanismus für Ihren Agenten ist. Siehe Wähle deine Integrationsoption. Für das Identitätsmodell hinter der Registrierung, einschließlich Blaupausen, Berechtigungen und Einwilligung, siehe Agent-Identität und Microsoft Entra-Agent-ID-Schlüsselkonzepte.

Installieren Sie die Fähigkeiten

Installiere die Fähigkeiten in deinem Programmierassistenten:

gh skill add microsoft/agent365-skills

Der gleiche Befehl funktioniert für Claude Code, GitHub Copilot CLI und VS Code Agent Mode. Starte deinen Assistenten danach neu, damit er die neuen Fähigkeiten aufnimmt.

Einrichten und Erkennen des Projekts

Öffne dein Agentenprojekt in deinem Coding-Assistenten und führe dann aus:

Fertigkeit: a365-setup

dieses Projekt für Agent 365 eingerichtet

Beantworte die Fragen zu deinem Agenten. Wenn die Fähigkeit abgeschlossen ist, validiert sie deine Voraussetzungen und erkennt deinen Stapel.

Die Einrichtung speichert generierte IDs und Endpunkte auf a365.generated.config.json. Die Standard-Agenteneinrichtung benötigt keine handgeschriebene Konfigurationsdatei; Die Einrichtung eines KI-Teamkollegen erfordert ein manuell erstelltes a365.config.json.

a365-setup Dann leitet es dich auf einen von zwei Provisioning-Pfaden. Schließen Sie die ausgewählte Stufe durch und fahren Sie dann mit den folgenden gemeinsamen Schritten fort:

Beide Wege setzen sich dann bei Instrument zur Beobachtbarkeit fort.

Registrieren des Agents

Erledige diesen Schritt, wenn a365-setup du auf den Standard-Agentenpfad weitergeleitet wirst.

Fertigkeit: make-a365-agent

Registrieren Sie diesen Agenten bei Agent 365

Wenn die Skill abgeschlossen ist, hat dein Agent einen registrierten Blueprint in Microsoft Entra, eine daraus erstellte Agentenidentität und die benötigten Berechtigungen. Die Registrierung sorgt für Sichtbarkeit im Katalog; Der Beobachtbarkeitsschritt fügt Telemetrie hinzu.

Nachrichten und Benachrichtigungen hinzufügen

Mach diesen Schritt fertig, wenn a365-setup du auf den KI-Teamkameradenpfad gehst.

Fertigkeit: make-ai-teammate

Fügen Sie diesem Agenten Nachrichten und Benachrichtigungen hinzu

Die Skill fügt die Hosting-Ebene und das Nachrichtenrouting hinzu und registriert den Agenten. Die Nutzer können sie dann über Teams, Outlook, Word-Kommentare und E-Mails erreichen.

Important

Dieser Schritt gibt Ihrem Agenten ein eigenes Benutzerkonto, einschließlich einer Mailbox- und Teams-Präsenz. Diese Funktion steht nur Mietern zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen. Überspringen Sie diesen Schritt, wenn Ihr Mieter nicht eingeschrieben ist.

Instrument zur Beobachtbarkeit

Erledige diesen Schritt auf einem der beiden Pfade. Die Fähigkeit fragt, welche Art von Agent du hast.

Fertigkeit: instrument-observability

Verleihen Sie diesem Agenten Beobachtbarkeit

Wenn Sie aufgefordert werden, wählen Sie den Authentifizierungsmodus, den Ihr Agent verwendet: OBO (im Namen eines angemeldeten Benutzers), Agentic-User (das eigene Benutzerkonto des Agenten, das das Frontier-Vorschauprogramm benötigt) oder S2S (Service-to-Service, für Hintergrundoperationen). Der Exporteur verwendet denselben Modus, mit dem sich Ihr Agent authentifiziert, wählen Sie also den Modus, der zu Ihrem Berechtigungsmodell passt. Siehe Agentenidentität.

Nach einem Testlauf erscheinen die Spannweiten Ihres Agenten in Microsoft Defender, Microsoft Purview und im Microsoft 365 Admin Center.

Important

Zwei Dinge können Telemetrie so aussehen lassen, als wäre sie verschwunden, obwohl die Anfrage HTTP 200 zurückgibt. Wenn kein Nutzer im Tenant eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen hat, wird die gesamte Anfrage abgebrochen; die vorhandene SKU reicht nicht aus. Wenn der Lauf keine gültige invoke_agent Spannweite an seiner Wurzel hat, bleiben die Spans in Defender Advanced Hunting abfragbar, erscheinen aber auf keiner der drei Oberflächen. Die Root Span ist die oberste Ebene, die das SDK für einen Agentenaufruf aussendet; Jeder Werkzeugaufruf und jedes Inferenzereignis ist darin eingebettet.

Microsoft 365-Daten verbinden

Führen Sie diesen Schritt auf einem der beiden Pfade ab, wenn Ihr Agent Microsoft 365-Daten liest oder darauf reagiert. Work IQ Tooling erfordert ein delegiertes Berechtigungsmodell, daher wird dieser Schritt automatisch übersprungen, wenn man im Observability-Schritt S2S wählt.

Fertigkeit: add-workiq-tools

Verdrahte Arbeits-IQ-Mail und Kalender

Nenne die Arbeitslasten, die du brauchst, wie Mail, Kalender oder Word. Die Fähigkeit verbindet die passenden Work IQ MCP-Server, und dein Agent kann diese Daten dann unter Admin-Kontrolle erreichen.

Important

Work IQ MCP ist in der Vorschau und erfordert eine Microsoft 365 Copilot-Lizenz. Ein globaler Administrator muss den OAuth-Berechtigungen für die Work IQ-Server erteilen, bevor Ihr Agent sie aufrufen kann. Siehe Werkzeuge hinzufügen und verwalten.

Lokales Testen

Erledigen Sie diesen Schritt, wenn Sie auf dem KI-Teamkameradenpfad sind, der das Frontier-Vorschauprogramm erfordert. Agents Playground verbindet sich über den Agent-Messaging-Endpunkt, daher gilt das nicht für Standardagenten.

Fertigkeit: test-local

Testen Sie dieses Mittel lokal

Dein Agent läuft gegen Agents Playground, ein lokales Testgeschirr, sodass du es vor dem Einsatz mit Rauchtest testen kannst.

Validiere das Ergebnis

Ihr Agent sollte so beginnen und reagieren, wie er es vor dem Onboarding getan hat, und in Agent 365 unter seiner registrierten Identität erscheinen.

Wenn Ihr Coding-Assistant die interne Agent 365 Validate & Diagnose-Funktion bereitstellt, bitten Sie ihn, diese Agent 365-Integration zu validieren , um den Code-Level Preflight gegen das Projekt auszuführen. Es prüft Lücken in der Instrumentierung, Microsoft Entra-Artefakte, Messaging, Werkzeugzugriff und verwandte Konfigurationen. Die Fähigkeit wird intern auch als a365-code-validator; Verfügbarkeit und genaues Routing hängen vom programmierten Programmierassistenten und dem installierten Skills-Paket ab.

Bevor du deployest, arbeite die Validierungscheckliste des Agent 365 SDK durch.

Troubleshoot

Verwenden Sie die folgende Tabelle, um häufige Probleme zu identifizieren und zu lösen, wenn Sie Ihren Agenten mit Agent 365 verbinden.

Symptom Resolution
Der Programmierassistent beschreibt Befehle, führt sie aber nicht aus Verwenden Sie einen Modus mit Terminalzugriff. Im VS Code nutze den Agentenmodus. Fragen- und Bearbeiten-Modi können keine Terminalbefehle ausführen.
Setup reports missing Azure prerequisites Erfülle die aufgelisteten a365-setup Voraussetzungen und führe die Fertigkeit dann noch einmal durch.
Die Blueprint-Registrierung schlägt fehl, oder CLI-Befehle führen zu Autorisierungsfehlern Bestätigen Sie, dass Sie mit einem Konto angemeldet sind, das die Berechtigung hat, Agenten-Identitätspläne im Mieter zu registrieren.
Keine Telemetrie erscheint Bestätigen Sie, dass mindestens ein Benutzer im Tenant eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen hat, dann bestätigen Sie, dass der Lauf eine gültige invoke_agent Spann an seiner Wurzel ausgibt, und dann bestätigen Sie, dass der gewählte Authentifizierungsmodus mit Ihrer Umgebung übereinstimmt. Bitten Sie Ihren Codierassistenten, die Agent 365-Integration zu validieren; Die installierte Validator-Fähigkeit kann die Instrumentierung diagnostizieren.
Ein Schritt sieht aus, als wäre er übersprungen worden Skills sind staatesbewusst und überspringen bereits verdrahtete Arbeiten, daher ist der Schritt wahrscheinlich schon abgeschlossen. Führe die jeweilige Fähigkeit erneut aus und erkläre das Ergebnis explizit.
Konfigurationswerte müssen nach der Einrichtung geändert werden Wenn dein Setup verwendet a365.config.json, bearbeite es und starte a365 config init -c ./a365.config.jsones erneut, dann spiele die entsprechende Fähigkeit erneut.

Verwandte Inhalte

  • Last updated on