Erstellen eines deklarativen Agents

Implementieren Sie während des Erstellens oder der Wiederverwendung die in Ihrem Komponentenplan ausgewählte deklarative Agent-Komponente. Dieser Artikel hilft Ihnen bei der Auswahl des Produktverfahrens und bestätigt die Bereitschaft der Komponente. Sie schließen mit einem funktionierenden Agenten, seinen Abhängigkeiten und Testnachweisen für die Plugin-Integration ab.

Sie benötigen nicht für jedes Plug-In einen Agenten. Folgen Sie stattdessen für Ihre eigene Orchestrierung, Modelle, Ihr Hosting oder Ihre Laufzeit dem App-Pfad .

Überprüfen eines vorhandenen Agents vor dem Erstellen eines

  1. Überprüfen Sie die beabsichtigten Benutzer des vorhandenen Agents, die unterstützten Erfahrungen, Anweisungen, Kenntnisse, Aktionen, Berechtigungen und bekannten Einschränkungen mit dem Besitzer.

    Überprüfen Sie: Die dokumentierten Funktionen entsprechen der Aufgaben- und Zielerfahrung in Ihrem Komponentenplan.

  2. Wählen Sie den dokumentierten Wiederverwendungs- oder Erweiterungsweg des Produkts aus. Sie können mit einer Agentvorlage beginnen oder einen Agent-Builder-Agent nach Copilot Studio kopieren, wenn dieser Workflow passt.

    Überprüfen Sie: Die Route unterstützt Ihre Quelle und Ihr Ziel. Gehen Sie nicht davon aus, dass durch das Hinzufügen einer Agent-Komponente zu einem Plug-in ein vorhandenes Projekt importiert wird.

  3. Vereinbaren Sie Besitz, Versionsverwaltung, Support und Änderungsmanagement und testen Sie dann repräsentative Aufgaben.

    Überprüfen Sie: Zeichnen Sie Ergebnisse und offene Lücken auf, bevor Sie sich entscheiden, den Agent unverändert zu verwenden, zu konfigurieren oder eine neue Komponente zu erstellen.

Beginnen Sie mit Work IQ Dev Tools

Beginnen Sie für die berufliche Entwicklung mit Work IQ Dev Tools, wählen Sie eine dokumentierte Umgebung aus, und fügen Sie Agents Toolkit nur hinzu, wenn Ihre Komponente ihre spezifischen Projektsteuerungen benötigt.

Ihr Ausgangspunkt Produktverfahren Erwartetes Ergebnis
Ein neues Plug-In, das eine Agentkomponente benötigt Erstellen eines Plug-Ins mit Work IQ Dev Tools wiqd plugin create erstellt den Container; wiqd plugin add agent Gerüste für die optionale Agentkomponente.
Ein vorhandenes Quellprojekt für deklarative Agents Lebenszyklus der Agent-Komponente Fahren Sie mit der agentspezifischen Erstellung und Iteration mit den dokumentierten wiqd agent Befehlen fort.
Agent-Anweisungen, Kenntnisse oder Aktionen, die bearbeitet werden müssen Deklarative Agents im WIQD und die Befehlsreferenz Die gespeicherte Quelle ist für die ausgewählte Komponente und Umgebung konfiguriert.

Verwenden Sie das WIQD-Codierungs-Assistenten-Plug-In für geführtes Arbeiten oder die direkte CLI für wiederholbare Befehle. Installieren Sie das Coding-Assistent-Plug-In und die CLI bei Bedarf als separate Voraussetzungen. GitHub Copilot hilft beim Erstellen von Dateien, Anweisungen, Konfigurationen und Tests; es ersetzt nicht das Erstellungstool, die Laufzeit oder die Komponentenanforderungen.

Wählen Sie für ein vorhandenes Agentprojekt explizit Offlinevalidierung aus:

wiqd agent validate --mode source --env dev

Überprüfen Sie: Lesen der Ergebnisse der gespeicherten Quelle und Beheben gemeldeter Fehler. Eine bestandene Quellüberprüfung stellt weder das Laufzeitverhalten, die Erreichbarkeit von Endpunkten, die Korrektheit der Authentifizierung noch die endgültige Paketakzeptanz fest. Der Standardmodus package verwendet eine vorhandene ZIP-Datei, lädt sie zur Überprüfung hoch und erfordert möglicherweise eine Anmeldung.

Um einem vorhandenen WIQD-Agent-Projekt einen Skill hinzuzufügen, überprüfen Sie das Featureflag und die agent-skills aktuellen Schemaanforderungen in der Referenz des Agent-Skill-Befehls. Ein Top-Level-Plugin-Skill und ein Skill, der an einen deklarativen Agenten angehängt ist, sind unterschiedliche Registrierungen. Keines von beiden stellt Unterstützung in jedem Host her.

Verwenden einer anderen Produktroute, wenn sie zur Komponente passt

Anforderung Produktverfahren
Verwaltete Dokumenterstellung in Microsoft 365 Copilot Übersicht über den Agent-Generator und Erstellen von Agents
Low-Code-Logik, verwaltete Umgebungen oder Power Platform Connectors Copilot Studio und Verbinden und Konfigurieren eines Agents für Teams und Microsoft Copilot
Untergeordnete Agent-Manifeste und unterstützte Entwicklungsintegrationen Work IQ Dev Tools (empfohlen für unterstützte Pro-Code-Szenarien)
Fähigkeiten in einem vorhandenen Toolkit-Agent Fähigkeiten mit dem Agenten-Toolkit hinzufügen

Eigenständige Copilot Studio-Agents werden in der Agent-Registrierung angezeigt, nicht unter Plug-Ins. Gehen Sie nicht davon aus, dass die Veröffentlichung eines eigenständigen Agents ihn als Plug-In umpackt.

Agent konfigurieren und testen

Ausführliche Implementierungsschritte finden Sie in der Produktanleitung zu Declarative-Agent:

Zu erledigende Arbeit Maßgebliche Anleitung Überprüfen
Definieren Sie Identität, Verhalten, Aufgabengrenzen und Gesprächsstarter Build-Agents oder Mit JSON erstellen und dann effektive Anweisungen schreiben Repräsentative Prompts erzeugen das erwartete Verhalten und bleiben innerhalb der beabsichtigten Aufgabe.
Konfigurieren von Wissen und Funktionen Wissensquellen und Hinzufügen von Funktionen und benutzerdefinierten Aktionen Erforderliche Daten sind für den beabsichtigten Benutzer verfügbar und nicht verfügbar, wenn die Berechtigungen dies nicht zulassen.
Unterstützte MCP- oder API-Aktionen hinzufügen MCP- und API-Plug-Ins für deklarative Agents Toolauswahl, Authentifizierung, Zustimmung, Bestätigungen, Fehler und nicht unterstützte Anforderungen verhalten sich wie vorgesehen.
Unterstützten Skill hinzufügen Kenntnisse in deklarativen Agents und dem ausgewählten Erstellungsverfahren Der Zielagent lädt den Skill und schließt die definierte Aufgabe innerhalb der Produktgrenzen ab.
Verwalten der Konfiguration für Ihre Authoring-Route Toolkit-Umgebungen und -Versionen oder WIQD-Umgebungen Identitätswerte, Abhängigkeiten und Einstellungen gehören zur vorgesehenen Testumgebung.

Notieren Sie die Agent-Version, den Besitzer, die unterstützten Erfahrungen, Abhängigkeiten, bekannte Einschränkungen und Testergebnisse. Produktspezifische Tests sind erforderlich; Das Bestehen der Quell- oder Paketüberprüfung ist kein Beweis dafür, dass jeder Benutzer die Aufgabe ausführen kann.

Entwurfshilfen finden Sie unter Bewährte Methoden für deklarative Agents und Wie der Copilot-Orchestrator Aktionen auswählt. Wenn das erforderliche Verhalten funktioniert, können Sie optional Benutzerfeedback aktivieren und das Abrufen von Inhalten optimieren.

Nächster Schritt

Fahren Sie mit allen verbleibenden Komponenten in Build oder Reuse fort. Wenn sie bereit sind, geben Sie Paket ein & testen Sie mit Integrieren und testen Sie Ihre Komponenten.