Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Web grounding-tools in Microsoft Foundry Agent Service verbinden uw agents met realtime openbare webgegevens, waardoor de kennisbegrenzing van het Foundry-model van de agent wordt overwonnen. U kunt bijvoorbeeld vragen stellen zoals 'wat is het belangrijkste AI-nieuws vandaag' en actuele, geciteerde antwoorden ontvangen.
Hoe webfundering werkt
Het grondproces omvat verschillende belangrijke stappen:
- Queryformulering: de agent identificeert gegevensgaten en bouwt zoekquery's op basis van de invoer van de gebruiker.
- Zoekuitvoering: Het grounding-hulpprogramma verzendt query's naar Bing en haalt resultaten op.
- Informatiesynthese: de agent verwerkt zoekresultaten en integreert bevindingen in antwoorden.
- Bronvermelding: De agent biedt transparantie door zoekbronnen met URL's te citeren.
Voorwaarden
Voordat u een web grounding-hulpprogramma gebruikt, moet u het volgende doen:
- Een basis- of standaardagentomgeving.
- Het nieuwste SDK-pakket voor uw taal (Python:
azure-ai-projects, C#:Azure.AI.ProjectsenAzure.AI.Extensions.OpenAI, JavaScript:@azure/ai-projects). Zie de quickstart voor de installatiestappen. - Een Azure OpenAI-modelimplementatie in uw Foundry-project.
Opmerking
Webzoekopdrachten vereist geen extra rollen buiten de toegang tot het Foundry-project. Voor grondgebruik met Bing Zoeken en grondgebruik met Bing Aangepaste zoekopdrachten is Contributor of Owner rol nodig om Bing-resources te maken en Azure AI Project Manager rol om project verbindingen te maken. Zie de installatie van de agentomgeving voor meer informatie.
Belangrijk
Web zoeken, gebruik van Bing Search en gebruik van Bing Custom Search zijn First Party Consumption Services met termen voor onlineservices. Ze vallen onder de Gebruiksvoorwaarden van Bing en de Privacyverklaring van Microsoft.
De Microsoft Data Protection Addendum is niet van toepassing op gegevens die worden verzonden naar Grounding met Bing Search of Grounding met Bing Custom Search. Wanneer u deze services gebruikt, stromen uw gegevens buiten de Azure naleving en geografische grens. Dit betekent ook dat het gebruik van deze services alle verhoogde beveiligings- en nalevingsverplichtingen van de Government Community Cloud niet geldig maakt, inclusief gegevenssoevereiniteit en ondersteuning op basis van nationaliteit, indien van toepassing.
Opmerking
Voor het gebruik van grounding met Bing Search en Grounding met Bing Custom Search worden kosten in rekening gebracht. Bekijk de prijsgegevens. Azure beheerders kunnen de toegang tot deze hulpprogramma's beperken. Voor meer informatie, zie Beheerdercontrole voor het hulpmiddel voor webzoeken.
Bepaal het beste hulpmiddel voor uw gebruiksscenario's.
Als u net aan de slag gaat, gebruikt u webzoeken. Het vereist geen extra Azure-bronnen en is de eenvoudigste manier om webintegratie toe te voegen aan uw agent.
Als u migreert van Grounding met Bing Search op het klassieke agents-platform, zijn zowel Webzoekopdracht als Grounding met Bing Search algemeen beschikbare opties op de nieuwe agents-API. Webzoekopdrachten vereist geen afzonderlijke Bing-resource. Grounding met Bing Search biedt meer parameters en biedt ondersteuning voor niet-OpenAI-modellen die rechtstreeks op Azure zijn geïmplementeerd.
Met de volgende use cases kunt u de beschikbare hulpprogramma's vergelijken. Use case 1 behandelt algemene zoekopdrachten op internet, waarbij zowel Zoeken op internet als Grounding met Bing Search resultaten van het openbare web kan ophalen. Use case 2 behandelt domein beperkt zoeken, die alleen Grounding met Bing Custom Search ondersteunt.
Use case 1: Verankering vanuit de algemene web geïndexeerd door Bing
| Webzoekopdrachten (aanbevolen) | Verankering met Bing Search | |
|---|---|---|
| Fase | GA | GA |
| Verbinding met Bing-bron | Beheerd door Microsoft | Beheerd door u: hiervoor moet u eerst een Grounding maken met de Bing Search-resource |
| Ondersteunde parameters |
-
user_location: Biedt geo-relevante resultaten- search_context_size: laag/gemiddeld/hoog (standaard: gemiddeld)Meer informatie over webzoekparameters |
-
count: het maximum aantal resultaten dat door Bing wordt geretourneerd - freshness: geeft de periode voor de zoekresultaten op- market: geeft de regio voor de zoekresultaten op - set_lang: geeft de taal voor de zoekresultaten op Meer informatie over Bing Search-parameters |
| Gegevensgrens | Gegevensstromen buiten Azure nalevingsgrens | Gegevensstromen buiten Azure nalevingsgrens |
| Ondersteunde modellen | Azure OpenAI-modellen | Azure OpenAI-modellen en Azure directe modellen (niet-OpenAI-modellen die rechtstreeks op Azure zijn geïmplementeerd) |
Use case 2: Gronding van specifieke domeinen die u hebt gedefinieerd
| Webzoekopdrachten (aanbevolen) | Grounding met Bing Custom Search | |
|---|---|---|
| Fase | GA (hiervoor is een instantie van Bing Custom Search vereist) | Voorbeeld |
| Beperken tot aangepaste domeinen | Ondersteund: gebruiken custom_search_configuration om toegestane of geblokkeerde domeinen vooraf te definiëren (hiervoor moet een Bing Custom Search-resource en -exemplaar worden gemaakt) |
Ondersteund: gebruiken custom_search_configuration om toegestane of geblokkeerde domeinen vooraf te definiëren (hiervoor moet een Bing Custom Search-resource en -exemplaar worden gemaakt) |
| Andere parameters |
-
user_location: Biedt geo-relevante resultaten- search_context_size: laag/gemiddeld/hoog (standaard: gemiddeld)Meer informatie over webzoekparameters |
-
count: het maximum aantal resultaten dat door Bing wordt geretourneerd - freshness: geeft de periode voor de zoekresultaten op- market: geeft de regio voor de zoekresultaten op - set_lang: geeft de taal voor de zoekresultaten op Meer informatie over Bing Custom Search-parameters |
| Ondersteunde modellen | Azure OpenAI-modellen | Azure OpenAI-modellen en Azure Direct-modellen |
Veelgestelde vragen
Welk hulpprogramma moet ik gebruiken als ik net aan de slag ga?
Gebruik Webzoekopdrachten. Hiervoor zijn geen extra Azure resources vereist, worden Bing-resourcebeheer automatisch verwerkt en worden geo-relevante resultaten geleverd met de parameter user_location.
Kan ik webaardinghulpprogramma's gebruiken met met een netwerk beveiligde Foundry-projecten?
Web grounding-hulpprogramma's respecteren geen VPN- of privé-eindpunten. Ze fungeren als openbare eindpunten. Houd rekening met deze beveiligingsimplicatie bij het gebruik van met het netwerk beveiligde Foundry met deze hulpprogramma's.
Hoe beperk ik zoekresultaten tot specifieke websites?
Gebruik Webzoekopdrachten. Met dit hulpprogramma kunt u een acceptatielijst of een blokkeringslijst met domeinen definiëren, zodat zoekresultaten alleen afkomstig zijn van bronnen die u goedkeurt.
Zijn er extra kosten voor webaarding?
Ja. Webzoekopdrachten, Grounding met Bing Search en grounding met Bing Custom Search (voorbeeldweergave) brengen kosten met zich mee buiten het standaardgebruik van Azure OpenAI. Bekijk de prijsgegevens.
Probleemoplossing
| Probleem | Waarschijnlijke oorzaak | Resolutie |
|---|---|---|
| Agent maakt geen gebruik van webbegrenzing | Het hulpprogramma is niet geconfigureerd of het model biedt geen ondersteuning voor het hulpprogramma. | Controleer of het hulpprogramma is toegevoegd aan uw agentdefinitie. Gebruik tool_choice="required" om het gebruik van tools af te dwingen. Controleer of uw modelimplementatie het hulpprogramma ondersteunt. |
| Geen bronvermeldingen in antwoord | Het model heeft een antwoord gegenereerd zonder zoekresultaten te gebruiken. | Voeg expliciete instructies toe om altijd bronnen te citeren. Gebruik tool_choice="required" om het aanroepen van het hulpprogramma te verzekeren. |
| Zoekresultaten zijn niet relevant | Bij het formuleren van query's is de intentie van de gebruiker niet vastgelegd. | Verbeter de agentinstructies om te begeleiden bij het opstellen van query's. Voor Bing-hulpprogramma's kunt u de parameters market en set_lang aanpassen. |
| Hulpprogramma geblokkeerd door beheerder | Uw organisatie heeft webgebaseerde aardingstools uitgeschakeld. | Neem contact op met uw Azure-beheerder om toegang in te schakelen. Zie administratorcontrole. |
| Onverwachte kosten | Web grounding tools hanteren een prijsmodel op basis van gebruik. | Bekijk de prijsgegevens en implementeer zo nodig snelheidsbeperking. |