Freigeben über


Hinzufügen von Wissensquellen zu Ihrem deklarativen Agent

Sie können die Benutzerfreundlichkeit Ihres deklarativen Agents verbessern, indem Sie Funktionen wie Codeinterpreter und Bildgenerator sowie Wissensquellen hinzufügen, um das Wissen Ihres Agents zu erweitern und anzupassen. Das Capabilities-Objekt in der Manifestreferenz und der Abschnitt Knowledge in Microsoft 365 Copilot ihnen mehrere Optionen zum Entsperren von Features für Ihre Benutzer bieten. In diesem Artikel werden die Wissensquellen beschrieben, die Sie Ihren Agents hinzufügen können.

Die folgende Tabelle enthält die Funktionen und Wissensquellen, die Sie mithilfe von Microsoft 365 Copilot oder Microsoft 365 Agents Toolkit konfigurieren können, und gibt an, ob Benutzer eine Microsoft 365 Copilot Lizenz oder eine getaktete Nutzung benötigen, um auf Agents mit dieser Funktion oder Wissensquelle zuzugreifen.

Funktion oder Wissensquelle Microsoft 365 Copilot Agents Toolkit Lizenz oder getaktete Nutzung erforderlich?
Code-Interpreter Nein
Bildgenerator Nein
Copilot-Connectors Ja
SharePoint Ja
OneDrive Ja
Eingebetteter Dateiinhalt Ja
Websuche Nein
Bereichsbezogene Websuche Nein
Datenumkehr ✅* Ja
E-Mail ✅* Ja (nur Lizenz)
Personen Ja (nur Lizenz)
Teams-Nachrichten ✅* Ja (nur Lizenz)
Teams-Besprechungen Ja (nur Lizenz)

* Die Option zum Festlegen des Wissensumfangs ist verfügbar.

Copilot-Connectors

Microsoft 365 Copilot Connectors ermöglichen es Ihnen, Ihrem Agent Organisationsdaten als Groundinginformationen hinzuzufügen. Sie können Copilot-Connectors verwenden, um Ihre Branchendaten in Microsoft Graph zu erfassen, und Copilot kann Ihre Daten als Erdungsinformationen in Antworten auf Benutzeraufforderungen ermitteln. Weitere Informationen finden Sie unter Übersicht über Microsoft 365 Copilot Connectors.

Informationen zum Hinzufügen von Copilot-Connectors als Wissen zu Ihrem Agent-Manifest im Agents Toolkit finden Sie unter Copilot-Connectors-Objekt.

Informationen zum Hinzufügen von Copilot-Connectors zu Ihrem Agent in Microsoft 365 Copilot finden Sie unter Copilot-Connectors.

SharePoint und OneDrive

Wenn Sie Ihren Agent für die Verwendung von OneDrive- und SharePoint-Inhalten als Wissen konfigurieren, durchsucht Copilot SharePoint- und OneDrive-Dateien, Ordner oder Websites, auf die ein Benutzer Zugriff hat, um Bodeninformationen zu erhalten.

Informationen zum Hinzufügen von OneDrive- und SharePoint-Wissen zu Ihrem Agentmanifest im Agents Toolkit finden Sie unter OneDrive und SharePoint-Objekt.

Informationen zum Hinzufügen von SharePoint-Wissen zu Ihrem Agent in Microsoft 365 Copilot finden Sie unter Hinzufügen von Wissensquellen.

Mit der Websuche können Agents den Suchindex in Bing verwenden, um auf Benutzeraufforderungen zu reagieren. Wenn Sie die Websuche in Ihrem Agent aktivieren, können Sie festlegen, dass Ihr Agent alle Webdaten in seinen Antworten zurückgibt. Sie können die Websuche auch auf bis zu vier öffentliche Websites festlegen.

Wichtig

Organisationsadministratoren können die Websuche für Copilot und alle Agents in ihren organization deaktivieren. Wenn Ihre Administratoren die Websuche deaktivieren, melden Agents mit aktivierter Websuche keinen Fehler und schließen keine Websuchen in ihr Wissen ein. Debugkarten im Entwicklermodus zeigen an, dass die Websuche aktiviert ist, wenn sie vom Agent aktiviert wurde, auch wenn sie von Ihren Administratoren deaktiviert wurde. Weitere Informationen finden Sie unter Verwalten von Microsoft 365 Copilot Szenarien im Microsoft 365 Admin Center.

Wenn Sie Agents Toolkit und Visual Studio Code verwenden, um Ihren Agent zu erstellen, fügen Sie den Wert zur Eigenschaft capabilities in Ihrer Manifestdatei hinzu, um die WebSearch Websuche zu aktivieren. Wenn Sie die Websuche auf bestimmte Websites festlegen möchten, fügen Sie die Eigenschaft sites hinzu, und geben Sie bis zu vier URLs an, wie im folgenden Beispiel gezeigt.

Hinweis

Sie müssen Version 1.2 oder höher des Manifestschemas des deklarativen Agents verwenden, um Ihrem Agent eine bereichsbezogene Websuche hinzuzufügen.

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "cnn.com"
        }
      ]
    }
  ]
}

Wenn Sie Microsoft 365 Copilot verwenden, um Ihren Agent zu erstellen, listen Sie auf der Registerkarte Konfigurieren unter Wissen die Website-URLs auf, auf die Sie verweisen möchten.

Eingebetteter Dateiinhalt

Wenn Sie Microsoft 365 Copilot verwenden, um Ihren Agent zu erstellen, können Sie Dateien direkt von Ihrem Gerät oder der Cloud hochladen, um die Inhalte einzubetten, die Ihr Agent als Wissen verwenden kann. Der eingebettete Dateiinhalt wird in SharePoint Embedded gespeichert. Diese Dateien werden auf die OneDrive- und SharePoint-Kapazität in Ihrem Mandanten angerechnet.

Hinweis

  • Die Dateiuploadfunktion steht Benutzern mit aktivierter Nutzungsabrechnung oder einer Microsoft 365 Copilot-Lizenz zur Verfügung.
  • Eingebettete Dateiinhalte werden in GCCM-Umgebungen (Microsoft 365 Government Community Cloud Moderate) nicht unterstützt.

Weitere Informationen zu eingebetteten Dateien finden Sie unter Eingebettete Dateiinhalte.

Wichtig

Microsoft Purview Information Barriers (IB) wird für eingebettete Dateien nicht unterstützt. Jeder Benutzer, der auf den Agent zugreifen kann, kann Antworten sehen, die im eingebetteten Dateiinhalt begründet sind.

Datenumkehr

Mit Dataverse-Wissen können Agents in natürlicher Sprache auf Benutzerabfragen zu ihren CRM-Daten oder Daten aus Tabellen in Microsoft Dataverse reagieren. Sie können eine Dataverse-instance als Wissensquelle hinzufügen und Synonyme und ein Glossar hinzufügen, damit das System benutzerdefinierte Daten in Ihren Tabellen besser interpretieren kann. Weitere Informationen finden Sie unter Hinzufügen einer Dataverse-Wissensquelle.

Hinweis

Dataverse-Wissen ist derzeit nicht in Microsoft 365 Copilot verfügbar.

Hinzufügen von Dataverse-Wissen

Wenn Sie Agents Toolkit und Visual Studio Code zum Erstellen Ihres Agents verwenden, fügen Sie den Dataverse Wert zur Aktivierung von Dataverse-Kenntnissen der Eigenschaft capabilities in Ihrer Agent-Manifestdatei hinzu, wie im folgenden Beispiel gezeigt.

Hinweis

Sie müssen Version 1.3 oder höher des Manifestschemas des deklarativen Agents verwenden, um Wissen hinzuzufügen Dataverse .

{
  "capabilities": [
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "organization.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    }
  ]
}

E-Mail

Email Können Sie Ihren Agent auf ein persönliches oder freigegebenes Postfach und optional auf einen bestimmten Postfachordner festlegen.

Hinzufügen von E-Mail-Wissensquellen

Wenn Sie Microsoft 365 Copilot verwenden, um Ihren Agent zu erstellen, wählen Sie auf der Registerkarte Konfigurieren im Abschnitt Wissen die Option Meine E-Mails aus.

Hinweis

Sie können Ihre E-Mails derzeit nicht auf einen bestimmten Ordner oder ein freigegebenes Postfach festlegen, wenn Sie Microsoft 365 Copilot verwenden.

Wenn Sie Agents Toolkit und Visual Studio Code verwenden, um Ihren Agent zu erstellen, fügen Sie zum Hinzufügen von E-Mail-Informationen den Email Wert zur Eigenschaft capabilities in Ihrer Agent-Manifestdatei hinzu, wie im folgenden Beispiel gezeigt. Sie können auf mehrere Postfachordner und nur auf einen freigegebenen Ordner verweisen.

Hinweis

Sie müssen Version 1.3 oder höher des Manifestschemas des deklarativen Agents verwenden, um Wissen hinzuzufügen Email .

{
  "capabilities": [
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
  ]
}

Im Feld folder_id können Sie entweder auf bekannte Ordnernamen oder Ordner-IDs verweisen. Eine Liste der bekannten Ordnernamen finden Sie unter mailFolder-Ressourcentyp. Verwenden Sie die folgende Abfrage in Graph Explorer, um eine Liste der Ordner-IDs abzurufen:

https://graph.microsoft.com/v1.0/me/mailFolders

Verwenden Sie im Feld shared_mailbox die SMTP-Adresse des freigegebenen Postfachs.

Im Feld group_mailboxes können Sie eine array von Zeichenfolgen (bis zu 25) angeben, die die SMTP-Adressen der freigegebenen Postfächer oder Microsoft 365-Gruppen enthalten, auf die Ihr Agent festgelegt werden soll.

Wenn Sie sowohl auf ein freigegebenes Postfach als auch auf einen Ordner verweisen, kann der Agent Antworten auf den Ordner innerhalb des freigegebenen Postfachs festlegen. Wenn Sie nur auf einen Ordner verweisen, kann der Agent Antworten auf den Inhalt des Ordners innerhalb des persönlichen Postfachs festlegen.

Wenn Sie nicht auf ein freigegebenes Postfach oder einen Ordner verweisen, ist die Agent-Suche auf keinen Ordner oder Postfach ausgerichtet und gibt ergebnisse aus allen E-Mail-Inhalten basierend auf der Abfrage des Benutzers zurück.

Personen

Sie können Ihren Agent in Personen Daten festigen, um personalisiertere und kontextbezogenere Antworten zu liefern. Personen Daten kombinieren öffentliche Informationen über Einzelpersonen (z. B. Name, Position, Fähigkeiten und Organisationsbeziehungen) mit einer persönlichen Ansicht der Verbindungen, Mitarbeiter und relevanten Erkenntnisse des Benutzers. Diese Wissensquelle ermöglicht Agents Folgendes:

  • Nachschlagen von Benutzer- und Kollegenprofilen, einschließlich Berichtsstruktur und Kontaktdetails.
  • Identifizieren Sie Domänenexperten und wichtige Mitarbeiter innerhalb der organization.
  • Personalisieren Sie Antworten basierend auf den Beziehungen des Benutzers, früheren Interaktionen und Präferenzen.
  • Geben Sie Empfehlungen und Kommunikationstipps, die auf bestimmte Teams oder Einzelpersonen zugeschnitten sind.

Hinzufügen einer Wissensquelle für Personen

Wenn Sie Copilot Studio verwenden, um Ihren Agent zu erstellen, ist die Personen Wissensquelle standardmäßig für Benutzer mit einer Microsoft 365 Copilot-Lizenz aktiviert.

Wenn Sie Agents Toolkit und Visual Studio Code verwenden, um Ihren Agent zu erstellen, fügen Sie den People Wert zur Eigenschaft capabilities in Ihrer Agent-Manifestdatei hinzu, um Personenwissen zu ermöglichen, wie im folgenden Beispiel gezeigt. Wenn sie nur die Basisfunktion People deklarieren, kann der Agent nur grundlegende organization Daten wie die im Profil verfügbaren Karte. Wenn Sie Inhalte wie verwandte Teams-Nachrichten, E-Mails und Dateien zwischen dem Agent-Benutzer und den Personen, auf die verwiesen wird, im organization verwenden Sie die include_related_content -Eigenschaft in Version 1.6.

Hinweis

Sie müssen Version 1.3 oder höher des Manifestschemas des deklarativen Agents verwenden, um die People Wissensquelle (ohne verwandte Inhalte) hinzuzufügen, oder Version 1.6 oder höher, um die include_related_content -Eigenschaft verwenden zu können.

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

Für den Fall, dass Ihr Agent verwandte Inhalte (zwischen dem Agent-Benutzer und den personen, auf die verwiesen wird) argumentieren muss, z. B. verwandte Teams-Nachrichten, E-Mails und Dateien, können Sie nutzen include_related_content. Der Standardwert ist false.

{
  "capabilities": [
    {
      "name":"People",
      "include_related_content": true
    }
  ]
}

Teams-Nachrichten

Sie können Agents so konfigurieren, dass sie Teams-Kanäle, Besprechungschats, Gruppenchats und 1:1-Chats als Wissensquellen verwenden. Sie können bis zu fünf Links zu Kanälen, Gruppen-, 1:1- oder Besprechungschats angeben, um die Copilot-Suche festzulegen, oder Sie können Ihrem Agent erlauben, die Teams-Inhalte des Benutzers, einschließlich Kanälen, Besprechungen und Einzel- und Gruppenchats, als Wissensquellen zu verwenden.

Agents können Links zu Dateien zurückgeben, die in Teams-Nachrichten freigegeben wurden, aber sie können keine Links zu Dateien zurückgeben, die in einem Teams-Kanal gespeichert sind, es sei denn, der Agent hat OneDriveAndSharePoint ebenfalls aktiviert. Informationen zum Optimieren von SharePoint-Inhalten für Copilot finden Sie unter Optimieren des Abrufs von SharePoint-Inhalten.

Hinzufügen von Wissensquellen für Teams-Nachrichten

Wenn Sie Microsoft 365 Copilot verwenden, um Ihren Agent zu erstellen, wählen Sie auf der Registerkarte Konfigurieren im Abschnitt Wissen die Suchleiste aus, und wählen Sie Meine Teams-Chats und Besprechungen aus. Wählen Sie auf der Registerkarte Chats die Chats aus, die Sie als Wissen hinzufügen möchten, um Ihren Agent auf bestimmte Kanäle, Besprechungs- oder Gruppenchats einzugrenzen.

Wenn Sie Agents Toolkit und Visual Studio Code verwenden, um Ihren Agent zu erstellen, fügen Sie den TeamsMessage Wert der Eigenschaft capabilities in Ihrem Manifestverweis hinzu, um Teams-Nachrichtenwissen zu aktivieren. Wenn Sie Teams-Wissen auf bis zu fünf Teams-Ressourcen festlegen möchten, fügen Sie die Links zur Urls-Eigenschaft hinzu, wie im folgenden Beispiel gezeigt.

Hinweis

Sie müssen Version 1.3 oder höher des Manifestschemas des deklarativen Agents verwenden, um die TeamsMessage Wissensquelle hinzuzufügen.

{
  "capabilities": [
    {
      "name": "TeamsMessages",
      "urls": []
    }
  ]
}

Abrufen der URL für einen Kanal oder eine Besprechung

Um die URL für einen Teams-Kanal abzurufen, wählen Sie die drei Punkte (...) neben dem Kanalnamen und dann Link zum Kanal abrufen aus.

Um die URL für eine Teams-Besprechung zu erhalten, öffnen Sie die Besprechung, wählen Sie den Pfeil neben Teilnehmen aus, und wählen Sie Link zum Beitritt kopieren aus.

Abrufen der URL für eine Gruppe oder einen 1:1-Chat

Um die URL für einen Gruppen- oder 1:1-Chat abzurufen, benötigen Sie einen Deep-Link, der die chatId enthält. Der Deep-Link hat das folgende Format: https://teams.microsoft.com/l/chat/<chatId>/conversations. Der ChatId-Wert unterscheidet sich für jeden Chat.

So rufen Sie den chatId-Wert für eine Gruppe oder einen 1:1-Chat ab:

  1. Wechseln Sie in Microsoft Teams zu einer beliebigen Nachricht im Chat.
  2. Zeigen Sie auf die Nachricht, und wählen Sie die drei Punkte (...) aus.
  3. Wählen Sie Link kopieren aus.
  4. Fügen Sie den Link in Editor oder eine ähnliche Anwendung ein. Der Link sieht in etwa wie die folgende URL aus: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D.
  5. Kopieren Sie das Segment der URL, das zwischen chat/ und dem nächsten /liegt. Dem Segment wird in der Regel vorangestellt 19:. Dies ist die chatId. Im vorherigen Beispiel ist 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spacesdie chatId .
  6. Fügen Sie dem Deep-Link die chatId hinzu. Beispiel: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations.

Weitere Informationen finden Sie unter Deep-Link zum Teams-Chat.

Teams-Besprechungen

Mithilfe des Teams-Besprechungswissens können Sie Ihren Agent so festlegen, dass er Fragen zu Besprechungen beantworten kann, einschließlich einzelner Besprechungen oder Besprechungsserien. Ihr Agent kann beispielsweise auf Abfragen wie "Besprechungen von gestern wiederholen und Aktionselemente auflisten" oder "Was wurde in meinen Besprechungen über Project X gesagt?" beantworten. Diese Wissensquelle kann optional auf bis zu fünf bestimmte Besprechungen festgelegt werden. Diese Wissensquelle gewährt dem Agent Zugriff auf Besprechungsmetadaten (Betreff, Organisator, Teilnehmer und Titel), Transkriptinhalte und Besprechungschats.

Hinweis

Das Verweisen auf eine Besprechungsreihe ist auf die letzten 4 Instanzen der Reihe beschränkt.

Hinzufügen einer Wissensquelle für Besprechungen

Wenn Sie Microsoft 365 Copilot verwenden, um Ihren Agent zu erstellen, wählen Sie auf der Registerkarte Konfigurieren im Abschnitt Wissen die Suchleiste aus, und wählen Sie Meine Teams-Chats und -Besprechungen aus. Die Möglichkeit, den Bereich auf Besprechungen zu festlegen, ist in Kürze in Microsoft 365 Copilot verfügbar.

Wenn Sie agents Toolkit und Visual Studio Code zum Erstellen Ihres Agents verwenden, fügen Sie den Meetings Wert der Eigenschaft capabilities in Ihrer Agent-Manifestdatei hinzu, um Besprechungswissen zu aktivieren, wie im folgenden Beispiel gezeigt. Wenn Sie den Agent auf bestimmte Besprechungen festlegen möchten, fügen Sie der -Eigenschaft die UID der items_by_id Besprechung hinzu. Anweisungen zum Ermitteln der ID einer Besprechung finden Sie unter Abrufen der ID einer Besprechung.

Hinweis

Sie müssen Version 1.6 oder höher des Manifestschemas des deklarativen Agents verwenden, um die Meetings Wissensquelle hinzuzufügen.

{
  "capabilities": [
    {
      "name":"Meetings",
      "items_by_id": [
        {
          "id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
          "is_series": true
        }
      ]
    }
  ]
}