Komponentenreferenz in der Agentenbibliothek im Copilot Agent Kit

Komponenten in der Agentenbibliothek sind wiederverwendbare, vorgefertigte Komponentensammlungen, die du zu jedem Copilot Studio-Agenten hinzufügen kannst. Jede Komponente wird als eigene Komponentensammlung verpackt, sodass du nur die Komponenten installierst, die du brauchst.

Dieser Artikel ist die Referenz pro Komponente. Für einen Überblick über Komponenten, wie man Komponenten aus dem Kit durchsucht und installiert sowie wie man sie Ihrem Agenten hinzufügt, siehe Komponentenverwaltung in der Agentenbibliothek.

Komponenten auf einen Blick

Die Agentenbibliothek enthält die folgenden Komponenten, die in ihren Lösungen ausgeliefert werden. Komponenten, die keine Verbindungsreferenzen benötigen, befinden sich in einer eigenen Basislösung. Komponenten, die einen gemeinsamen Stecker teilen, werden zusammengefasst.

Prerequisites

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Installieren und konfigurieren Sie das Copilot Agent Kit in Ihrer Power Platform-Umgebung.
• Der angemeldete Nutzer hat im Copilot Agent Kit die Sicherheitsrolle CSK - Maker zugewiesen, um Komponenten zu durchsuchen und zu installieren.
• Die Power Platform-Umgebung hat Copilot Studio aktiviert.
• Hab AI Builder-Credits in deiner Umgebung verfügbar (für promptbasierte Komponenten erforderlich).
• Für ServiceNow Ticket Assistant sollten Sie eine ServiceNow-Instanz mit REST-API-Zugang und einer konfigurierten ServiceNow-Verbindung in Power Platform haben. Erfahren Sie mehr unter ServiceNow Service Principal Setup.

Document Extraction

Dokumentenextraktion wandelt hochgeladene Dokumente in strukturierte Daten um. Es verwendet eine AI Builder-Eingabeaufforderung, um Schlüsselfelder basierend auf einem konfigurierbaren Schema zu parsen und zu extrahieren.

Wann zu verwenden: Rechnungsverarbeitung, Vertragsprüfung, Digitalisierung von Formularen oder jedes Szenario, das strukturierte Informationen aus unstrukturierten Dokumenten erfordert.

Wie Dokumentenextraktion funktioniert

1. Der Nutzer lädt ein Dokument in die Agentenkonversation hoch.
2. Die Komponente verarbeitet das Dokument mit AI Builder.
3. Die Komponente gibt extrahierte Daten als strukturierte Ausgabe zurück, die Sie speichern, anzeigen oder an nachgelagerte Flows weiterleiten können.

Eingaben zur Dokumentenextraktion

Ausgaben der Dokumentenextraktion

Alle AI Builder-Prompt-Ausgaben werden zurückgegeben.

Content Synthesizer

Content Synthesizer verwandelt rohe Suchergebnisse in einen strukturierten, evidenzbasierten Forschungsbereich mit Inline-Zitaten. Es ist die gemeinsame Synthese-Engine, die sowohl von der Research Component als auch der Executive Brief Component Pipeline verwendet wird. Es kann auch jedem Agenten als eigenständiges Tool zur On-Demand-Inhaltssynthese hinzugefügt werden.

Wann zu verwenden: Jedes Szenario, das die Synthese mehrerer Quelldokumente zu einer kohärenten, zitationsbasierten Erzählung erfordert, entweder als Teil einer mehrstufigen Pipeline oder als eigenständiges Tool zur Inhaltserstellung.

Wie Content Synthesizer funktioniert

1. Die übergeordnete Pipeline (oder der Agent) übergibt einen Forschungsprompt, rohe Suchergebnisse und optionale Stilanweisungen.
2. Das Prompt integriert Erkenntnisse aus allen Quellen nach Thema. Es fasst nicht Quelle für Quelle zusammen.
3. Der Beweis basiert auf den bereitgestellten Inhalten mit spezifischen Datenpunkten wie Zahlen, Prozenten, Daten und benannten Entitäten.
4. Die Ausgabe ist ein JSON-Objekt, das den synthetisierten Markdown-Abschnitt und ein Array extrahierter Zitate enthält.

Inhaltssynthesizer-Eingänge

Inhaltssynthesizer-Ausgaben

Der Prompt liefert ein JSON-Objekt mit zwei Feldern:

Inhaltssynthesizer-Ausgabestruktur

Der synthetisierte Abschnitt folgt folgender Struktur:

• Eröffnung: Führt mit der wichtigsten Entdeckung und gibt eine Vorschau auf zentrale Themen.
• Hauptteil: Nach Thema (nicht nach Quelle) organisiert, mit Inline-Quellenangaben und [n] Zitationsmarkern, fettgedruckten Key-Finding-Rufen und optionalen [CHART SUGGESTION] Markierungen.
• Wichtige Erkenntnisse: Drei bis fünf prägnante, umsetzbare Stichpunkte.
• Footer: Vertrauensbewertung (hoch zu niedrig), Datenaktualität und bemerkenswerte Lücken.

Research Component

Research Component fasst Informationen aus mehreren Quellen zu einem umfassenden Forschungsbericht zusammen. Es verwendet eine dreistufige KI-Pipeline zur Planung, Forschung und Zusammenstellung von Ergebnissen.

Wann zu verwenden: Wettbewerbsanalyse, Marktforschung, Politiküberprüfung oder jedes Szenario, das eine konsolidierte Übersicht über mehrere Informationsquellen hinweg erfordert.

Wie die Forschungskomponente funktioniert

1. Der Nutzer stellt eine Forschungsfrage oder ein Thema zur Verfügung.
2. Phase 1 (Forschungsplaner): Erstellt einen strukturierten Forschungsplan mit Abschnitten und Abfragen.
3. Stufe 2 (Content Synthesizer): Durchsucht Webquellen für jeden Abschnitt und generiert Inhalte mit Zitaten.
4. Stufe 3 (Berichtsfinalisierer): Kombiniert alle Abschnitte und Zitate zu einem ausgefeilten Bericht.
5. Der Abschlussbericht wird direkt im Gespräch angezeigt.

Forschungskomponenten-Inputs

Ergebnisse der Forschungskomponenten

Die Komponente zeigt den Bericht direkt im Gespräch an.

Komponente des Executive Briefings

Executive Brief Component erzeugt prägnante, entscheidungsorientierte Zusammenfassungen aus komplexen Eingaben. Es verwendet eine dreistufige KI-Pipeline, um Erkenntnisse zu planen, zu synthetisieren und ein ausgefeiltes Executive Briefing zu erstellen.

Wann zu verwenden: Vorbereitung auf Vorstandssitzungen, Aktualisierungen des Projektstatus, vierteljährliche Geschäftsüberprüfungen oder jedes Szenario, das eine ausgefeilte Zusammenfassung für die Stakeholder erfordert.

Wie Executive Brief-Komponente funktioniert

1. Der Nutzer gibt ein kurzes Thema oder eine Frage an.
2. Phase 1 (Executive Brief Planner): Erstellung eines strategischen Forschungsplans mit Forschungsbereichen.
3. Stufe 2 (Insight Synthesizer, betrieben von Content Synthesizer): Durchsucht interne und Webquellen für jeden Bereich und extrahiert wichtige Fakten und Zitate.
4. Stufe 3 (Brief-Finalizer): Fasst alle Erkenntnisse und Zitate zu einem ausgefeilten Executive Brief zusammen.
5. Das Briefing wird direkt im Gespräch angezeigt.

Executive Brief Komponenteneingaben

Executive Brief Komponentenausgaben

Die Komponente zeigt das Executive Briefing direkt im Gespräch an.

ServiceNow Ticket Assistant

ServiceNow Ticket Assistant bietet das End-to-End-Vorfallmanagement von ServiceNow direkt von einem Copilot Studio-Agenten an. Sie umfasst fünf Themen, die den gesamten Vorfalllebenszyklus abdecken.

Wann sollte man nutzen: IT-Helpdesk, Mitarbeiter-Self-Service oder jedes Szenario, das ServiceNow-Incident Management beinhaltet.

ServiceNow beinhaltete Themen

ServiceNow prerequisites

Diese Komponente wird in ihrer eigenen Lösung ausgeliefert (CopilotStudioKit_ServiceNow_Components), da sie beim Import eine ServiceNow-Verbindungsreferenz benötigt. Bevor Sie diese Lösung importieren, stellen Sie sicher, dass Sie:

• Eine ServiceNow-Instanz mit REST-API-Zugriff.
• Eine in Power Platform für ServiceNow konfigurierte Verbindung. Du wirst aufgefordert, dies während des Lösungsimports einzurichten.
• Geeignete ServiceNow-Benutzerberechtigungen für die benötigten Operationen.

ServiceNow-Service-Principal-Einrichtung

Um eine ServiceNow Power Platform-Verbindung einzurichten, die Microsoft Entra ID verwendet, folgen Sie den Schritten in Wie man eine ServiceNow Power Platform-Verbindung einrichtet, die Microsoft Entra ID verwendet.

Wie ServiceNow Ticket Assistant funktioniert

1. Der Nutzer äußert eine Absicht (zum Beispiel "Ich muss ein Ticket erstellen" oder "Wie ist der Status von INC0012345?").
2. Das entsprechende Thema wird ausgelöst und präsentiert eine adaptive Karte, um die erforderlichen Eingaben zu sammeln.
3. Die Komponente ruft die ServiceNow-API über einen Connector auf und liefert das Ergebnis zurück.
4. Nachdem die Operation abgeschlossen ist, präsentiert das Thema Nächste Aktionen Optionen für den nächsten Schritt.

Create incident

Erstellt einen neuen ServiceNow-Vorfall, indem Daten vom Nutzer gesammelt und über einen Connector an ServiceNow übermittelt werden.

Wann sollte man es nutzen: IT-Helpdesk, Mitarbeiter-Self-Service oder jede Situation, in der Nutzer neue Vorfälle direkt aus dem Gespräch protokollieren müssen.

Erzeugen Sie einen Vorfallfluss

1. Der Nutzer äußert die Absicht, einen Vorfall zu erstellen, wie zum Beispiel: "Ich muss ein Ticket für einen kaputten Laptop erstellen."
2. Eine adaptive Karte sammelt die erforderlichen Vorfalldetails.
3. Die Komponente ruft die ServiceNow-API auf, um den Vorfall zu erstellen, und gibt eine Bestätigung mit der Vorfallnummer zurück.
4. Ein Menü "Nächste Aktionen" wird angezeigt, damit der Benutzer mit einer weiteren ServiceNow-Operation fortfahren kann.

Erstellen Sie Incident-Eingaben über eine adaptive Karte

Erstellen von Incident-Ausgaben

Bestätigungsmeldung mit der erstellten Vorfallsnummer im Inline.

Überprüfen Sie den Vorfallstatus

Ruft den neuesten Status und Details eines bestehenden ServiceNow-Vorfalls ab.

Überprüfen Sie den Vorfallstatusfluss

1. Der Nutzer fragt zum Beispiel nach einem Vorfall: "Wie ist der Status von INC0010002?"
2. Eine adaptive Karte sammelt die Vorfallsnummer.
3. Die Komponente fragt ServiceNow ab und liefert die Vorfalldetails zurück.

Überprüfen Sie den Eintrittsstatus über die adaptive Karte

Überprüfen Sie die Ausgaben des Vorfallstatus

Vorfall lösen oder schließen

Aktualisiert den Status eines bestehenden ServiceNow-Vorfalls auf Gelöst, Geschlossen, Storniert, Auf Eis oder In Bearbeitung sowie Details zur Lösung.

Inzwischenfluss auflösen oder schließen

1. Der Nutzer äußert die Absicht, einen Vorfall zu lösen oder zu schließen, wie zum Beispiel "Ticket INC0010002 schließen."
2. Eine adaptive Karte sammelt die Incident-Nummer, den Zielzustand, den Auflösungscode und die Auflösungsnotizen.
3. Die Komponente aktualisiert den Vorfall in ServiceNow und liefert eine Bestätigung.

Vorfallvoraussetzungen lösen oder schließen

Eine ServiceNow-Instanz mit REST-API-Zugang und einer ServiceNow-Verbindung in Power Platform.

Lösen oder schließen Sie einfallende Eingaben über eine adaptive Karte

Einfallende Ausgaben lösen oder schließen

Bestätigungsmeldung mit dem aktualisierten Vorfallsstatus in der Reihe angezeigt.

Sammeln Sie aktuelle Vorfälle

Ruft bis zu 10 aktuelle ServiceNow-Vorfälle für den aktuellen Nutzer ab und zeigt sie an. Es werden keine Eingabefelder benötigt. Die Komponente verwendet automatisch die E-Mail des angemeldeten Nutzers.

Wann zu verwenden: Wenn Nutzer einen schnellen Überblick über ihre aktuellen oder offenen Vorfälle wünschen.

Erhalten Sie den aktuellen Vorfallfluss

1. Der Nutzer fragt nach seinen Vorfällen, zum Beispiel "Zeigt meine jüngsten Vorfälle."
2. Die Komponente fragt ServiceNow nach bis zu 10 aktuellen Vorfällen ab, die mit der E-Mail-Adresse des angemeldeten Nutzers übereinstimmen.
3. Vorfalldetails werden im Gespräch direkt angezeigt.

Erhalten Sie aktuelle Vorfälle

None. Die Komponente verwendet automatisch die E-Mail-Adresse des angemeldeten Nutzers.

Erhalten Sie die Ergebnisse der aktuellen Vorfälle

Panel für Komponentendetails

Wenn Sie eine Komponente aus der Agentenbibliothek im Copilot Agent Kit öffnen, zeigt das Detailpanel die Komponentenbeschreibung, Kategorie, Ein- und Ausgabevariablen sowie die verwendete Technologie an.

Um eine Komponente zu installieren und in einen Agenten-Workflow einzubauen, siehe Komponentenverwaltung.

Verwenden Sie Komponenten mit einer verwalteten Lösung

Nutze die verwaltete Lösung für die meisten Nutzer. Die importierten Komponenten sind schreibgeschützt. Du kannst sie deinen Agenten hinzufügen und nutzen, ohne Gefahr zu laufen, versehentlich die zugrundeliegenden Themen, Prompts oder Flows zu verändern.

Auch ohne die Komponenten selbst zu bearbeiten, gibt es zwei Möglichkeiten, das Verhalten zu steuern: Agentenbefehle und Werkzeugeingabe-Standardeinstellungen.

Agent instructions

Das Instruktionsfeld Ihres Copilot Studio-Agenten ist die Hauptmethode, um die Verwendung von Komponenten zu gestalten. Durch natürliche Sprachanweisungen können Sie Folgendes steuern:

• Wenn eine Komponente aufgerufen wird: Beschreiben Sie die Szenarien oder Benutzerabsichten, die jedes Tool auslösen sollten.
• Welche Daten übermittelt werden: Sagen Sie dem Agenten, welchen Kontext, welche Variablen oder die Gesprächshistorie enthalten sein soll.
• Wie die Ergebnisse präsentiert werden: Geben Sie Formatierung, Ton, Folgeaktionen oder Routing an, nachdem eine Komponente ihre Ausgabe zurückgegeben hat.
• Gesamtorchestrierung: Definieren Sie die Reihenfolge der Operationen, wenn mehrere Komponenten beteiligt sind, wie zum Beispiel: "Nach Abschluss der Forschung erstellen Sie ein Executive Briefing aus den Ergebnissen."

Werkzeugeingabe-Standardeinstellungen

Wenn du Komponenten als Werkzeuge hinzufügst, wie zum Beispiel AI Builder-Prompts, kannst du Eingabeparameter direkt im Copilot Studio konfigurieren, selbst wenn du eine verwaltete Lösung nutzt. Diese Eingaben ermöglichen es dir, Standardwerte zu setzen, die spezifischer sind als das, was Agenten-Anweisungen allein erreichen können. For example:

• Stellen Sie eine Standardlösung ExtractionSchema bereit, die auf Ihre Geschäftsdokumente zugeschnitten ist, wie z. B. Rechnungsfelder wie Name, Rechnungsnummer und Datum.
• Füllen Sie vorab mit dem bevorzugten Schreibstil oder den Compliance-Anforderungen Ihrer Organisation aus.AdditionalInstructions

Eingabe-Standardwerte werden pro Agent konfiguriert, sodass verschiedene Agenten unterschiedliche Werte an dieselbe gemeinsame Komponente weitergeben können.

Komponenten mit einer unmanaged Lösung anpassen

Wenn Sie die Komponenten-Interna ändern müssen, wie z. B. die Eingabeaufforderungslogik ändern, Themenflüsse bearbeiten oder Anschlüsse neu verdrahten, müssen Sie die nicht verwaltete Lösung importieren. Diese Lösung gibt Ihnen vollen Bearbeitungszugriff auf jedes Thema, jede Eingabeaufforderung und jeden Fluss in der Agentenbibliothek.

Häufige Anpassungen sind:

• Eingabeaufforderungen anpassen: Passen Sie die AI Builder-Eingaben an Ihre Domain und Ihr Ausgabeformat an.
• Datenquellen ändern: Weisen Sie Komponenten auf Ihre eigenen Dataverse-Tabellen, SharePoint-Listen oder externe Connectors.
• Passen Sie Themen an: Aktualisieren Sie die Gesprächsabläufe an die Terminologie und Abläufe Ihrer Organisation.
• Aktualisieren Sie Triggerphrasen: Fügen Sie Triggerphrasen hinzu, die widerspiegeln, wie Ihre Nutzer natürlich nach Dingen fragen.
• Authentifizierung hinzufügen: Authentifizierung konfigurieren, wenn Komponenten auf benutzerspezifische Daten zugreifen müssen.

Related information

• Components management
• AI Builder-Dokumentation