Erste Schritte mit der Agent 365-Entwicklung

Agent 365 arbeitet mit einer Reihe von Agentimplementierungen zusammen. Ein Agent kann Benutzer bei Bedarf unterstützen, autonom im Hintergrund ausgeführt werden oder mit seiner eigenen Benutzeridentität in Microsoft 365 arbeiten. Es ist wichtig, zu verstehen, welches Muster Ihr Agent am besten beschreibt, da es das Identitätsmodell des Agents bestimmt, welchen Zugriff es auf Microsoft 365 Ressourcen hat und welche Lebenszyklusschritte gelten.

Arten von Agents

Bevor Sie beginnen, fragen Sie sich: Welche Art von Agent baue ich?

Je nach Art des Zugriffs gibt es zwei Arten von Agents:

Agenttyp Übersicht
Agenten Arbeiten Sie im Auftrag eines Benutzers mit delegiertem Zugriff oder arbeiten Sie als Anwendung mit bereichsbezogenen Berechtigungen. Registriert als Microsoft Entra Applikationen oder Agent-Identitätsvorlagen.
KI-Teamkollege Arbeiten Sie mit ihrer eigenen Benutzeridentität in Microsoft 365, einschließlich Postfach, Teams-Anwesenheit und Verzeichniseintrag. Dieser Agenttyp ist nur für Mandanten verfügbar, die am Frontier Preview-Programm teilnehmen.

Agenten

Ein Agent arbeitet im Auftrag eines Benutzers. Er antwortet auf Anforderungen, führt Aufgaben im Hintergrund aus, stellt eine Verbindung mit APIs, verarbeitet Daten und Steuert Aktionen.

Agenten gibt es in allen Formen und Größen. Einige sind konversationell – ein Benutzer fragt etwas, und der Agent antwortet. Einige laufen ruhig im Hintergrund - ausgelöst durch einen Zeitplan, ein Ereignis oder eine eingehende Nachricht - ohne dass jemand aktiv beteiligt ist. Einige tun beides.

Beispielszenarien:

  • Ein Benutzer fordert einen Agent auf, seine ungelesenen E-Mails und Antworten zusammenzufassen. Der Agent erledigt die Arbeit, greift nur auf Ressourcen zu, auf die der Benutzer zugreifen kann, und übergibt das Ergebnis zurück.
  • Ein Kundendienstmitarbeiter hilft einem Supporttechniker, interne Wissensbasen zu abfragen und Antworten während einer Live-Supportsitzung zu verfassen.
  • Ein Compliance-Überwachungsagent wird jede Nacht ausgeführt, scannt SharePoint-Sites, auf die dem Agenten zum Zweck der Überprüfung auf Richtlinienverstöße Zugriff gewährt wird, und erstellt Überwachungsberichte - ohne dass jemand zuschaut.
  • Ein Auftragsverarbeitungsmitarbeiter holt neue Verkaufsaufträge aus einer Warteschlange ab, aktualisiert ein CRM und sendet Bestätigungs-E-Mails – alle, ohne dass jemand sie startet.

Identitätsbasis:

Traditionell registrieren Sie Agents als Microsoft Entra Anwendungen. Dieser Ansatz funktioniert weiterhin. In Zukunft können Sie auch Agents auf einer Microsoft Entra-Agent-ID über eine agent Identity Blueprint erstellen – die it-genehmigte, durch die Governance erzwungene Definition der Funktionen eines Agents, den erlaubten Toolzugriff und Complianceeinschränkungen. Das Erstellen eines Blueprints ist der empfohlene Pfad für neue Agents. Es entsperrt den verwalteten Work IQ-Toolzugriff, Microsoft Purview Datenschutz, Microsoft Defender Bedrohungsüberwachung und Entra ID-Governance – macht Ihren Agenten von Tag 1 an zu einer vollständig verwalteten Unternehmensidentität.

KI-Teamkollegen

Important

Um frühzeitig zugriff auf diese Art von Agent zu erhalten, müssen Sie Teil des Frontier Preview-Programms sein. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauen unterliegen den bestehenden Vorschaubedingungen Ihrer Kundenverträge. Da sich diese Features noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Funktionen im Laufe der Zeit ändern.

Ein KI-Teamkollege arbeitet in Microsoft 365 mit seiner eigenen Agent-Identität. Sie können sie mit Funktionen wie dem Senden und Empfangen von E-Mails über ein eigenes Postfach, die Teilnahme an Teams 1:1- und Gruppenunterhaltungen und das Anzeigen in Verzeichnis- und Organisationsmetadaten mit einer zugewiesenen Managerbeziehung bereitstellen. Personen können damit über vertraute Microsoft 365 Einstiegspunkte wie @mentions, E-Mail, Kalendereinladungen und Teams-Chat interagieren.

Erstellen Sie diese Agents aus einem Agent-Blueprint, bei dem es sich um die von der IT genehmigten, von der Governance erzwungene Definition der Funktionen des Agents, den zulässigen Toolzugriff und Complianceeinschränkungen handelt. Jede Agentinstanz erbt das Identitätsmodell, die Berechtigungen und Richtlinien von seinem übergeordneten Agentidentitäts-Blueprint.

Was der Agent tut – ob es konversationell, im Hintergrund oder beides ist – hängt davon ab, wie Sie ihn entwerfen. Einige Agents sind hochgradig interaktiv, reagieren auf Nachrichten und unterstützen die Arbeit in Echtzeit. Andere verarbeiten Aufgaben im Hintergrund, die auf E-Mails oder Ereignisse ohne direkte Benutzerbindung reagieren. Der Agent arbeitet mit seiner eigenen Benutzeridentität, und seine Aktionen werden durch diese Identität gesteuert und überwacht.

Wenn Sie bereits über einen Agenten verfügen, müssen Sie nicht von vorn beginnen. Sie können vorhandene Agents erweitern, um mit ihrer eigenen Identität zu arbeiten, indem Sie die weiter unten in diesem Handbuch beschriebene Identitäts- und Blueprintkonfiguration hinzufügen.

Beispielszenarien:

  • Fügen Sie einen KI-Teamkollegen für das Personal-Onboarding zu einem Teams-Onboarding-Kanal eines neuen Mitarbeiters hinzu. Sie sendet Willkommens-E-Mails aus einem eigenen Postfach, plant Orientierungsbesprechungen in seinem eigenen Kalender und antwortet auf Fragen, indem die für diese Agentinstanz konfigurierten Funktionen verwendet werden.
  • Weisen Sie einem KI-Teamkollegen für die Beschaffung eine Managerrolle in den Verzeichnis-Metadaten zu. Mitarbeiter senden E-Mail-Kaufanforderungen an ihr Postfach. Der Agent verarbeitet die Anforderung, fragt ERP- und Finanzsysteme mithilfe seines geregelten Work IQ-Tools-Zugriffs ab und reagiert mit Genehmigung oder Eskalation aus seiner eigenen Identität.
  • Fügen Sie einen Forschungs-KI-Teamkollegen zur SharePoint Website und dem Teams-Kanal eines Projektteams hinzu. Sie kann relevante Dokumente während Besprechungen anzeigen, in Unterhaltungsthreads antworten und wöchentliche Statusberichte erstellen, indem sie die für diesen Agent konfigurierten Berechtigungen und Tools verwenden.

Identitätsbasis:

Basiert auf einem Agent-Identitäts-Blueprint, der ein Microsoft Entra-Agent-ID und zugeordnetes Benutzerkonto erstellt: immer erforderlich.

Inkrementelles Hinzufügen von Agent 365-Funktionen

Agent 365 ist nicht alles oder nichts. Sie müssen keinen KI-Teamkollegen am ersten Tag erstellen – oder überhaupt, wenn Ihr Szenario dies nicht erfordert. Übernehmen Sie Funktionen inkrementell, beginnend mit dem, was Ihr Agent jetzt benötigt, und erweitern Sie sich, sobald Ihre Anforderungen weiterentwickelt werden.

Warum auf einem Agent-Identitäts-Blueprint aufbauen?

Wenn Sie einen Agent-Identitäts-Blueprint erstellen, stellt die Agent 365 CLI eine Microsoft Entra-Agent-ID für Ihren Agent bereit – eine erstklassige Identität in Ihrem Mandanten, vorbehaltlich der gleichen Unternehmensgovernancerichtlinien wie menschliche Benutzer. Diese einzelne Identität ist die Grundlage für die Sicherheitsvorteile, die automatisch zu jedem Blueprint-basierten Agenten fließen:

Nutzen Was dies für Ihren Agenten bedeutet
Microsoft Entra ID Governance Der Identitäts- und Zugriffslebenszyklus des Agents wird über denselben bedingten Zugriff, Identitätsschutz und Zugriffsüberprüfungen verwaltet, die für menschliche Benutzer gelten.
Microsoft Purview Jede vom Agent ausgeführte Dateninteraktion unterliegt den Vertraulichkeitsbezeichnungen, DLP-Richtlinien und Aufbewahrungsrichtlinien Ihres Mandanten – automatisch ohne zusätzlichen Code.
Microsoft Defender Das Agentverhalten wird kontinuierlich auf Anomalien und Bedrohungen überwacht. Verdächtige Aktivitäten lösen die gleichen Warnungs- und Antwortworkflows wie für jeden Benutzer im Mandanten aus.

Diese Vorteile gelten für alle Blueprint-basierten Agents, einschließlich agents mit benutzerdelegiertem Zugriff und Agents, die mit ihrer eigenen Identität arbeiten, sobald der Blueprint erstellt wird. Sie müssen sie nicht separat konfigurieren.

Die vier unten aufgeführten Capabilty-Stufen stellen Ebenen dar, die Sie inkrementell übernehmen können. Die folgende Tabelle zeigt, was für Agent 365 basierend auf Ihrem Ausgangspunkt verfügbar ist:

Fähigkeit Microsoft 365 benutzerdefinierter Engine-Agent Alle anderen Agenten 1
Registrieren • 2 ✓
Beobachtbarkeit ✓ ✓
Work IQ ✓ ✓
KI-Teamkollege • 3 • 3

1 Agents, die derzeit als Microsoft Entra Anwendungen registriert sind, müssen zuerst einen agent Identity Blueprint erstellen, um mit allen Funktionen in dieser Spalte zu beginnen.

2 Microsoft 365 benutzerdefinierte Engine-Agents sind bereits mit ihrer vorhandenen Microsoft Entra Anwendungsregistrierung registriert – kein zusätzlicher Aufwand erforderlich.

3 KI-Teamkollege für benutzerdefinierte Microsoft 365-Agenten erfordert einen Identitätsvorlage für Agenten. Nur für Frontier-Programmteilnehmer verfügbar.

Registrierung

Wenn Sie Ihren Agent registrieren, machen Sie ihn im Microsoft 365 Admin Center sichtbar und verwaltbar. Administratoren können sie ermitteln und im Agentbestand ihrer Organisation sehen.

Was Sie erhalten:

  • Ihr Agent wird im Microsoft 365 Admin Center angezeigt. Administratoren können ihn finden und im Agentbestand ihrer Organisation sehen.
  • Blueprint-basierte Agenten erhalten auch die vollständigen Vorteile von Entra ID-Governance, Purview und Defender, die in Why build on an Agent Identity Blueprint? beschrieben sind.

Was Sie erstellen:

Registrieren Sie Ihren Agent mithilfe Ihrer vorhandenen Microsoft Entra Anwendungsregistrierung oder eines Blueprints.

Note

Wenn Sie Ihre Agenten auf Google Vertex AI oder Amazon Bedrock aufbauen, erfordert die Registrierung keine Entwicklungsarbeit. Die Google- und Amazon-APIs rufen automatisch Agenten ab. Es sind keine SDK-Integration, kein Blueprint und keine Codeänderungen erforderlich. Nach der Registrierung können Sie das Agent 365 SDK verwenden, um Observability, Work IQ Tool-Zugriff und andere Funktionen inkrementell hinzuzufügen. Informationen zu den ersten Schritten finden Sie unter Registrieren von Google Vertex AI und Amazon Bedrock Agents.

So erstellen Sie es:

Verwenden Sie das KI-geführte Setup und beantworten Sie entsprechend die Fragen des Agententyps. Das KI-geführte Setup führt die erforderlichen Schritte für diese Stufe aus. Microsoft 365 benutzerdefinierte Engine-Agents sind bereits heute mithilfe ihrer vorhandenen Microsoft Entra Anwendungsregistrierung auffindbar.

Beobachtbarkeit

Nachdem Sie Ihren Agenten registriert haben, investieren Sie in Beobachtbarkeit. Diese Investition bietet IT- und Sicherheitsteams sowie Ihrem Engineering-Team Einblicke in die Aktivitäten Ihres Agenten. Jeder Rückschlussaufruf, jeder Toolaufruf und jede Interaktion werden erfasst, nachverfolgt und überwacht.

Observability ist die Grundlage für Vertrauen. Ohne dies haben Administratoren keine Möglichkeit, Das Verhalten, die Compliance zu überwachen oder Probleme im großen Maßstab zu diagnostizieren. Damit wird Ihr Agent zu einem Unternehmenswert und nicht zu einer Black Box.

Note

Wenn Ihr Agent ein Super-Agent ist – was bedeutet, dass er intern einen oder mehrere Unter-Agents aufruft, um eine Aufgabe abzuschließen – können diese Sub-Agent-Anrufe auch in der Observability-Pipeline protokolliert werden. Protokollieren Sie sie als Toolanruf oder als Agent-zu-Agent-Anruf (A2A), sodass die vollständige Delegierungskette sichtbar und auditierbar ist.

Was Sie erhalten:

  • Vollständiges Tracking basierend auf [OpenTelemetry (OTel) (OTel)] (https://opentelemetry.io/docs/specs/otel/protocol/) jeder Interaktion eines Agenten: Eingaben, Ausgaben, Toolaufrufe und Modellaufrufe.
  • Aktivitäten, die in den Microsoft 365 Admin Center und verbundenen Überwachungsoberflächen sichtbar sind.
  • Überwachungspfade, die in Microsoft Entra-, Microsoft Purview- und Microsoft Defender eingespeist werden, unterstützen Compliance-, Datenschutz- und Bedrohungsreaktionsanforderungen.

Was Sie erstellen:

Instrumentierung mithilfe der Agent 365 SDK-Observability-APIs: entweder automatische Instrumentierung (wenn Sie OpenAI, LangChain oder Agent Framework verwenden) oder manuelle Instrumentierung für einen anderen Stapel.

So erstellen Sie es:

Verwenden Sie die KI-geführte Einrichtung , und beantworten Sie die Observability-Fragen entsprechend. Das KI-geführte Setup führt die erforderlichen Schritte für diese Funktion aus.

Arbeit IQ

Nachdem Sie sich registriert und Ihr Agent feststellbar machen, gewähren Sie ihm Zugriff auf Microsoft 365 Daten und Aktionen über Work IQ. Work IQ ist ein bestimmter Satz von Tools, mit denen Ihr Agent mit Mail, Kalender, OneDrive, SharePoint, Teams und mehr arbeiten kann.

Work-IQ-Tools erfordern die Zustimmung des Administrators, werden überwacht und sind widerrufbar. Ihr Agent ruft sie mithilfe der in seinem Blueprint definierten Berechtigungen auf – keine zusätzlichen OAuth-Flüsse oder benutzerdefinierten Connectors erforderlich.

Was Sie erhalten:

  • Zugriff auf den vollständigen Work IQ-Toolkatalog – Mail, Kalender, OneDrive, SharePoint, Teams und mehr.
  • Berechtigungen, die Administratoren steuern und präzise auf die Bedürfnisse Ihres Agenten zuschneiden.
  • Jeder Toolaufruf wird über die Observability-Pipeline nachverfolgt und auditierbar gemacht.

Was Sie erstellen:

Agentcode, der Work IQ-Tools mithilfe der Agent 365 SDK-Toolerstellungs-APIs aufruft.

So erstellen Sie es:

Verwenden Sie die Agent 365 SDK-Tool-APIs , um Arbeits-IQ-Toolaufrufe manuell zu Ihrem Agentcode hinzuzufügen. Das KI-gestützte Setup unterstützt diese Funktion derzeit nicht.

KI-Teamkollegen

AI-Teamkollegen stehen den Teilnehmern des Frontier-Programms zur Verfügung.

In der letzten Phase kann Ihr Agent in Microsoft 365 mit seiner eigenen Identität arbeiten. Je nach Konfiguration kann es eine Postfach-, Teams-Anwesenheits-, Verzeichniseintrags- und Managerbeziehung haben. Benutzer können damit über vertraute Microsoft 365 Erfahrungen wie E-Mail, Chat, Besprechungen und App-Oberflächen interagieren.

Note

Identitäts- und Berechtigungsmodellverschiebung

Der Wechsel zu einem KI-Teamkollegen stellt eine grundlegende Änderung des Zugriffs auf Ressourcen ihres Agenten dar. Ihr vorhandener Agent verwendet möglicherweise delegierten Benutzerzugriff, bei dem der Agent für einen angemeldeten Benutzer fungiert und nur auf die Ressourcen zugreifen kann, auf die der Benutzer zugreifen kann, oder Anwendungsberechtigungen, die auf einen Dienstprinzipal festgelegt sind. Ein Agent mit einer Benutzeridentität erbt den Zugriff eines aufrufenden Benutzers zur Laufzeit nicht. Stattdessen wird es unter einem eigenen Benutzerkonto mit eigenen Zugriffserteilungen, Governancerichtlinien und einem eigenen Audit-Trail betrieben.

Diese Änderung bedeutet:

  • Bei delegiertem Benutzerzugriff handelt der Agent im Namen des angemeldeten Benutzers und ist auf den Zugriff dieses Benutzers beschränkt. Mit der eigenen Identität eines Agents gewähren Sie Zugriff auf Microsoft 365 Ressourcen wie Postfach, Kalender, Teams und SharePoint direkt an die Agentidentität.
  • Sie steuern und überwachen Berechtigungen, die der Agentidentität als eigener Zugriff des Agents gewährt wurden. Sie sind nicht mit benutzerdelegierten Berechtigungen identisch, die vom aufrufenden Benutzer übergeben werden.
  • Wenn Ihre aktuelle Implementierung von delegierten Benutzerzugriffs- oder Anwendungsberechtigungen abhängt, überprüfen und erneut festlegen Sie diese Berechtigungen für die Agentidentität, bevor Sie diese Funktion aktivieren.

Was Sie erhalten:

  • Alles von Auffindbarkeit, Beobachtbarkeit und Work IQ.
  • Eine Agentennutzer-Konto mit eigenem Postfach – Personen können es direkt per E-Mail kontaktieren und es kann E-Mails von seiner eigenen Adresse senden.
  • Eine Präsenz in allen Microsoft 365 Apps – Personen können mit ihm chatten, es hinzufügen, es zu Kanälen hinzufügen und es zu Besprechungen in Teams einladen; sowie direkt in Word, Excel, PowerPoint und anderen M365-Anwendungen interagieren.
  • Ein Organigrammeintrag unter einem bestimmten Vorgesetzten sorgt dafür, dass der Mitarbeiter im Verzeichnis der Organisation angezeigt wird.
  • Vom Administrator kontrollierter Lebenszyklus – der Agent wird über die Microsoft 365 Admin Center erstellt, verwaltet und eingestellt, wobei die vollständige Governance über jede Instanz erfolgt.

Was Sie erstellen:

Alle Funktionen sowie die Instanz-Erstellung und (optional) Marketplace-Veröffentlichungen.

So erstellen Sie es:

Verwenden Sie das KI-geführte Setup , und beantworten Sie die FRAGEN der KI-Teamkollegen entsprechend. Das KI-geführte Setup führt die erforderlichen Schritte für diese Stufe aus.

KI-gesteuerte Einrichtung

Verwenden Sie einen KI-Codierungs-Agent, um die Einrichtung und Konfiguration Ihres Agents für Agent 365 zu automatisieren. Das KI-geführte Setup führt Sie durch die erforderlichen Überprüfungen, Konfigurationsschritte und Codeintegration, um Funktionen wie Registrierung, Observability, Work IQ-Toolzugriff und KI-Teamkollegenfunktionen zu ermöglichen.

Voraussetzungen für KI-geführtes Setup

Bevor Sie beginnen, stellen Sie sicher, dass Sie über die folgenden Elemente verfügen:

Anforderung Einzelheiten
KI-Codierungs-Agent Visual Studio Code mit GitHub Copilot und GitHub Copilot Chat Erweiterungen oder einem anderen KI-Codierungs-Agent mit Terminalzugriff
Agenten-Code Ein Arbeitsagentprojekt in Python, Node.jsoder .NET. Wenn Sie kein Beispiel haben, beginnen Sie mit einem Schnellstartbeispiel.
Entra-Rolle Globaler Administrator – führt alle Schritte einschließlich OAuth2-Berechtigungserteilungen aus. Agent-ID-Entwickler – führt alle Schritte mit Ausnahme von OAuth2-Berechtigungserteilungen aus; das Setup generiert eine Übergabe für einen globalen Administrator.

KI-geführte Einrichtungsschritte

Diese Schritte gelten unabhängig davon, ob Sie einen einzelnen Agent oder eine Agent-Factory aktivieren. Der KI-Agent sucht automatisch nach erforderlichen Tools und verarbeitet Installation, Authentifizierung und Validierung automatisch.

Öffnen Sie Ihr Agentprojekt, und kopieren Sie diese Eingabeaufforderung in Ihren KI-Agenten ihrer Wahl. Wenn Sie GitHub Copilot verwenden, wechseln Sie zuerst zum Modus AgentModus – Fragen- und Bearbeitungsmodi haben keinen Terminalzugriff.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

Der KI-Agent stellt Ihnen zunächst drei Fragen, um zu bestimmen, welche Funktionen für Ihren Agent gelten:

Frage 1: Ist Ihr Agent bereits in Microsoft Teams oder Copilot verfügbar?

  • Ja
  • Nein

Frage 2: Wie authentifiziert sich Ihr Agent beim Aufrufen von downstream-APIs?

  • Im Auftrag von (OBO) – der Agent fungiert als angemeldeter Benutzer (delegierte Berechtigungen)
  • Service-to-Service (S2S) – der Agent fungiert als eigene Identität (Anwendungsberechtigungen)
  • Beide (OBO und S2S)

Frage 3: Welche Agent 365-Funktionen möchten Sie aktivieren?

Das Setup enthält automatisch alle erforderlichen Funktionen für Ihre Auswahl.

Der KI-Agent arbeitet dann automatisch durch die anwendbaren Ebenen und pausiert nur, um Ihre Eingabe zu fragen:

Fähigkeit Was der KI-Agent tut 1
Registrieren Sucht nach .NET und Agent 365 CLI (installiert oder aktualisiert, wenn nötig), installiert Azure CLI falls nicht vorhanden, führt az login aus, falls nicht authentifiziert, überprüft Ihre benutzerdefinierte Client-App-Registrierung, sammelt Agentennamen und Manager-E-Mail, konfiguriert Ihre Agenten im Teams Developer Portal und registriert Ihren Agent-Blueprint.
Beobachtbarkeit Fügt Agent 365 SDK-Überwachungsinstrumentierung zu Ihrem Agenten-Code hinzu.
KI-Teamkollege Führt a365 publish aus und leitet Sie durch die Schritte nach der Bereitstellung, einschließlich der Erstellung von Agentinstanzen.

1 Die ausgeführten Schritte hängen vom Agenttyp und den Phasen ab, die Sie zu Beginn des Setups ausgewählt haben.

Important

Für Observability schreibt der KI-Agent Code direkt in Ihr Projekt. KI-Codierungs-Agents können Fehler machen. Überprüfen Sie die Änderungen immer vor der Bereitstellung in der Produktion.

Informationen, die zum Abschließen erforderlich sind

Der KI-Agent hält an, um die Konfiguration während des Setups zu sammeln:

Eingabeaufforderung Was zu bieten ist
Agentname, E-Mail-Adresse des Vorgesetzten Grundlegende Agent-Metadaten
Bestätigung des abgeleiteten Werts Überprüfen Sie die Namen, die automatisch für die Agentidentität, den Blueprint und den Benutzerprinzipal generiert wurden.
Manifest-Überprüfung Bestätigen Sie, dass Ihr manifest.json mit dem Namen, der Beschreibung und den Entwicklerinformationen Ihres Agents aktualisiert ist.

Schritte nach der Bereitstellung

Wenn die automatisierten Ebenen abgeschlossen sind, wird der KI-Agent für zwei Schritte angehalten, die eine Browserinteraktion erfordern:

  1. Erstellen Sie eine Agent-Instanz

    (nur AI-Teamkollege) – Wechseln Sie in Microsoft Teams zu Apps, suchen Sie nach Ihrem Agent, und wählen Sie Add aus. Wenn die Administratorgenehmigung erforderlich ist, erhält Ihr Microsoft 365 Administrator die Anforderung. Nach der Genehmigung wird Ihr Agent in Ihrem Organigramm angezeigt. Weitere Instanzen finden Sie unter Erstellen von Agentinstanzen. Es kann einige Minuten dauern, bis ein neu veröffentlichter Agent in der Teams-Suche angezeigt wird.

  2. Ihren Agent testen

    Senden Sie eine Nachricht an Ihren Agent in Teams, um zu überprüfen, ob sie funktioniert.

Fertig – Ihr Agent ist bereitgestellt worden, veröffentlicht und live. Siehe Erstellen von Agentinstanzen, wenn Sie zusätzliche Instanzen benötigen.

Wenn etwas nicht funktioniert hat, bietet der KI-Agent gezielte Problembehandlung. Sie können auch auf das Handbuch zur Problembehandlung für Agent 365 verweisen.

Manuelle Pfadreferenz

Verwenden Sie diese Anleitung nur, wenn Sie bei einem Schritt zur Fehlerbehebung sind, CI/CD-Automatisierung erstellen oder ohne einen KI-Codierungsagenten arbeiten.

Schritt Was es tut Guide
Setup-Konfiguration Erstellt a365.config.json mit Ihren Mandanten-, Abonnement- und Projektdetails. Wenn Sie über eine vorhandene Bereitstellung verfügen, legen Sie den Messaging-Endpunkt hier fest . Setup Agent 365 Konfiguration
Einrichtungsentwurf Registriert Ihre Agent-Identität in Entra und stellt Azure Ressourcen bereit (Ressourcengruppe, App Service Plan, Web App) Setup-Agent-Blueprint
Bereitstellen Stellt Ihren Agentcode für Azure App Service bereit. Optional, wenn bereits an anderer Stelle gehostet. Azure · AWS · GCP
Publish Erstellt manifest.zip und lädt es in das Microsoft 365 Admin Center hoch. Veröffentlichungs-Agent

Informationen zur CLI-Installation, -Befehle und -Problembehandlung finden Sie unter Agent 365 CLI.

Veröffentlichen Ihres Agents auf Microsoft Marketplace

Nachdem Sie Ihren Agenten in Ihrem eigenen oder mehreren Mandanten vollständig entwickelt und getestet haben, stellen Sie ihn im Microsoft Marketplace zur Verfügung.

Dazu benötigen Sie ein Microsoft AI Cloud Partner Program-Konto im Partner Center. Wenn Sie kein Konto besitzen, erstellen Sie ein Konto, um Ihre PartnerID zu erhalten. Registrieren Sie sich als Nächstes für das Microsoft 365- und Copilot-Programm, das Ihnen Zugriff auf die Ressourcen und Support bietet, die zum Veröffentlichen von Agentangeboten erforderlich sind. Überprüfen Sie nach der Anmeldung die Checkliste und Validierungsrichtlinien für die Übermittlung und übermitteln Sie Ihren Agenten dann mithilfe der Schritt-für-Schritt-Anleitung im Partner Center.

Erfahren Sie, wie Sie Ihren Agent über das Partner Center an Microsoft Marketplace übermitteln.

Wenn Sie fertig sind, wird Ihr Agent auf Microsoft Marketplace veröffentlicht und steht Kunden zur Verfügung, um sie zu entdecken und bereitzustellen.

Problembehandlung beim KI-geführten Setup

Wenn Beim KI-geführten Setup Probleme auftreten, sehen Sie sich die folgenden häufigen Probleme und deren Lösungen an.

Das Problem Description
DER KI-Agent führt keine Terminalbefehle aus. DER KI-Agent beschreibt Befehle, führt sie aber nicht aus.
KI-Agent überspringt Schritte Setup scheint erforderliche Schritte zu überspringen
CLI-Befehle schlagen mit Berechtigungsfehlern fehl Autorisierungsfehler beim Ausführen von A365 CLI-Befehlen
Konfigurationswerte sind falsch. Es ist nötig, die Konfiguration nach dem Erstellen von a365.config.json zu ändern.

Der KI-Agent führt keine Terminalbefehle aus

Wenn der KI-Agent Befehle beschreibt, diese aber nicht ausführt, stellen Sie sicher, dass Sie AgentModus im GitHub Copilot Chat verwenden. Die Modi "fragen" und "Bearbeiten" haben keinen Terminalzugriff.

KI-Agent überspringt Schritte

Die Befehlsdatei erzwingt eine strikte Schrittreihenfolge. Wenn der KI-Agent einen Schritt überspringt, bitten Sie ihn, zu beginnen:

Please start from Step 1 in the setup instructions and work through each step in order.

CLI-Befehle scheitern mit Berechtigungsfehlern

Wenn a365 CLI-Befehle durch Autorisierungsfehler ausfallen, ist die häufigste Ursache eine fehlende oder unvollständige Registrierung der benutzerdefinierten Client-App. Der KI-Agent überprüft diese Registrierung während des Setups, sollte die Überprüfung jedoch übersprungen worden sein, siehe Registrierung von benutzerdefinierten Client-Apps.

Allgemeine Problembehandlung finden Sie im Handbuch zur Problembehandlung bei Agent 365.

Konfigurationswerte sind falsch

Wenn Sie die Konfigurationswerte nach dem Erstellen a365.config.jsonändern müssen, führen Sie eine der folgenden Aktionen aus:

  • Bearbeiten Sie die Datei direkt, und führen Sie sie erneut aus. a365 config init -c ./a365.config.json
  • Bitten Sie den KI-Agenten, bestimmte Werte zu aktualisieren
  • Last updated on