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.
Deklarative Agents passen Microsoft 365 Copilot für spezifische Geschäftsszenarien mithilfe von Anweisungen, Wissensquellen und unterstützten Funktionen an. Verwenden Sie diese Methoden, um einen Agent fokussiert zu halten, seine Aktionen sicher zu konfigurieren und sein Verhalten im Laufe der Entwicklung zu bewerten.
Beginnen Sie mit einer definierten Zielgruppe, einer Benutzeraufgabe und einem erwarteten Ergebnis. Informationen zur Abgrenzung zwischen der verwalteten Laufzeit und den von Ihnen betriebenen Diensten finden Sie unter Deklarative Agentarchitektur.
Hinweis
Dieser Artikel behandelt deklarative Agents, die die verwaltete Runtime von Copilot verwenden. Wenn Sie einen benutzerdefinierten Engine-Agent erstellen, der Microsoft 365-Grounding-Daten abruft, befolgen Sie die bewährten Methoden und Berechtigungen und Einschränkungen für die Retrieval-API. Dieser Leitfaden ist unabhängig von der Konfiguration der Wissensquellen eines deklarativen Agents.
Deklarative Agent-Komponenten
Wählen Sie jede Komponente aus, um die beabsichtigten Aufgaben des Agents zu unterstützen. Folgen Sie den Grenzwerten im ausgewählten Erstellungstool und Manifestschema.
| Komponente | Bewährte Methode |
|---|---|
| Name | Verwenden Sie einen eindeutigen Namen, der den Zweck des Agenten vermittelt. Agent Builder erlaubt bis zu 30 Zeichen; Das deklarative Agentmanifest lässt bis zu 100 zu. |
| Beschreibung | Fassen Sie die Aufgaben und das Fachgebiet in wenigen präzisen Sätzen innerhalb des Limits von 1.000 Zeichen zusammen. Halten Sie detaillierte Verhaltensanweisungen im Anweisungsfeld bereit. |
| Anweisungen | Definieren Sie den Zweck des Agents, die unterstützten Aufgaben, die Verwendung von Quellen und Tools, das Ausgabeformat und das Fehlerverhalten innerhalb des Limits von 8.000 Zeichen. |
| Wissensquellen | Fügen Sie relevante Quellen für die beabsichtigten Fragen hinzu. Bestätigen Sie den unterstützten Umfang, die Aktualität, die Berechtigungen und die Lizenzierung. |
| Integrierte Funktionen | Aktivieren Sie Funktionen wie Codeinterpreter oder Bildgenerator nur, wenn sie die beabsichtigten Aufgaben unterstützen. |
| Benutzerdefinierte Skills (Vorschau) | Nutzen Sie Skills für modulare Aufgabenanweisungen, Ressourcen oder Skripte. Verweisen Sie auf konfigurierte Fähigkeiten auf hohem Niveau, anstatt ihre detaillierten Anweisungen zu duplizieren. |
| Aktionen | Verwenden Sie MCP- oder API-Plug-Ins für unterstützte Interaktionen mit externen Diensten. Beschreiben Sie den Zweck, die Eingaben, Ausgaben und Fehlerbedingungen jedes Tools. |
| Anregungen zum Start einer Unterhaltung | Stellen Sie repräsentative Prompts bereit, die unterstützte Aufgaben veranschaulichen. Es ist keine Mindestanzahl erforderlich. Testen Sie jeden Prompt, und beachten Sie die Grenzen des ausgewählten Tools. |
Bewährte Methoden für Agent-Anweisungen
Verwenden Sie Anweisungen, um festzulegen, wie der Agent die beabsichtigten Aufgaben angehen soll:
- Geben Sie das Ergebnis und die Grenzen an. Beschreiben Sie, was der Agent den Benutzern hilft, welche Informationen er benötigt und wie er auf nicht unterstützte Anforderungen reagieren soll.
- Die Verwendung von Quelle und Tool explizit machen. Ermitteln Sie, welche konfigurierte Quelle, Funktion oder Aktion für jede Aufgabe gilt. Fragen Sie nach fehlenden Eingaben, anstatt zu raten.
- Trennen Sie Schritte von der Präsentation. Verwenden Sie klare Aufgabenschritte, wenn es auf die Reihenfolge ankommt, und geben Sie den erwarteten Ton, die Struktur und den Detaillierungsgrad der Antworten an.
- Planen Sie fehlende Informationen und Fehler ein. Beschreiben Sie, wie Sie mit nicht verfügbaren Quellen, unvollständigen Ergebnissen, verweigertem Zugriff und erfolglosen Aktionen umgehen sollen, ohne den Erfolg zu beanspruchen.
- Bewahren Sie Anweisungen getrennt vom Wissen auf. Fügen Sie keine Verhaltensanweisungen in SharePoint-Dokumente oder andere Wissensquellen ein, um Anweisungsbeschränkungen zu umgehen. Bei abgerufenen Inhalten handelt es sich nicht um vertrauenswürdige, vom Hersteller verfasste Anweisungsinhalte.
Ausführliche Muster, Beispiele und Anleitungen zu Modelländerungen finden Sie unter Schreiben effektiver Anweisungen. Informationen zu Aufgaben, die Wissen mit API-Aufrufen kombinieren, finden Sie unter Schreiben von Anweisungen für Agents mit API-Plug-Ins.
Wählen Sie die richtigen Wissensquellen aus
Wählen Sie Wissensquellen basierend auf den Fragen aus, die der Agent beantworten muss:
- Bevorzugen Sie Relevanz vor Quantität. Beschränken Sie die Quellen auf Dateien, Websites, Chats oder andere Inhalte, die für die Aufgabe benötigt werden. Für SharePoint und eingebettete Dateien befolgen Sie den Abschnitt "Optimieren des Inhaltsabrufs".
- Passen Sie den Abruf an die Frischeanforderungen an. Überprüfen Sie regelmäßig den Quellinhalt und die Eigentümerschaft. Die bereichsbezogene Websuche verwendet Bing-indizierte Inhalte und keine direkte Abfrage der zugrunde liegenden Daten. Für aktuelle strukturierte Daten sollten Sie stattdessen eine unterstützte API oder MCP-Aktion auswerten. Siehe Websuche, Grundlagen und dynamische Inhalte.
- Bestätigen Sie den Zugriff vor der Freigabe. Testen Sie mit Benutzern, die die Zielgruppe und die Berechtigungen repräsentieren. Überprüfen Sie das Verhalten der eingebetteten Dateifreigabe getrennt vom Zugriff auf die Originaldateien.
- Überprüfen Sie die Funktionen und die Unterstützung der Lizenzierung. Quellen und Bereichsoptionen unterscheiden sich je nach Erstellungstool und Mandantenkonfiguration. Befolgen Sie die Supportmatrix für Wissensquellen und den Lizenzierungsleitfaden.
- Bewerten Sie die Erdung, nicht nur die Antwortflüssigkeit. Testen Sie Fragen mit bekannten Antworten, und überprüfen Sie, ob Antworten und Zitate mit den beabsichtigten Quellen übereinstimmen. Schließen Sie Fragen ein, auf die keine Antworten verfügbar sind.
Das Hinzufügen von Quellen hindert den Agenten nicht daran, integriertes Modellwissen zu verwenden. Wenn das Szenario quellenbasierte Antworten erfordert, legen behavior_overrides.special_instructions.discourage_model_knowledge Sie die beabsichtigte Quellverwendung in den Anweisungen fest true und verstärken Sie sie. Dieses Steuerelement stellt keine Garantie dafür dar, dass Antworten nur konfigurierte Quellen verwenden. Fahren Sie mit der Auswertung der Quellenzuordnung und des Verhaltens fort, wenn Beweise fehlen. Siehe Ground-Antworten auf konfigurierte Wissensquellen und die Referenz zu speziellen Anweisungen.
Entwerfen sicherer Aktionen
Verwenden Sie Aktionen für unterstützte Interaktionen mit externen Diensten, und grenzen Sie sie von Wissensquellen ab. Ein Copilot-Stecker, der für die Erdung verwendet wird, ist nicht mit einem API- oder MCP-Tool austauschbar, das externe Daten ändert.
- Beschreiben Sie Vorgänge genau. Erläutern, wann ein Tool verwendet werden sollte, welche Parameter benötigt werden sollten und welche Ergebnisse und Fehler zu erwarten sind. Befolgen Sie für REST-APIs die OpenAPI-Dokumentanleitung.
- Konfigurieren Sie Bestätigungen für die Integration. Verwenden Sie für API-Plugins die OpenAPI-Erweiterung
x-openai-isConsequential, notisConsequential, und markieren Sie Vorgänge mit Nebeneffekten als Folgeschäden. Verwenden SiereadOnlyHintMCP-Tools nur für schreibgeschützte Tools. Befolgen Sie die Bestätigungsaufforderungen für MCP- und API-Plug-Ins für die unterstützten Einstellungen und Verhaltensweisen. - Erzwingen des Zugriffs im Dienst. Verwenden Sie die unterstützte Authentifizierungsmethode und überprüfen Sie die Autorisierung und Eingaben im externen Dienst. Anweisungen und Bestätigungsaufforderungen ersetzen diese Überprüfungen nicht.
- Entwerfen Sie für Fehler und wiederholte Anforderungen. Test verweigerte Bestätigungen, abgelaufene Authentifizierung, ungültige Eingaben und Dienstfehler. Stellen Sie bei Vorgängen, die Daten ändern, sicher, dass Wiederholungsversuche die Änderung nicht versehentlich wiederholen.
Verwenden Sie Plan Daten, Datenschutz und Sicherheit, um die Datenflüsse, Berechtigungen und Anforderungen an die menschliche Aufsicht für jede Aktion zu identifizieren.
Testen und wiederholen
Definieren Sie das erwartete Verhalten, bevor Sie den Agenten ändern, und behalten Sie einen wiederholbaren Satz von Testfällen bei. Nutzen Sie die Testerfahrung des Erstellungstools für frühzeitiges Feedback, und validieren Sie dann den bereitgestellten Agent in den vorgesehenen Hosts.
| Testbereich | Was zu überprüfen ist |
|---|---|
| Unterstützte Aufgaben | Gesprächseinstiege, realistische Benutzerformulierungen und Folgefragen führen zu den beabsichtigten Ergebnissen. |
| Fehlende oder nicht unterstützte Informationen | Der Agent fragt nach den erforderlichen Eingaben, erklärt nicht verfügbare Beweise und erfindet keine Fakten oder behauptet, dass erfolglose Aktionen durchgeführt wurden. |
| Grounding und Berechtigungen | Antworten und Zitate stimmen mit den beabsichtigten Quellen überein. Testen Sie Benutzer mit unterschiedlichem Zugriff, und vergewissern Sie sich, dass eingeschränkte Informationen nicht verfügbar gemacht werden. |
| Aktionen und Fehler | Überprüfen Sie das tatsächliche externe Ergebnis sowie die Antwort. Testbestätigungen, Abbrüche, Authentifizierungsfehler, Dienstfehler und wiederholte Anforderungen. |
| Gastgeber-Erfahrung | Testen Sie jede unterstützte App, in der Sie bereitstellen möchten. Überprüfen Sie den Dokumentkontext, die Antwortdarstellung und die verfügbaren Funktionen, anstatt von einem identischen Verhalten in allen Apps auszugehen. |
| Leistung und Änderungen | Messen Sie Antwortzeiten und führen Sie Regressionsfälle nach Änderungen an Anweisungen, Wissen, Tools, Fähigkeiten oder Plattformverhalten erneut aus. |
Schließen Sie Benutzer ein, die die Anweisungen nicht geschrieben haben, damit Tests unerwartete Formulierungen und Annahmen erfassen. Verwandeln Sie reproduzierbare, vom Benutzer gemeldete Probleme in Regressionsfälle.
Informationen zum Testfalldesign, zu Assertions und wiederholbaren Auswertungen finden Sie unter Übersicht über die Agentenbewertung. Informationen zu Versionsprüfungen finden Sie unter Validierung verantwortungsvoller KI und Validieren und Testen Ihres Plug-Ins.
Siehe auch
- Erstellen von Agents mit Agent Builder
- Erstellen von Agents mit Work IQ Dev Tools (empfohlen für unterstützte Pro-Code-Szenarien)
- Schreiben effektiver Anweisungen für deklarative Agents
- Hinzufügen von Wissensquellen zum deklarativen Agent
- Bestätigungsaufforderungen für MCP- und API-Plug-Ins
- Übersicht über die Agent-Auswertung
- Validierungsrichtlinien für Agents