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.

Der Agent, den Sie in diesem Tutorial erstellen, zielt auf lizenzierte Microsoft 365 Copilot Benutzer ab. Sie können auch Agents für Microsoft 365 Copilot Chat Benutzer mit eingeschränkten Funktionen erstellen. Weitere Informationen finden Sie unter Agent-Funktionen für Microsoft 365-Benutzer.

Eine Übersicht finden Sie unter Deklarative Agents für Microsoft 365 Copilot.

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

• 0 Minuten verbleibend

Erstellen Sie zunächst einen einfachen deklarativen Agent.

1. Öffnen Sie Visual Studio Code.

2. Wählen Sie Teams Toolkit > Neue App erstellen aus.

   

3. Wählen Sie Agent aus.

   

4. Wählen Sie Deklarativer Agent aus.

5. Wählen Sie Kein Plug-In aus, um einen einfachen deklarativen Agent zu erstellen.

6. Wählen Sie Standardordner aus, um ihren Projektstammordner am Standardspeicherort zu speichern.

7. Geben Sie My Agent als Anwendungsname ein , und drücken Sie die EINGABETASTE.

8. 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

1. Navigieren Sie zur Copilot-Anwendung mit der URL https://m365.cloud.microsoft/chat.

2. Wählen Sie neben der Schaltfläche Neuer Chat das Symbol für die Unterhaltungsschublade aus.

3. Wählen Sie den deklarativen Agent My Agent aus.

   

4. 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

• 0 Minuten verbleibend

In diesem Abschnitt fügen Sie dem Agent Anweisungen hinzu, um sein Verhalten zu ändern.

1. Öffnen Sie die appPackage/instructions.txt Datei, 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.

2. 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

• 0 Minuten verbleibend

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.

1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und fügen Sie das conversation_starters Array 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.

2. 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

• 0 Minuten verbleibend

In diesem Abschnitt fügen Sie dem Agent die Möglichkeit zum Durchsuchen des Webs hinzu.

1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und fügen Sie das capabilities Array mit dem folgenden Inhalt hinzu.

   "capabilities": [
       {
           "name": "WebSearch"
       }
   ]
   

   Weitere Informationen finden Sie unter Websuchobjekt.

2. 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

• 0 Minuten verbleibend

In diesem Abschnitt fügen Sie den Inhalt einer SharePoint-Website dem verfügbaren Wissen für den Agent hinzu.

1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und aktualisieren Sie das capabilities Array auf den folgenden Wert. Ersetzen Sie https://contoso.sharepoint.com/sites/ProductSupport dabei 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_url Array (oder das alternative items_by_sharepoint_ids Array) 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.

2. 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

• 0 Minuten verbleibend

In diesem Abschnitt fügen Sie dem verfügbaren Wissen für den Agent elemente hinzu, die von einem Microsoft Graph-Connector erfasst wurden.

1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und aktualisieren Sie das capabilities Array auf den folgenden Wert. Ersetzen Sie policieslocal dabei 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 connections Array 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.

2. 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

• 0 Minuten verbleibend

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.

"actions": [
    {
        "id": "postsPlugin",
        "file": "postsapi-apiplugin.json"
    }
]

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!

• 100 % abgeschlossen!

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.