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 im Copilot Studio-Agent-Generator bieten ihnen mehrere Optionen zum Entsperren von Features für Ihre Benutzer. In diesem Artikel werden die Wissensquellen beschrieben, die Sie Ihren Agents hinzufügen können.

In der folgenden Tabelle sind die Funktionen und Wissensquellen aufgeführt, die Sie mithilfe des Agent-Generators oder des Microsoft 365 Agents Toolkits (eine Weiterentwicklung des Teams-Toolkits) 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 Agent-Generator Agents Toolkit Lizenz oder getaktete Nutzung erforderlich?
Code-Interpreter Nein
Bildgenerator Nein
Copilot-Connectors Ja
SharePoint Ja
Microsoft OneDrive-App 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)

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

Copilot-Connectors

Microsoft 365 Copilot Connectors (ehemals Microsoft Graph-Connectors) ermöglichen es Ihnen, Ihrem Agent Organisationsdaten als Erdungsinformationen 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 Copilot Studio Agent Builder 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 Copilot Studio Agent-Generator 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 geben 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 Copilot Studio Agent-Generator zum Erstellen Ihres Agents verwenden, listen Sie auf der Registerkarte Konfigurieren unter Wissen die Website-URLs auf, auf die Sie verweisen möchten.

Eingebetteter Dateiinhalt

Wenn Sie Copilot Studio Agent-Generator 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 getakteter Nutzung oder mit einer Microsoft 365 Copilot-Lizenz zur Verfügung.

Weitere Informationen zu eingebetteten Dateien finden Sie unter Eingebettete Dateiinhalte im Agent-Generator.

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-Kenntnisse sind derzeit nicht in Copilot Studio Agent-Generator 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 Copilot Studio Agent-Generator 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 den Agent-Generator 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.

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

Personen Wissen ermöglicht es Ihnen, Ihren Agenten so zu richten, dass er Fragen zu Personen in einem organization beantwortet. Ihr Agent kann beispielsweise auf Abfragen wie "Gewusst wie Kontaktperson<>" oder "Direkte Berichte der <Person> auflisten" antworten. Diese Wissensquelle ist nicht bereichsbezogener.

Hinweis

Personen Wissen ist derzeit in Copilot Studio Agent Builder nicht verfügbar.

Hinzufügen einer Wissensquelle für Personen

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.

Hinweis

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

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

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, alle 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 Copilot Studio Agent-Generator zum Erstellen Ihres Agents verwenden, wählen Sie auf der Registerkarte Konfigurieren im Abschnitt Wissen die Suchleiste aus, und wählen Sie Meine Teams-Chats aus Gruppen, Kanälen 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 im Allgemeinen 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.