Deklarative Agent-Architektur

Deklarative Agents werden in der verwalteten Orchestrierungs- und Sprachmodellinfrastruktur von Microsoft 365 Copilot ausgeführt. Sie konfigurieren die Anweisungen, Wissensquellen und unterstützten Funktionen des Agents, anstatt Ihre eigene Unterhaltungslaufzeit zu implementieren und zu hosten.

Ein Agent kann Microsoft 365-Wissensquellen, integrierte Funktionen wie Codeinterpreter, benutzerdefinierte Skills (Vorschau) und Aktionen verwenden, die von MCP-Servern oder REST-APIs bereitgestellt werden. Er kann auch Aufgaben an verbundene Agents delegieren. Die Verfügbarkeit hängt vom Erstellungstool, der Manifestversion, der Zieloberfläche, der Lizenzierung und den Organisationsrichtlinien ab.

In diesem Artikel erfahren Sie mehr über die Grenze zwischen der verwalteten Plattform und den Komponenten, die Sie konfigurieren oder betreiben. Einen Vergleich mit einer Architektur ermöglichen, die Ihnen die Kontrolle über Orchestrierung und Modellhosting gibt, finden Sie unter Vergleichen von deklarativen und benutzerdefinierten Engine-Agents.

Architekturkomponenten

Microsoft 365 Copilot stellt die Laufzeit bereit, die Benutzeranforderungen interpretiert, relevanten Kontext abruft, Funktionen auswählt und Antworten generiert. Ihre Konfiguration und die externen Dienste bestimmen, was der Agent verwenden kann, um eine Aufgabe auszuführen.

Diagramm der Architektur eines deklarativen Agents.

Komponente Verwaltete Plattform Verantwortlichkeiten des Entwicklers
Client Hosts von Unterhaltungen in unterstützten Microsoft 365-Erlebnissen. Wählen Sie die Zielanwendungen aus, und testen Sie die unterstützten Interaktionen, den Dokumentkontext und die Antwortformate.
Infrastruktur Hostet die Copilot-Orchestrierung und Modelllaufzeit. Konfigurieren Sie den Agent, und hosten Sie alle externen APIs, MCP-Server oder anderen Dienste, die von ihm verwendet werden.
Katalog und Vertrieb Bietet unterstützte Akquisitions-, Veröffentlichungs- und Verwaltungsfunktionen. Wählen Sie die unterstützte Paket- und Verteilungsroute aus, verwalten Sie Versionen, und arbeiten Sie mit Administratoren an Zugriff und Bereitstellung.
Sicherheit und Compliance Wendet Microsoft 365-Identitäts-, Datenzugriffs- und Plattformschutz an. Konfigurieren Sie Berechtigungen und Authentifizierung, werten Sie Datenflüsse aus und erzwingen Sie die Autorisierung und den Datenschutz in externen Diensten.
Orchestrator und Sprachmodell Wählt Funktionen aus, ruft sie auf und generiert Antworten. Schreiben Sie Anweisungen und Toolbeschreibungen, konfigurieren Sie unterstützte Verhaltenseinstellungen, und bewerten Sie das resultierende Verhalten. Sie ersetzen den verwalteten Orchestrator nicht durch benutzerdefinierten Laufzeitcode.
Kenntnisse und Fähigkeiten Ruft unterstütztes Wissen ab und führt aktivierte integrierte Funktionen aus. Wählen Sie relevante Quellen und Funktionen aus, bestätigen Sie den Benutzerzugriff, und testen Sie die Abrufqualität.
Toolaufruf Ruft konfigurierte MCP- oder API-Aktionen über die unterstützte Integration auf. Definieren Sie Tool-Eingaben und -Ausgänge, konfigurieren Sie Authentifizierung und Bestätigungen und implementieren Sie zuverlässiges Serviceverhalten.

Unterstützte Konfigurationseinstellungen beeinflussen die verwaltete Runtime. Sie geben Ihnen nicht die volle Kontrolle über die Implementierung. Das Manifest unterstützt beispielsweise einen Standardantwortmodus, den Benutzer außer Kraft setzen können. Folgen Sie dem ausgewählten Manifestschema und dem Authoring-Tool für verfügbare Einstellungen.

Hinweis

Aufgerufene Inhalte und Toolantworten können nicht vertrauenswürdige Anweisungen enthalten. Plattformschutz ersetzt nicht die Berechtigungsüberprüfung in Ihren Diensten oder die Bewertung des Verhaltens des Agents. Planen Sie die geltenden Daten-, Datenschutz- und Sicherheitsanforderungen.

Deklarativer Agent-Datenfluss

Im folgenden konzeptionellen Ablauf wird beschrieben, wie ein Agent seine Konfiguration und Funktionen verwendet. Es handelt sich nicht um eine feste Ausführungssequenz und keine Garantie dafür, wie viele Abrufe oder Toolaufrufe auftreten.

  1. Empfangen einer Anforderung. Der Benutzer sendet eine Eingabeaufforderung in einer unterstützten Oberfläche. Der Unterhaltungsverlauf und der verfügbare App-Kontext können zu der Anforderung beitragen.
  2. Wählen Sie relevanten Kontext und Funktionen aus. Copilot verwendet die Anweisungen, die Wissenskonfiguration und die Toolbeschreibungen des Agents, um zu bestimmen, wie die Anfrage bearbeitet werden soll.
  3. Abrufen von Informationen oder Aufrufen von Aktionen. Copilot ruft verfügbares Wissen ab oder ruft eine aktivierte Funktion auf. Externe Aktionen verwenden das konfigurierte Authentifizierungs- und Bestätigungsverhalten. Externe Dienste erzwingen ihre eigenen Autorisierungs- und Geschäftsregeln.
  4. Generieren einer Antwort. Copilot verwendet den verfügbaren Kontext und die Ergebnisse der Fähigkeiten, um zu reagieren. Je nach Aufgabe kann die Interaktion weitere Anrufe, Anforderungen für Benutzereingaben oder die Delegierung an einen verbundenen Agent umfassen.

Deklarative Agents können API-Aufrufe verketten, die Ausgabe eines Aufrufs als Eingabe eines anderen Aufrufs verwenden und SharePoint-Wissen oder Codeinterpreter mit API-Aktionen kombinieren. Unterstützte Muster und Beispiele finden Sie unter Verketten von Funktionsaufrufen in API-Plug-Ins.

Anweisungen leiten das Modellverhalten; Sie sind kein Ersatz für Anwendungslogik, die eine Transaktion, einen genauen Ausführungsauftrag oder ein Wiederherstellungsverfahren erzwingen muss. Implementieren Sie diese Anforderungen in einer API oder einem Workflowdienst, oder evaluieren Sie eine benutzerdefinierte Modularchitektur, wenn Sie die Orchestrierung übernehmen müssen.

Entwerfen für funktionsspezifische Grenzwerte

Überprüfen Sie die Grenzwerte im Leitfaden für jede Funktion und Integration. Das Zeichenlimit eines Manifestfelds, ein Limit für die Konfiguration von Wissensquellen und ein Laufzeitkontextlimit beschreiben verschiedene Einschränkungen.

Bereich Überlegungen zum Design Anleitung
Agent-Konfiguration Verwenden Sie Eigenschaften und Funktionen, die von der ausgewählten Schemaversion und dem ausgewählten Erstellungstool unterstützt werden. Deklarative Agentmanifestreferenz
Knowledge Retrieval Wählen Sie relevante Quellen aus und befolgen Sie quellenspezifische Datei-, Bereichs-, Zugriffs- und Indizierungsanforderungen. Eine Antwort umfasst nicht unbedingt jedes Element in einer Quelle. Wissensquellen und Optimieren des Inhaltsabrufs
Tooldefinitionen und Nutzlasten Sorgen Sie dafür, dass die Tools fokussiert und die Ein- und Ausgaben relevant sind. Große Plugin-Ein- und Ausgänge können abgeschnitten werden, und effektive Kontextgrenzwerte können sich mit dem Overhead von Modellen und System ändern. MCP- und API-Plugin-Einschränkungen
Dokumentkontext Folgen Sie den von der Host-App unterstützten Dokumentinteraktionen und Inhaltsformaten, anstatt davon auszugehen, dass alle Dokumentinhalte identisch dargestellt werden. Interagieren mit Dokumenten
Dienstverhalten und Latenz Testen Sie Antwortzeiten, Authentifizierungsfehler, Dienstfehler und die Grenzwerte Ihrer externen APIs oder MCP-Server. Integrieren und Testen von Komponenten

Entwerfen Sie für große Datenmengen APIs, um die relevante Teilmenge zu filtern, zu aggregieren oder zurückzugeben, anstatt alle Datensätze in eine Unterhaltung zu senden. Wenn für ein Szenario Dokumentinhalte benötigt werden, testen Sie die unterstützte Hosterfahrung: Deklarative Agents können abhängig vom Dokumentformat auf das gesamte geöffnete Dokument in Word und PowerPoint zugreifen.

Vorteile und Einschränkungen

Wichtige Vorteile und primäre Einschränkungen deklarativer Agents helfen zu bestimmen, wann diese Architektur für bestimmte Anwendungsfälle geeignet ist.

Wesentliche Vorteile

Deklarative Agents bieten erhebliche Vorteile für Organisationen, die KI-Lösungen in bestehenden Microsoft 365-Umgebungen implementieren möchten:

  • Verwaltete Unterhaltungslaufzeit: Microsoft hostet den Orchestrator und die Modellinfrastruktur, sodass Sie diese Laufzeit nicht implementieren müssen.
  • Zugriff auf Microsoft-Funktionen: Agents können neben externen Tools auch unterstützte Wissensquellen und integrierte Funktionen verwenden.
  • Konfigurationsbasierte Anpassung: Anweisungen, Funktionen und Aktionen passen die Erfahrung an, ohne dass eine benutzerdefinierte Konversations-Engine erforderlich ist. Externe Integrationen können weiterhin Code und Hosting erfordern.

Primäre Einschränkungen

Der deklarative Ansatz führt auch Einschränkungen ein, die bestimmte Anwendungsfälle einschränken können:

  • Verwaltete Orchestrierung: Sie beeinflussen das Verhalten durch unterstützte Konfigurationen, anstatt jede Laufzeitentscheidung zu kontrollieren. Bewerten Sie repräsentative Aufgaben, anstatt Anweisungen als deterministische Workflow-Engine zu behandeln.
  • Plattform- und Hostabhängigkeiten: Funktionen, Antwortpräsentation, Lizenzierung und Verwaltung hängen von der ausgewählten Microsoft 365-Erfahrung ab. Bestätigen Sie den Support auf jedem Zielhost.
  • Kontext- und Retrieval-Einschränkungen: Wissensgewinnung und Tool-Ergebnisse müssen zum verfügbaren Kontext passen. Große Quellen oder Nutzlasten garantieren keine vollständige Abdeckung in einer Antwort.
  • Überlegungen zu dynamischen Webinhalten: Die bereichsbezogene Websuche verwendet Bing-indizierte Inhalte, anstatt die zugrunde liegende Datenquelle direkt abzufragen. Dynamisch generierte Inhalte können unvollständig oder veraltet sein. Verwenden Sie eine unterstützte API-Integration, wenn die Aufgabe direkten Zugriff auf aktuelle, strukturierte Daten erfordert. Siehe Websuche, Grundlagen und dynamische Inhalte.
  • Fortlaufende Bewertung: Plattform- und Modellupdates können das Verhalten ändern. Testanweisungen, Abruf und Werkzeugnutzung im Zuge der Weiterentwicklung des Agents und seiner Abhängigkeiten.

Ausrichtung von Anwendungsfällen

Wählen Sie die Architektur basierend auf der Kontrolle aus, die Ihre Lösung erfordert, und nicht nur danach, ob die Aufgabe mehrere Schritte hat.

Optimale Szenarien

Deklarative Agents eignen sich optimal für:

  • Informationsabruf: Agents, die in erster Linie Informationen aus Microsoft 365 oder externen Quellen suchen und zusammenfassen müssen.
  • Unterstützte Aktionen: Agents, die Wissen und unterstützte API- oder MCP-Aktionen kombinieren, um Benutzern bei der Erledigung einer Aufgabe zu helfen.
  • Unterstützung und Analyse von Dokumenten: Agents, die mit unterstütztem Dokumentkontext arbeiten oder Funktionen wie Codeinterpreter verwenden.
  • Produktivitätsverbesserung: Aufgaben, die von einer verwalteten Unterhaltungserfahrung innerhalb von Microsoft 365 profitieren.

Ungeeignete Szenarien

Ziehen Sie einen benutzerdefinierten Engine-Agent oder einen separat implementierten Workflow in Betracht, wenn Ihre Anforderungen Folgendes umfassen:

  • Benutzerdefinierte Laufzeitsteuerung: Sie müssen Ihre eigene Orchestrierung, Modellhosting oder Benutzeroberfläche implementieren, anstatt die verwaltete Copilot-Runtime zu verwenden.
  • Dauerhafte Geschäftsprozesse: Das System muss unabhängig von einer Konversation die genaue Ausführungsreihenfolge, Transaktionsgrenzen, Wiederholungen oder Wiederherstellung erzwingen.
  • Großflächige Datenverarbeitung: Die Aufgabe erfordert eine umfassende Verarbeitung eines Datensatzes und nicht das Abrufen oder Analysieren des relevanten Gesprächskontexts. Führen Sie diese Verarbeitung in einem Dienst durch, und stellen Sie dem Agent das entsprechende Ergebnis zur Verfügung.
  • Direkter Zugriff auf dynamische Quellen: Die Aufgabe erfordert aktuelle, geordnete Ergebnisse aus einer Quelle, die in der Websuche nicht angemessen dargestellt wird. Stellen Sie eine unterstützte API oder MCP-Integration bereit, anstatt sich nur auf die bereichsbezogene Websuche zu verlassen.

Diese Anforderungen schließen nicht immer einen deklarativen Agenten als Unterhaltungsschnittstelle aus. Ein Dienst kann Besitzer des Geschäftsprozesses sein, während der Agent Eingaben sammelt, eine unterstützte Aktion aufruft und das Ergebnis präsentiert.