Übersicht über Webgrundungstools

Web-Grounding-Tools im Microsoft Foundry Agent Service verbinden Ihre Agenten mit Echtzeit-öffentlichen Webdaten und überwinden die Wissensbegrenzung des Foundry-Modells des Agenten. Beispielsweise können Sie Fragen wie "Was ist die top KI News heute" stellen und aktuelle, zitierte Antworten erhalten.

Funktionsweise des Web-Groundings

Der Erdungsprozess umfasst mehrere wichtige Schritte:

  1. Abfrageformulierung: Der Agent identifiziert Informationslücken und erstellt Suchabfragen basierend auf der Eingabe des Benutzers.
  2. Suchausführung: Das Basis-Tool sendet Abfragen an Bing und erhält die Ergebnisse.
  3. Informationssynthese: Der Agent verarbeitet Suchergebnisse und integriert Ergebnisse in Antworten.
  4. Quellzuordnung: Der Agent bietet Transparenz, indem Suchquellen mit URLs zitiert werden.

Voraussetzungen

Stellen Sie vor der Verwendung eines Web-Grounding-Tools folgendes sicher:

Hinweis

Die Websuche erfordert keine zusätzlichen Rollen, die über den Zugriff auf das Foundry-Projekt hinausgehen. Grounding mit Bing Search und Grounding mit Bing Custom Search erfordert die Rolle Contributor oder Owner zum Erstellen von Bing-Ressourcen und die Rolle Azure AI Project Manager zum Erstellen von Projektverbindungen. Ausführliche Informationen finden Sie unter Agent-Umgebungseinrichtung.

Wichtig

Die Websuche, das Grounding mit Bing Search und das Grounding mit der benutzerdefinierten Bing-Suche sind First-Party-Verbrauchsdienste mit Bedingungen für Onlinedienste. Sie unterliegen der Grounding mit Bing-Nutzungsbedingungen und den Microsoft Datenschutzbestimmungen.

Das Microsoft Datenschutz-Addendum gilt nicht für Daten, die mit Grounding bei Bing Search oder Grounding bei Bing Custom Search gesendet werden. Wenn Sie diese Dienste verwenden, fließen Ihre Daten außerhalb der Azure Compliance- und Geo-Grenze. Dies bedeutet auch, dass die Nutzung dieser Dienste den Verzicht auf alle erhöhten Sicherheits- und Compliance-Verpflichtungen der Government Community Cloud beinhaltet, einschließlich Datenhoheit und überprüfungs-/staatsbürgerschaftsbasierter Unterstützung, soweit zutreffend.

Hinweis

Die Verwendung von Grounding mit Bing Search und Grounding mit Bing Custom Search kann Kosten verursachen. Weitere Informationen finden Sie unter Preisdetails. Azure Administratoren können den Zugriff auf diese Tools einschränken. Ausführliche Informationen finden Sie unter Administratorsteuerelement für das Websuche-Tool.

Ermitteln des besten Tools für Ihre Anwendungsfälle

Wenn Sie gerade erst beginnen, verwenden Sie die Websuche. Sie erfordert keine zusätzlichen Azure Ressourcen und ist die einfachste Möglichkeit, Ihrem Agent Web-Grounding hinzuzufügen.

Wenn Sie von Grounding mit Bing Search auf der klassischen Agents-Plattform migrieren, sind sowohl Websuche als auch Grounding mit Bing Search GA-Optionen für die neue Agents-API. Für die Websuche ist keine separate Bing-Ressource erforderlich. Die Nutzung von Bing Search bietet zusätzliche Parameter und unterstützt Nicht-OpenAI-Modelle, die direkt auf Azure bereitgestellt werden.

Die folgenden Anwendungsfälle helfen Ihnen beim Vergleichen der verfügbaren Tools. Anwendungsfall 1 deckt die allgemeine Websuche ab, bei der sowohl die Websuche als auch das Grounding mit Bing Search Ergebnisse aus dem öffentlichen Web abrufen können. Anwendungsfall 2 deckt die domänenbeschränkte Suche ab, die nur das Grounding mit Bing Custom Search unterstützt.

Anwendungsfall 1: Bezugnahme aus dem vom Bing indizierten allgemeinen Web

Websuche (empfohlen) Verwendung der Bing-Suche
Bühne GA GA
Erdung unter Verwendung der Bing-Ressource Verwaltet von Microsoft Verwaltet von Ihnen – erfordert zuerst die Einrichtung einer Bing-Suchressource.
Unterstützte Parameter - user_location: Stellt georelevante Ergebnisse bereit.
- search_context_size: niedrig/mittel/hoch (Standard: mittel)
Weitere Informationen zu Websuchparametern		 - count: Die maximale Anzahl von Ergebnissen, die von Bing zurückgegeben werden
- freshness: Gibt den Zeitraum für die Suchergebnisse an.
- market: Gibt die Region für die Suchergebnisse an.
- set_lang: Gibt die Sprache für die Suchergebnisse an.
Weitere Informationen zu Bing Search-Parametern
Datengrenze Datenflüsse außerhalb der Azure-Compliance-Grenze Datenflüsse außerhalb der Azure-Compliance-Grenze
Unterstützte Modelle Azure OpenAI-Modelle Azure OpenAI-Modelle und Azure direct Models (nicht openAI-Modelle, die direkt auf Azure bereitgestellt werden)

Anwendungsfall 2: Verankerung aus spezifischen Bereichen, die Sie definiert haben

Websuche (empfohlen) Grundlage mit Bing Custom Search
Bühne GA (erfordert eine benutzerdefinierte Bing-Suchinstanz) Vorschau
Einschränken auf benutzerdefinierte Domänen Unterstützt – Verwendung custom_search_configuration zum Vorabdefinieren zulässiger oder blockierter Domänen (erfordert das Erstellen einer benutzerdefinierten Bing-Suchressource und -Instanz) Unterstützt – Verwendung custom_search_configuration zum Vorabdefinieren zulässiger oder blockierter Domänen (erfordert das Erstellen einer benutzerdefinierten Bing-Suchressource und -Instanz)
Andere Parameter - user_location: Stellt georelevante Ergebnisse bereit.
- search_context_size: niedrig/mittel/hoch (Standard: mittel)
Weitere Informationen zu Websuchparametern		 - count: Die maximale Anzahl von Ergebnissen, die von Bing zurückgegeben werden
- freshness: Gibt den Zeitraum für die Suchergebnisse an.
- market: Gibt die Region für die Suchergebnisse an.
- set_lang: Gibt die Sprache für die Suchergebnisse an.
Weitere Informationen zu Benutzerdefinierten Bing-Suchparametern
Unterstützte Modelle Azure OpenAI-Modelle Azure OpenAI-Modelle und Azure direct models

Allgemeine Fragen

Welches Tool sollte ich verwenden, wenn ich gerade loslegen möchte?

Verwenden Sie die Websuche. Sie erfordert keine zusätzlichen Azure Ressourcen, behandelt die Bing-Ressourcenverwaltung automatisch und stellt georelevante Ergebnisse mit dem Parameter user_location bereit.

Kann ich Web-Grounding-Tools mit netzwerkgeschützten Foundry-Projekten verwenden?

Web-Grounding-Tools respektieren keine VPN- oder privaten Endpunkte. Sie fungieren als öffentliche Endpunkte. Berücksichtigen Sie diese Sicherheitsimplikation, wenn Sie Foundry, die mit Netzwerksicherheit gesichert ist, mit diesen Tools verwenden.

Wie schränke ich Suchergebnisse auf bestimmte Websites ein?

Verwenden Sie die Websuche. Mit diesem Tool können Sie eine Zulassungsliste oder eine Sperrliste von Domänen definieren, sodass Suchergebnisse nur aus Von Ihnen genehmigten Quellen stammen.

Gibt es zusätzliche Kosten für das Web-Grounding?

Ja. Websuche, Verankerung mit Bing-Suche und Verankerung mit Bing Custom-Suche (Vorschau) verursachen zusätzliche Kosten gegenüber der standardmäßigen Nutzung von Azure OpenAI. Weitere Informationen finden Sie unter Preisdetails.

Problembehandlung

Angelegenheit Wahrscheinliche Ursache Auflösung
Agent verwendet keine Web-Verankerung Das Tool wird nicht konfiguriert oder nicht vom Modell unterstützt. Überprüfen Sie, ob das Tool ihrer Agentdefinition hinzugefügt wurde. Verwenden Sie tool_choice="required", um die Nutzung des Tools zu erzwingen. Überprüfen Sie, ob Ihre Modellbereitstellung das Tool unterstützt.
Keine Zitate als Antwort Das Modell hat eine Antwort generiert, ohne Suchergebnisse zu verwenden. Fügen Sie explizite Anweisungen hinzu, um immer Quellen zu zitieren. tool_choice="required" wird verwendet, um den Toolaufruf sicherzustellen.
Suchergebnisse sind nicht relevant Die Abfrageformulierung hat keine Benutzerabsicht erfasst. Verbessern Sie die Agentanweisungen, um die Erstellung von Abfragen zu unterstützen. Passen Sie die Parameter market und set_lang für Bing-Tools an.
Vom Administrator blockiertes Tool Ihre Organisation hat Web-Grounding-Tools deaktiviert. Wenden Sie sich an Ihren Azure-Administrator, um den Zugriff zu aktivieren. Siehe Administratorsteuerung.
Unerwartete Kosten Web-Grounding-Werkzeuge haben nutzungsbasierte Preise. Überprüfen Sie die Preisdetails , und implementieren Sie bei Bedarf die Zinsbegrenzung.

Verwandte Inhalte

  • Last updated on