Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Orchestrator Microsoft 365 Copilot koordiniert das Sprachmodell, den verfügbaren Kontext und die Funktionen, die er verwendet, um auf eine Benutzeranforderung zu reagieren. Für deklarative Agents können diese Funktionen Wissensabruf, integrierte Funktionen und Aktionen umfassen, die von MCP- oder API-Plugins bereitgestellt werden.
Dieser Artikel konzentriert sich darauf, wie die Konfiguration Ihres Agents die Aktionsauswahl und den Aufruf beeinflusst. Sie stellen Anweisungen, Tooldefinitionen und externe Dienste bereit; Microsoft verwaltet die Unterhaltungslaufzeit. Informationen zur breiteren Aufteilung der Zuständigkeiten finden Sie unter Deklarative Agentarchitektur.
Copilot Orchestrator
Der Orchestrator verwendet die Konfiguration des Agents und den verfügbaren Kontext, um zu bestimmen, ob direkt geantwortet, Wissen abgerufen oder ein Tool aufgerufen werden soll. Nicht jede Anforderung erfordert eine externe Aktion.
Beispielsweise könnte ein Benutzer fragen: "Welche Tickets sind mir gerade zugewiesen?" Ein Agent mit einer geeigneten Ticketing-Aktion kann aktuelle Informationen vom Ticketing-Service abrufen, anstatt sich auf Modellwissen zu verlassen.
Das folgende Diagramm zeigt eine API-Aktions-Interaktion. Es handelt sich um eine konzeptionelle Sicht, keine feste Ausführungssequenz oder eine Garantie, dass jede Anforderung Microsoft Graph oder eine externe API verwendet.
- Interpretieren Sie die Anforderung. Copilot verwendet die Eingabeaufforderung, die Anweisungen des Agents, den Unterhaltungsverlauf und den verfügbaren App-Kontext, um die Aufgabe des Benutzers zu identifizieren. Plattformsicherheits- und Richtlinienprüfungen können sich darauf auswirken, ob und wie die Anforderung fortgesetzt wird.
- Wählen Sie die relevanten Funktionen aus. Copilot ermittelt, ob konfiguriertes Wissen oder Tools helfen können. Bei einer externen Aktion helfen Plug-In- und Toolbeschreibungen dabei, einen geeigneten Vorgang zu identifizieren.
- Ermitteln von Eingaben und Aufrufen des Tools. Copilot ordnet verfügbare Informationen den Parametern des Tools zu. Anweisungen sollten es anleiten, nach fehlenden erforderlichen Informationen zu fragen, anstatt Werte zu erfinden. Externe Anrufe verwenden das konfigurierte Authentifizierungs- und Bestätigungsverhalten.
- Interpretieren Sie das Ergebnis. Copilot verwendet die zurückgegebenen Daten oder Fehler, um den nächsten Schritt zu bestimmen. Die Interaktion kann einen weiteren Anruf, eine Bitte um Klärung oder eine Antwort an den Benutzer umfassen.
- Dem Benutzer antworten. Copilot generiert eine Antwort anhand des verfügbaren Kontexts und der Ergebnisse. Die Antwort sollte das widerspiegeln, was der Dienst tatsächlich zurückgegeben oder geändert hat.
Deklarative Agents unterstützen das Verketten von Funktionsaufrufen, einschließlich der Übergabe der Ausgabe eines API-Aufrufs an einen anderen und der Kombination von API-Aktionen mit SharePoint-Wissen oder Codeinterpreter. Entwerfen und testen Sie die erforderlichen Interaktionen, anstatt von einer festen Anzahl von Anrufen auszugehen, die immer in einer Runde abgeschlossen werden. Befolgen Sie die aktuellen Plug-In-Einschränkungen und die Grenzwerte Ihrer externen Dienste.
Plattformschutz und Benutzerbestätigungen ersetzen nicht die Berechtigungs- oder Geschäftsregelprüfungen in Ihrem externen Dienst. Wenn der Workflow genaue Ausführungsreihenfolge, Transaktionen oder Wiederherstellung erfordert, implementieren Sie diese Anforderungen im Dienst, anstatt sich auf Modellanweisungen zu verlassen.
Wie der Orchestrator von Copilot Aktionen mit Benutzerabfragen abgleicht
Die Auswahl des Plugins und der Aufruf einzelner Tools sind unterschiedliche Entscheidungen. Die Beschreibung eines Plug-Ins hilft Copilot, den relevanten Dienst oder die relevante Domäne zu identifizieren. Die Tools, die über dieses Plug-In verfügbar sind, beschreiben dann die Vorgänge, die Copilot aufrufen kann, und die Eingaben, die sie benötigen.
Wenn die Plug-In-Auswahl semantisches Matching verwendet, basiert die Übereinstimmung auf der Beschreibung des Plug-Ins, nicht auf den Beschreibungen einzelner Funktionen. Ein abgestimmtes Plugin stellt seine Funktionen oder Tools zur Verfügung; Es ist keine feste Auswahlliste von fünf Funktionen. Informationen zum aktuellen Auswahlverhalten und zu Kontexteinschränkungen finden Sie unter MCP- und API-Plug-In-Einschränkungen.
Stellen Sie auf jeder Ebene nützliche Beschreibungen bereit:
| Konfiguration | Beschreibung |
|---|---|
| Plugin Beschreibung | Der Zweck des Diensts, unterstützte Benutzeraufgaben und Domäne. Machen Sie die Beschreibung spezifisch genug, um sie von anderen Plugins zu unterscheiden. |
| Funktions- oder Tooldefinition | Der Zweck des Vorgangs, wann er verwendet werden soll und ob Daten abgerufen oder geändert werden. Ordnen Sie für API-Plugins den Funktionsnamen der OpenAPI operationIdzu. |
| Parameter | Erforderliche Eingaben, Typen, Formate und aussagekräftige Beispiele. Unterscheiden Sie Bezeichner von Anzeigenamen, und machen Sie optionales Verhalten deutlich. |
| Ergebnisse und Fehler | Die zurückgegebenen Daten, was ein erfolgreicher Vorgang bedeutet und wie Fehler dargestellt werden. Sorgen Sie dafür, dass Nutzlasten für die Aufgabe relevant sind. |
Befolgen Sie für API-Plug-Ins Erstellen effektiver OpenAPI-Beschreibungen. Überprüfen Sie für MCP-Plug-Ins, ob Tooldefinitionen dynamisch erkannt oder im Plug-In-Manifest angeheftet werden. Bei der dynamischen Ermittlung können Änderungen an den Tooldefinitionen des Servers die Auswahl beeinflussen, ohne den Agenten erneut zu veröffentlichen.
Aktionsauswahl verbessern und auswerten
Beschreibungen und Anweisungen beeinflussen die Auswahl. Sie garantieren nicht, dass für jede Formulierung einer Anforderung ein bestimmtes Tool aufgerufen wird.
- Klären Sie überlappende Vorgänge. Wenn mehrere Tools geeignet erscheinen, erläutern Sie deren unterschiedliche Zwecke und erforderliche Eingaben. Unterscheiden Sie Lesevorgänge von Vorgängen, die Daten ändern.
- Verbinden Sie Aufgaben mit Tools in den Anweisungen. Erläutern, wann die konfigurierten Tools verwendet werden sollen, wie fehlende Informationen gesammelt werden und wie frühere Ergebnisse in Folgeanforderungen verwendet werden. Siehe Anweisungen für Agents mit API-Plug-Ins.
- Konzentrieren Sie sich auf die verfügbaren Tools. Machen Sie die für die Aufgaben des Agenten erforderlichen Vorgänge verfügbar. Mehr Tooldefinitionen und größere Nutzlasten verbrauchen Kontext und können die Antwortqualität verringern.
- Testen Sie die tatsächliche Auswahl und die Ergebnisse. Schließen Sie paraphrasierte Eingabeaufforderungen, mehrdeutige Anforderungen, fehlende Eingaben, mehrstufige Aufgaben, stornierte Bestätigungen und Dienstfehler ein. Überprüfen Sie die Vorgänge und Parameter, die der Dienst erhalten hat, nicht nur den endgültigen Wortlaut.
- Wiederholen Sie Tests, wenn sich Definitionen ändern. Führen Sie repräsentative Fälle nach Änderungen an Plug-In-Beschreibungen, Tool-Definitionen, Anweisungen oder der Plattform erneut aus. MCP-Serverupdates bei Verwendung der dynamischen Ermittlung einbeziehen.
Wichtig
Eine fehlende oder unvollständige Antwort im Gespräch stellt nicht fest, ob ein externer Vorgang abgeschlossen wurde. Überprüfen Sie das Ergebnis des Diensts, bevor Sie einen Vorgang wiederholen, bei dem Daten geändert werden, und entwerfen Sie den Dienst so, dass er wiederholte Anforderungen sicher verarbeitet.
Umfassendere Entwurfsempfehlungen finden Sie unter Bewährte Methoden für deklarative Agents. Wiederholbare Testfälle und Assertionen finden Sie in der Übersicht über die Agent-Auswertung.