Erstellen deklarativer Agents mithilfe des Teams-Toolkits
Ein deklarativer Agent ist eine angepasste Version von Microsoft 365 Copilot, mit der Benutzer personalisierte Erfahrungen erstellen können, indem sie bestimmte Anweisungen, Aktionen und Kenntnisse deklarieren. Dieser Leitfaden enthält Informationen zum Erstellen eines deklarativen Agents mithilfe des Teams-Toolkits.
Eine Übersicht finden Sie unter Deklarative Agents für Microsoft 365 Copilot.
Wichtig
Deklarative Agents für Microsoft 365 sind derzeit allgemein verfügbar. Während des gestaffelten Rollouts haben jedoch möglicherweise nicht alle Benutzer Zugriff.
Hinweis
Deklarative Agents, die auf Microsoft 365 Copilot basieren, werden jetzt in Word und PowerPoint unterstützt.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Microsoft 365 Copilot für Ihre organization verfügbar ist.
Die folgenden Optionen sind für Ihre Entwicklungsumgebung verfügbar:
- Eine Sandbox von Microsoft 365 organization mit Copilot (in eingeschränkter Vorschau über DIE TAP-Mitgliedschaft verfügbar).
- Eine berechtigte Microsoft 365- oder Office 365-Produktionsumgebung mit einer Microsoft 365 Copilot-Lizenz.
Die folgenden Ressourcen sind erforderlich, um die in diesem Artikel beschriebenen Schritte auszuführen:
- Teams Toolkit Visual Studio Code-Erweiterung , Version 5.10.0 oder höher
- Kiota Visual Studio Code-Erweiterungsversion 1.19.100000002 oder höher
Sie sollten mit den folgenden Standards und Richtlinien für deklarative Agents für Microsoft 365 Copilot vertraut sein:
- Standards für Compliance, Leistung, Sicherheit und Benutzererfahrung, die in den Teams Store-Validierungsrichtlinien beschrieben sind.
Erstellen eines deklarativen Agents
Erstellen Sie zunächst einen einfachen deklarativen Agent.
Öffnen Sie Visual Studio Code.
Wählen Sie Teams Toolkit > Neue App erstellen aus.
Wählen Sie Agent aus.
Wählen Sie Deklarativer Agent aus.
Wählen Sie Kein Plug-In aus, um einen einfachen deklarativen Agent zu erstellen.
Wählen Sie Standardordner aus, um ihren Projektstammordner am Standardspeicherort zu speichern.
Geben Sie
My Agentals Anwendungsname ein , und drücken Sie die EINGABETASTE.Wählen Sie im neuen Visual Studio Code-Fenster, das geöffnet wird, teams Toolkit und dann im Bereich Lebenszyklus die Option Bereitstellen aus.
Testen des Agents
Navigieren Sie zur Copilot-Anwendung mit der URL https://www.microsoft365.com/chat.
Wählen Sie neben der Schaltfläche Neuer Chat das Symbol für die Unterhaltungsschublade aus.
Wählen Sie den deklarativen Agent My Agent aus.
Geben Sie eine Frage an Ihren deklarativen Agent ein, und stellen Sie sicher, dass er mit "Vielen Dank für die Verwendung des Teams Toolkits zum Erstellen Ihres deklarativen Agents!" antwortet.
Hinzufügen von Anweisungen
In diesem Abschnitt fügen Sie dem Agent Anweisungen hinzu, um sein Verhalten zu ändern.
Öffnen Sie die
appPackage/instructions.txtDatei, und ersetzen Sie ihren Inhalt durch den folgenden Text.You are a declarative agent and were created with Team Toolkit. You are an expert at creating poems. Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text.Der Inhalt dieser Datei wird während der Bereitstellung in die
instructions-Eigenschaft im Manifest des Agents eingefügt. Weitere Informationen finden Sie unter Manifestobjekt des deklarativen Agents.Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Der deklarative Agent verwendet Die aktualisierten Anweisungen, nachdem Sie die Seite neu geladen haben.
Hinzufügen von Unterhaltungsstartern
In diesem Abschnitt fügen Sie Ihrem Agent Konversationsstarter hinzu. Unterhaltungsstarter sind Hinweise, die dem Benutzer angezeigt werden, um zu veranschaulichen, wie er mit dem deklarativen Agent beginnen kann.
Öffnen Sie die
appPackage/declarativeAgent.jsonDatei, und fügen Sie dasconversation_startersArray mit folgendem Inhalt hinzu:"conversation_starters": [ { "title": "Getting Started", "text": "How can I get started with Teams Toolkit?" }, { "title": "Getting Help", "text": "How can I get help with Teams Toolkit?" } ]Weitere Informationen finden Sie unter Conversation Starters-Objekt.
Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Die aktualisierten Konversationsstarter sind in Ihrem deklarativen Agent verfügbar, nachdem Sie die Seite aktualisiert haben.
Hinzufügen von Webinhalten
In diesem Abschnitt fügen Sie dem Agent die Möglichkeit zum Durchsuchen des Webs hinzu.
Öffnen Sie die
appPackage/declarativeAgent.jsonDatei, und fügen Sie dascapabilitiesArray mit dem folgenden Inhalt hinzu."capabilities": [ { "name": "WebSearch" } ]Weitere Informationen finden Sie unter Websuchobjekt.
Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Der deklarative Agent hat Zugriff auf Webinhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.
Hinzufügen von OneDrive- und SharePoint-Inhalten
In diesem Abschnitt fügen Sie den Inhalt einer SharePoint-Website dem verfügbaren Wissen für den Agent hinzu.
Öffnen Sie die
appPackage/declarativeAgent.jsonDatei, und aktualisieren Sie dascapabilitiesArray auf den folgenden Wert. Ersetzen Siehttps://contoso.sharepoint.com/sites/ProductSupportdabei durch eine SharePoint-Website-URL in Ihrem Microsoft 365-organization."capabilities": [ { "name": "WebSearch" }, { "name": "OneDriveAndSharePoint", "items_by_url": [ { "url": "https://contoso.sharepoint.com/sites/ProductSupport" } ] } ]Weitere Informationen finden Sie unter OneDrive- und SharePoint-Objekt.
Hinweis
- URLs sollten der vollständige Pfad zu SharePoint-Elementen (Website, Dokumentbibliothek, Ordner oder Datei) sein. Sie können die Option "Direkten Link kopieren" in SharePoint verwenden, um den vollständigen Pfad oder die Dateien und Ordner abzurufen. Klicken Sie dazu mit der rechten Maustaste auf die Datei oder den Ordner, und wählen Sie Details aus. Navigieren Sie zu Pfad , und klicken Sie auf das Kopiersymbol.
- Wenn das
items_by_urlArray (oder das alternativeitems_by_sharepoint_idsArray) nicht angegeben wird, werden alle OneDrive- und SharePoint-Inhalte in Ihrem Microsoft 365-organization, der für den angemeldeten Benutzer verfügbar ist, für den Agent verfügbar sein.
Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Der deklarative Agent hat Zugriff auf OneDrive- und SharePoint-Inhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.
Hinzufügen von Inhalten zu Microsoft Graph-Connectors
In diesem Abschnitt fügen Sie dem verfügbaren Wissen für den Agent elemente hinzu, die von einem Microsoft Graph-Connector erfasst wurden.
Öffnen Sie die
appPackage/declarativeAgent.jsonDatei, und aktualisieren Sie dascapabilitiesArray auf den folgenden Wert. Ersetzen Siepolicieslocaldabei durch eine gültige Microsoft Graph-Connector-ID in Ihrem Microsoft 365-organization. Weitere Informationen zum Ermitteln von Microsoft Graph-Connector-IDs finden Sie unter Abrufen von Funktions-IDs für das manifest des deklarativen Agents."capabilities": [ { "name": "WebSearch" }, { "name": "OneDriveAndSharePoint", "items_by_url": [ { "url": "https://contoso.sharepoint.com/sites/ProductSupport" } ] }, { "name": "GraphConnectors", "connections": [ { "connection_id": "policieslocal" } ] } ]Weitere Informationen finden Sie unter Microsoft Graph-Connectors-Objekt.
Hinweis
- Wenn das
connectionsArray nicht angegeben wird, werden alle Microsoft Graph-Connectors in Ihrem Microsoft 365-organization, der für den angemeldeten Benutzer verfügbar ist, für den Agent verfügbar sein.
- Wenn das
Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Der deklarative Agent hat Zugriff auf Inhalte von Microsoft Graph-Connectors, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.
Hinzufügen von API-Plug-Ins
In diesem Abschnitt fügen Sie Ihrem Agent ein API-Plug-In hinzu. Plug-Ins fügen Ihrem Agent neue Funktionen hinzu, indem sie Ihrem Agent die Interaktion mit einer REST-API ermöglichen.
Sie können Ihrem Agent entweder mit dem Teams Toolkit oder der Kiota Visual Studio Code-Erweiterung ein Plug-In hinzufügen.
Bevor Sie beginnen, erstellen Sie eine Datei mit dem Namen, posts-api.yml und fügen Sie den Code aus dem OpenAPI-Beschreibungsdokument der Posts-API hinzu.
Wählen Sie im Bereich Entwicklung von Teams Toolkit die Option Plug-In hinzufügen aus.
Wählen Sie Mit einem OpenAPI-Beschreibungsdokument beginnen aus.
Wählen Sie Durchsuchen aus, und navigieren Sie zur
posts-api.ymlDatei.Wählen Sie alle verfügbaren APIs und dann OK aus.
Wählen Sie manifest.json aus.
Überprüfen Sie die Warnung im Dialogfeld. Wenn Sie bereit sind, den Vorgang fortzusetzen, wählen Sie Hinzufügen aus.
Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.
Der deklarative Agent hat Zugriff auf Ihre Plug-In-Inhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.
Post api OpenAPI description document
Die folgende OpenAPI-Beschreibung gilt für die JSONPlaceHolder-API, eine kostenlose Online-REST-API, die Sie verwenden können, wenn Sie gefälschte Daten benötigen.
openapi: '3.0.2'
info:
title: Posts API
version: '1.0'
servers:
- url: https://jsonplaceholder.typicode.com/
components:
schemas:
post:
type: object
properties:
userId:
type: integer
description: The ID of the user that authored the post.
id:
type: integer
title:
type: string
body:
type: string
user:
type: object
properties:
id:
type: integer
name:
type: string
username:
type: string
email:
type: string
phone:
type: string
website:
type: string
address:
$ref: '#/components/schemas/address'
company:
$ref: '#/components/schemas/company'
address:
type: object
properties:
street:
type: string
suite:
type: string
city:
type: string
zipcode:
type: string
geo:
$ref: '#/components/schemas/coordinates'
coordinates:
type: object
properties:
lat:
type: string
description: The latitude of the location
lng:
type: string
description: The longitude of the location
company:
type: object
properties:
name:
type: string
catchPhrase:
type: string
bs:
type: string
parameters:
post-id:
name: post-id
in: path
description: 'key: id of post'
required: true
style: simple
schema:
type: integer
user-id:
name: user-id
in: path
description: 'key: id of user'
required: true
style: simple
schema:
type: integer
paths:
/posts:
get:
description: Get posts
operationId: GetPosts
parameters:
- name: userId
in: query
description: Filter results by user ID
required: false
style: form
schema:
type: integer
maxItems: 1
- name: title
in: query
description: Filter results by title
required: false
style: form
schema:
type: string
maxItems: 1
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/post'
post:
description: 'Create post'
operationId: CreatePost
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/post'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/post'
/posts/{post-id}:
get:
description: 'Get post by ID'
operationId: GetPostById
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/post'
patch:
description: 'Update post'
operationId: UpdatePost
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/post'
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/post'
delete:
description: 'Delete post'
operationId: DeletePost
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
/users:
get:
summary: Get users
description: Returns details about users
operationId: GetUsers
parameters:
- name: name
in: query
description: The user's real name
schema:
type: string
- name: username
in: query
description: The user's login name
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user'
/users/{user-id}:
get:
description: 'Get user by ID'
operationId: GetUserById
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/user'
Herzlichen Glückwunsch!
Sie haben den Leitfaden für den deklarativen Agent für Microsoft 365 Copilot abgeschlossen. Nachdem Sie nun mit den Funktionen eines deklarativen Agents vertraut sind, können Sie in den folgenden Artikeln mehr über deklarative Agents erfahren.
- Erfahren Sie, wie Sie effektive Anweisungen für Ihren Agent schreiben.
- Hier erhalten Sie Antworten auf häufig gestellte Fragen.
- Erfahren Sie mehr über eine alternative Methode zum Erstellen deklarativer Agents mit Copilot Studio Agent Builder.
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.