Eine öffentliche Website als Wissensquelle hinzufügen

Wenn Sie öffentliche Websites als Wissensquellen auf Agentebene hinzufügen, verwenden Sie öffentlich verfügbare Informationen, um die Reichweite Ihres Agenten zu verbessern.

Hinzufügen einer öffentlichen Website

Führen Sie die folgenden Schritte aus, um eine öffentliche Website als Wissensquelle hinzuzufügen:

1. Öffnen Sie die Agentenanwendung.

2. Wählen Sie Wissen hinzufügen entweder auf der Seite Übersicht oder Wissen oder Eigenschaften eines Knotens für generative Antworten aus.

3. Wählen Sie Öffentliche Websites aus.

4. Geben Sie die URL zur öffentlichen Website ein. Wenn Sie eine Variable anstelle einer statischen URL verwenden möchten , wählen Sie das Symbol für die Variableauswahl neben dem URL-Feld aus, und wählen Sie eine Variable "Benutzerdefiniert", " System" oder " Umgebung " aus.

5. Fügen Sie einen Namen hinzu (standardmäßig wird die URL der Website verwendet).

6. Fügen Sie eine Beschreibung hinzu. Geben Sie eine detaillierte Beschreibung an, insbesondere, wenn generative KI aktiviert ist, da die Beschreibung die generative Orchestrierung unterstützt.

7. Wählen Sie "Zum Agent hinzufügen" aus, um das Hinzufügen der Wissensquelle abzuschließen.

8. Testen Sie Ihren Agenten, um zu prüfen, wie gut er auf Fragen zum Inhalt Ihrer Website antwortet. Möglicherweise möchten Sie Grenzfallfragen testen, um zu entscheiden, ob Sie zur Schaffung einer besser inklusiven Atmosphäre eine geringere Moderation benötigen.

URL Überlegungen

Die URL, die Sie in Ihrem Agent verwenden, stellt den Inhaltsumfang für das Generieren von Antworten dar. Einige URLs weisen Anforderungen und Einschränkungen auf.

URL-Typ und Struktur

• Die URL kann bis zu zwei Tiefenebenen aufweisen, wobei Unterpfade durch einen Schrägstrich /angegeben sind. Ein nachgestellter Schrägstrich ist jedoch zulässig.

  Gültig	Ungültig
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Wenn die URL zu einer anderen Website der obersten Ebene weiterleitet, ist der Inhalt nicht in den Ergebnissen enthalten:

  Wenn Sie zum Beispiel von www.fabrikam.com zu www.contoso.fabrikam.com umleitet werden, generiert Ihr Agent keine Antworten aus Inhalten auf einer dieser URLs.

• URLs, die auf eine Website verweisen, die eine Authentifizierung erfordert oder die von Bing nicht indiziert werden, werden nicht unterstützt.

  Beispielsweise erfordern Wikis und SharePoint Websites eine Authentifizierung, sodass Sie sie nicht verwenden können:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

URL-Domänenstruktur

Ihr Agent verwendet alle öffentlich sichtbaren Inhalte in der von Ihnen angegebenen URL, einschließlich Unterdomänen unter einer Domäne der obersten Ebene, um Inhalte zu generieren.

Beispiele:

• Wenn Sie www.fabrikam.com/engines/rotary verwenden, verwendet der Agent auch den Inhalt auf www.fabrikam.com/engines/rotary/dual-shaft, um Antworten zu generieren.

  Der Agent verwendet keine Inhalte auf www.fabrikam.com/tools, da tools keine Unterdomäne von rotary ist.

• Wenn Sie www.fabrikam.com (das www vorhanden ist) verwenden, nutzt der Agent keine Inhalte auf news.fabrikam.com (das www ist nicht vorhanden), da news. eine Subdomäne unter der Top-Level-Domain fabrikam.com ist.

• Wenn Sie fabrikam.com verwenden, verwendet der Agent Inhalte auf www.fabrikam.com und news.fabrikam.com, da er sich unter der Domäne der obersten Ebene fabrikam.com befindet.

Soziale Netzwerke und Foren-URLs

Ihr Agent generiert möglicherweise unsinnige, irrelevante oder unangemessene Antworten, wenn Sie als URL die Website eines Forums oder sozialen Netzwerks verwenden. Daher besteht bei Community-Inhalten in sozialen Netzwerken oft das Risiko, dass mehr Antworten abgelehnt werden.

Weitere Informationen finden Sie in den Häufig gestellte Fragen zu generativen Antworten. Die KI ist darauf trainiert, böswillige und beleidigende Antworten zu vermeiden.

Suchmaschinen-URLs

Nehmen Sie keine URLs von Suchmaschinen wie bing.com auf, da diese keine nützlichen Antworten liefern.

Verwenden von Variablen als URLs

Verwenden Sie Variablen auf der öffentlichen Website oder SharePoint Wissensquell-URLs, um den Umfang der von Ihrem Agent verwendeten Inhalte dynamisch zu steuern.

Anstatt mehrere Wissensquellen für verschiedene Szenarien zu erstellen, definieren Sie eine einzelne Wissensquelle, und fügen Sie eine Variable in die URL ein. Zur Laufzeit löst Copilot Studio die Variable auf und verwendet die resultierende URL zur Verankerung.

Variablenunterstützung

Wenn Sie eine öffentliche Website oder SharePoint Wissensquell-URL hinzufügen oder bearbeiten, können Sie eine Variable in das URL-Feld einfügen.

Verwenden Sie eine Variable, um:

• Anfügen eines Pfads zu einer Basis-URL

  https://www.contoso.com/{variable}

• Ersetzen der gesamten URL

  {variable}

Zur Laufzeit wird die Variable in einen Zeichenfolgenwert aufgelöst. Die Wissensquelle ist auf die aufgelöste URL beschränkt.

Erstellen und Festlegen einer Variablen

So verwenden Sie eine Variable in einer öffentlichen Website oder SharePoint Wissensquelle:

1. Erstellen Sie eine Zeichenfolgenvariable mit globalem Bereich.

2. Legen Sie den Variablenwert mithilfe einer der folgenden Optionen fest:

   • Themeneingaben
   • Benutzerprofileigenschaften, z. B. Sprache
   • Umgebungsvariablen
   • Agent-Flows oder Konnektoren

3. Fügen Sie die Variable in das URL-Feld ein, indem Sie {x} (Variable einfügen) auswählen.

4. Testen Sie den Agent, um zu bestätigen, dass die Variable in die erwartete URL aufgelöst wird.

Beispiel: Bereich nach Produkt

Sie können das Wissen auf verschiedene Produktbereiche basierend auf der Abfrage des Benutzers einschränken.

1. Verwenden Sie eine Themeneingabe, um den Produktnamen als Variable mit dem Namen Productzu erfassen.

2. Fügen Sie nach dem Triggerknoten einen Variablenwertknoten "Set" hinzu, und erstellen Sie eine neue Variable mit dem Namen ProductTable.

3. Verwenden Sie eine Power Fx-Formel, um die Produktnamen zu URL-Pfaden zu definieren und zuzuordnen.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Fügen Sie einen weiteren Variablenwertknoten "Set" hinzu, und verwenden Sie ihn, um eine neue globale Zeichenfolgentypvariable namens GlobalProductURLzu erstellen.

5. Wählen Sie in der Einstellung Bis-Wert die Option Formel aus und verwenden Sie eine Power Fx-Funktion, um anhand des Werts der Eingabevariablen Product, Topic.Product, wie folgt eine Suche in der Tabelle durchzuführen:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Verwenden Sie die Variable in der Wissensquell-URL:

   https://www.microsoft.com/en-us/{GlobalProductURL}

Der Agent durchsucht zur Laufzeit nur den speziell definierten Abschnitt der Website.

Häufige Szenarien

Verwenden Sie Variablen in wissensquellen der öffentlichen Website für:

• Produktbasiertes Routing: Abfragen auf bestimmte Produktdokumentationen eingrenzen.

• Regional- oder Sprachfilter: Zuordnung von User.Language zu lokalisierten URLs (z. B. en-us, it-it).

• Umgebungsspezifische URLs: Wechseln zwischen Entwicklungs-, Test- und Produktionswebsites.

Überlegungen

• Wissensquellen der öffentlichen Website verwenden die Bing-Suche und basieren auf indizierten Inhalten.
• Die Grenzwerte für die URL-Tiefe gelten weiterhin, wenn Sie Variablen verwenden.
• Variablen ändern nur die Ziel-URL. Sie wirken sich nicht darauf aus, wie Inhalte indiziert oder abgerufen werden.