Freigeben über


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 zum Generieren von Antworten mit Wissensquellen aus dem Web und Ihren Microsoft 365-Organisationsdaten zur Verfügung steht. 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 Erstellen deklarativer Agents mit dem Microsoft 365 Agents Toolkit abgeschlossen haben.

Hinzufügen der Websuche zum Agent

Durch das Hinzufügen der Websuche zu Ihrem Agent kann er im Web suchen, um Antworten zu generieren. Sie können das Wissen optional auf bestimmte Websites festlegen.

  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.

Screenshot: Antwort des deklarativen Agents mit Webinhalten

Hinzufügen einer SharePoint-Website zum Agent

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

  1. Öffnen Sie die appPackage/declarativeAgent.json Datei, und fügen Sie dem Array den capabilities folgenden Wert hinzu, und https://contoso.sharepoint.com/sites/ProductSupport ersetzen Sie dabei durch eine SharePoint-Website-URL in Ihrem 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 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 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, 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.

Screenshot: Antwort des deklarativen Agents mit SharePoint- und OneDrive-Inhalten

Hinzufügen von Teams-Nachrichten zum Agent

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

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

    Weitere Informationen finden Sie unter Teams-Nachrichtenobjekt.

    Hinweis

    • Die URL im URL-Objekt muss wohlgeformte Links zu einem Teams-Chat, Team- oder Besprechungschat sein.
    • Wenn Das urls Array nicht angegeben wird, werden alle Teams-Kanäle, Teams, Besprechungen, 1:1-Chats und Gruppenchats 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 Teams-Daten, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Screenshot: Antwort des deklarativen Agents, der Teams-Inhalte enthält

Hinzufügen von Personenwissen zum Agent

Mit der Wissensquelle "Personen" können Sie Ihren Agenten so festlegen, dass er Fragen zu Personen in einem organization beantwortet.

  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 Personen-Objekt.

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

Der deklarative Agent hat Zugriff auf Personenwissen, nachdem Sie die Seite neu geladen haben.

Screenshot: Antwort des deklarativen Agents mit Personenwissen

Hinzufügen von E-Mail-Nachrichten zum Agent

Mit der E-Mail-Wissensquelle können Sie Ihren Agent so festlegen, dass E-Mails aus dem Postfach des Benutzers oder ein freigegebenes Postfach zum Beantworten von Abfragen verwendet werden.

  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 Email-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 auf die E-Mail-Adresse des freigegebenen Postfachs festgelegt ist.
    • Das folders Array beschränkt den Postfachzugriff auf bestimmte Ordner. Lassen Sie das Array aus, um auf das folders gesamte Postfach zuzugreifen.
  2. Wählen Sie im Bereich Lebenszyklus des Teams-Toolkits die Option Bereitstellen aus.

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

Screenshot: Antwort des deklarativen Agents mit E-Mail-Informationen

Hinzufügen eines Microsoft 365 Copilot-Connectors zum Agent

Durch das Hinzufügen eines Copilot-Connectors werden die von diesem Connector erfassten Elemente für den Agent als Wissensquelle verfügbar.

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

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

    Weitere Informationen finden Sie unter Copilot Connectors-Objekt.

    Hinweis

    • Wenn das connections Array nicht angegeben wird, werden alle Copilot-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 Agents-Toolkits die Option Bereitstellen aus.

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

Screenshot: Antwort des deklarativen Agents mit Inhalt des Copilot-Connectors

Nächster Schritt