Agent-Beschreibungen schreiben
Agent-Beschreibungen schreiben für Copilot Studio: klare Beschreibungen für Themen, Werkzeuge und Wissensquellen bei generativer Orchestrierung, mit Prüfung auf Verwechslungsgefahr.
Warum Beschreibungen so wichtig sind
Bei generativer Orchestrierung entscheidet ein Sprachmodell anhand von Namen und Beschreibungen, welches Thema, welches Werkzeug oder welche Wissensquelle ein Copilot-Studio-Agent nutzt. Die Beschreibungen ersetzen damit die Trigger-Phrasen des klassischen Modus. Vage Beschreibungen wie „hilft bei HR-Fragen“ führen zu falschen Entscheidungen und unnötigen Aktionen, die Copilot Credits kosten.
Der Generator baut aus fünf Bausteinen eine klare Beschreibung: was es tut, wann es zu nutzen ist, wann nicht, welche Eingaben ein Werkzeug braucht und was herauskommt. Die Prüfung findet vage Formulierungen, fehlende Abgrenzung und zu ähnliche Beschreibungen im selben Agenten, die das Modell verwechseln könnte. Mehr im Ratgeber Generative Orchestrierung.
Anleitung: Agent-Beschreibungen in 5 Schritten
- Unter „Was beschreiben Sie?“ wählen, ob es um ein Thema, ein Werkzeug, eine Wissensquelle oder einen untergeordneten Agenten geht.
- Name eintragen und unter „Was tut es?“ die Aufgabe in einem Satz beschreiben.
- Unter „Nutzen, wenn …“ und „Nicht nutzen für …“ je eine Situation pro Zeile eintragen; bei Werkzeugen zusätzlich die Eingaben im Format „Name: Bedeutung“ und das Ergebnis.
- Optional die übrigen Beschreibungen des Agenten, durch Leerzeilen getrennt, ins Abgleichsfeld einfügen und die Hinweise unter „Prüfung“ abarbeiten.
- Die fertige Beschreibung mit „Kopieren“ übernehmen und in Copilot Studio einfügen.
Typische Anwendungsfälle
- Agent ruft das falsche Werkzeug auf: Die Beschreibungen zweier ähnlicher Aktionen gegeneinander abgrenzen, damit die generative Orchestrierung sie unterscheiden kann.
- Umstieg vom klassischen Modus: Themen, die bisher nur über Trigger-Phrasen ausgelöst wurden, mit einer klaren Beschreibung versehen.
- Neue Wissensquelle anbinden: Festhalten, welche Fragen eine SharePoint-Seite oder Datei beantwortet und welche nicht.
- Prüfung vor der Veröffentlichung: Alle Beschreibungen eines Agenten im Abgleichsfeld auf zu große Ähnlichkeit testen.
Häufige Fragen
Warum wählt mein Agent das falsche Werkzeug?
Meist sind die Beschreibungen zu allgemein oder zu ähnlich. Nennen Sie ausdrücklich, wann ein Werkzeug zu nutzen ist und wann nicht, und grenzen Sie es gegen ähnliche ab.
Wie lang sollte eine Beschreibung sein?
Zwei bis vier Sätze reichen meist: was es tut, wann es gemeint ist, wann nicht und bei Werkzeugen die Eingaben. Sehr lange Beschreibungen verwässern die Auswahl.
Brauche ich bei generativer Orchestrierung noch Trigger-Phrasen?
Für die Auswahl zählen vor allem Name und Beschreibung. Trigger-Phrasen bleiben für den klassischen Modus und als zusätzlicher Hinweis nützlich; prüfen lassen sie sich mit dem Trigger-Phrasen-Prüfer.
Was gehört in die Beschreibung eines Werkzeugs in Copilot Studio?
Was das Werkzeug tut, in welchen Situationen es gemeint ist, wofür es nicht gedacht ist, welche Eingaben es erwartet und was es zurückgibt. Genau diese Bausteine fragt der Generator ab.
Wie verhindere ich, dass zwei Themen im Agenten verwechselt werden?
Grenzen Sie beide Beschreibungen ausdrücklich gegeneinander ab, etwa unter „Nicht nutzen für …“, und vermeiden Sie gleiche Schlüsselwörter. Fügen Sie die andere Beschreibung ins Abgleichsfeld ein; die Prüfung meldet zu ähnliche Formulierungen.
Zum Weiterlesen
- Was ist Copilot Studio? Microsofts Baukasten für KI-AgentenWas ist Copilot Studio? Microsofts Werkzeug für eigene KI-Agenten erklärt: Funktionen, Einsatzbeispiele, Kanäle wie Teams, Lizenzen und Abgrenzung zu Microsoft 365 Copilot.
- Copilot Studio Lizenzen: Kosten, Credits und AbrechnungCopilot Studio Lizenzen erklärt: Copilot Credits, Kapazitätspakete, Pay-as-you-go, was in Microsoft 365 Copilot enthalten ist und was ein Agent pro Monat kostet.
- Copilot Studio Agent erstellen: Schritt für SchrittCopilot Studio Agent erstellen: vom leeren Agenten über Anweisungen, Wissensquellen und Werkzeuge bis zu Test und Veröffentlichung. Anleitung mit Tipps aus der Praxis.
Das könnte auch helfen
Lizenz oder Credits?neu
Ab wann lohnt sich die Microsoft-365-Copilot-Lizenz für interne Agenten gegenüber Copilot Credits?
ÖffnenCopilot-Studio-Kostenrechnerneu
Was kostet ein Agent in Copilot Studio? Copilot Credits je Gespräch, Kapazitätspakete oder Pay-as-you-go.
ÖffnenCopilot-Credits-Rechnerneu
Copilot Credits in Euro umrechnen und sehen, ab wann sich Kapazitätspakete lohnen.
ÖffnenAnweisungen für Copilot-Studio-Agentenneu
Agent-Anweisungen strukturiert schreiben, mit Zähler für die Grenze von 8.000 Zeichen.
ÖffnenTrigger-Phrasen-Prüferneu
Trigger-Phrasen für Copilot-Studio-Themen prüfen: Anzahl, Dubletten und Überschneidungen.
ÖffnenWissensquellen-Checkneu
Geplante Wissensquellen gegen die Limits von Copilot Studio prüfen: SharePoint, Dateien, Websites.
Öffnen