Hinzufügen von Wissensquellen zu einem deklarativen Agent, der mit dem Microsoft 365 Agents-Toolkit erstellt wurde

Sie können das Wissen steuern, das Ihrem Agent zur Verfügung steht, um Antworten mit Wissensquellen aus dem Web und Ihren Microsoft 365-Organisationsdaten zu generieren. Eine vollständige Liste der verfügbaren Wissensquellen finden Sie unter Hinzufügen von Wissensquellen zu Ihrem deklarativen Agent.

Wichtig

In diesem Leitfaden wird davon ausgegangen, dass Sie das Tutorial zum Erstellen deklarativer Agents mithilfe des Microsoft 365 Agents Toolkit und JSON abgeschlossen haben.

Hinzufügen einer Websuche zum Agent

Wenn Sie Ihrem Agent eine Websuche hinzufügen, kann er das Web durchsuchen, um Antworten zu generieren. Optional können Sie den Umfang des Wissens auf bestimmte Websites begrenzen.

  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 Microsoft 365 Agents Toolkit die Option "Bereitstellen" aus.

Der deklarative Agent hat Zugriff auf Webinhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Screenshot mit einer Antwort des deklarativen Agents, der Webinhalte enthält

Hinzufügen einer SharePoint-Website zum Agent

Sie können Dateien in OneDrive oder die Inhalte von SharePoint-Websites als Wissensquelle hinzufügen.

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, fügen Sie den folgenden Wert zum Array hinzu und ersetzen Sie https://contoso.sharepoint.com/sites/ProductSupport ihn capabilities durch eine SharePoint-Website-URL in Ihrer Microsoft 365-Organization.

    {
      "name": "OneDriveAndSharePoint",
      "items_by_url": [
        {
          "url": "https://contoso.sharepoint.com/sites/ProductSupport"
        }
      ]
    }
    

    Weitere Informationen finden Sie unter OneDrive- und SharePoint-Objekt.

    Hinweis

    • URLs sollten ein vollständiger Pfad zu SharePoint-Elementen (Website, Dokumentbibliothek, Ordner oder Datei) sein. Sie können die Option "Direktlink kopieren" in SharePoint verwenden, um den vollständigen Pfad von Dateien und Ordnern abzurufen. Klicken Sie mit der rechten Maustaste auf die Datei oder den Ordner, und wählen Sie "Details" aus. Navigieren Sie zu Pfad , und wählen Sie das Kopiersymbol aus.
    • Wenn das items_by_url Array (oder das alternative items_by_sharepoint_ids Array) nicht angegeben wird, sind alle OneDrive- und SharePoint-Inhalte in Ihrer Microsoft 365-organization, die dem angemeldeten Benutzer zur Verfügung stehen, auch für den Agent verfügbar.
  2. Wählen Sie im Bereich "Lebenszyklus" des Agents-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.

Screenshot mit einer Antwort des deklarativen Agents, der SharePoint- und OneDrive-Inhalte enthält

Hinzufügen von Teams-Nachrichten zum Agent

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, fügen Sie dem Array den folgenden Wert hinzu, und ersetzen https://teams.microsoft.com/l/team/... Sie ihn capabilities durch einen Teams-Kanal oder eine Team-URL aus Ihrer organization.

    {
      "name": "TeamsMessages",
      "urls": [
        {
          "url": "https://teams.microsoft.com/l/team/..."
        }
      ]
    }
    

    Weitere Informationen finden Sie unter Microsoft Teams-Nachrichtenobjekt.

    Hinweis

    • Die URL in der url Eigenschaft muss ein wohlgeformter Link zu einem Teams-Chat, -Team oder -Besprechungschat sein.
    • Wenn das urls Array nicht angegeben wird, stehen alle Teams-Kanäle, Teams, Besprechungen, 1:1-Chats und Gruppenchats in Ihrer Microsoft 365-Organisation, die dem angemeldeten Benutzer zur Verfügung stehen, dem Agent zur Verfügung.
  2. Wählen Sie im Bereich "Lebenszyklus" des Agents-Toolkits die Option "Bereitstellen" aus.

Der deklarative Agent hat Zugriff auf Teams-Daten, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Screenshot mit einer Antwort des deklarativen Agents, die Teams-Inhalte enthält

Hinzufügen von Personenwissen zum Agent

Mit der Wissensquelle "Kontakte" können Sie den Umfang Ihres Agents festlegen, um Fragen zu Personen in einer Organization zu beantworten.

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und fügen Sie den People Eintrag zum capabilities Array hinzu.

    {
      "name": "People"
    }
    

    Weitere Informationen finden Sie unter People object.

  2. Wählen Sie im Bereich "Lebenszyklus" des Agents-Toolkits die Option "Bereitstellen" aus.

Der deklarative Agent hat Zugriff auf das Wissen der Personen, nachdem Sie die Seite neu geladen haben.

Screenshot mit einer Antwort des deklarativen Agents, die Personenwissen enthält

Hinzufügen von E-Mail-Nachrichten zum Agent

Mit der E-Mail-Wissensquelle können Sie den Umfang Ihres Agents so festlegen, dass er E-Mails aus dem Postfach des Benutzers oder einem freigegebenen Postfach zur Beantwortung von Abfragen verwendet.

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und fügen Sie den Email Eintrag zum capabilities Array hinzu.

    {
      "name": "Email",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
    

    Weitere Informationen finden Sie unter E-Mail-Objekt.

    Hinweis

    • In diesem Beispiel wird auf den Benutzer des Postfachs des Agents zugegriffen. Um stattdessen auf ein freigegebenes Postfach zuzugreifen, fügen Sie die optionale shared_mailbox Eigenschaft hinzu, die für die E-Mail-Adresse des freigegebenen Postfachs festgelegt ist.
    • Das folders Array beschränkt den Postfachzugriff auf bestimmte Ordner. Wenn Sie auf das gesamte Postfach zugreifen möchten, lassen Sie das folders Array weg.
  2. Wählen Sie im Bereich "Lebenszyklus" des Agents-Toolkits die Option "Bereitstellen" aus.

Der deklarative Agent hat Zugriff auf E-Mail-Wissen, nachdem Sie die Seite neu geladen haben.

Screenshot mit einer Antwort des deklarativen Agents, die E-Mail-Wissen enthält

Hinzufügen eines Copilot-Connectors zum Agent

Durch das Hinzufügen eines Copilot-Connectors stehen die von diesem Connector aufgenommenen Elemente dem Agent als Wissensquelle zur Verfügung.

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, fügen Sie dem Array den folgenden Wert hinzu und ersetzen policieslocal Sie ihn capabilities durch eine gültige Copilot-Connector-ID in Ihrer Microsoft 365-organization. Weitere Informationen zum Suchen von Copilot-Connector-IDs finden Sie unter Abrufen von Funktions-IDs für das deklarative Agentmanifest.

    {
      "name": "GraphConnectors",
      "connections": [
        {
          "connection_id": "policieslocal"
        }
      ]
    }
    

    Weitere Informationen finden Sie unter Copilot-Connectors-Objekt.

    Hinweis

    • Wenn das connections Array nicht angegeben wird, sind alle Copilot-Connectors-Inhalte in Ihrer Microsoft 365-Organisation, die dem angemeldeten Benutzer zur Verfügung stehen, auch für den Agent verfügbar.
  2. Wählen Sie im Bereich "Lebenszyklus" des Agents-Toolkits die Option "Bereitstellen" aus.

Der deklarative Agent hat Zugriff auf Copilot-Connectorinhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Screenshot einer Antwort des deklarativen Agents, die Copilot-Connectorinhalt enthält

Nächster Schritt