Dela via

Förankring med anpassad Bing-sökning (förhandsversion)

Med Bing Custom Search-verktyget kan dina Azure AI-agenter söka inom en konfigurerbar uppsättning offentliga webbdomäner. Det gör att du kan definiera de delar av webben som du vill dra från så att användarna bara ser relevanta resultat från de domäner och underdomäner som du väljer. Du måste först skapa en grund via Bing Custom Search-resursen i Azure-portalen.

När resursen har distribuerats går du till Konfigurationer i Azure AI Foundry-portalen och skapar en konfigurationsinstans som endast innehåller innehåll från webbplatser som användarna bryr sig om. Instruktioner om hur du skapar din anpassade konfiguration finns i installationsavsnittet.

När verktyget har konfigurerats kan du ansluta det till din Azure AI-agent. När en användare skickar en fråga avgör agenten om grounding med anpassad Bing-sökning ska utnyttjas eller inte. I så fall använder den Bing för att söka över de domäner som du anger och returnera relevanta segment. Slutligen använder Azure AI-agenter de returnerade segmenten för att generera ett svar för att återgå till användaren

Viktigt!

  • Din användning av Grounding med anpassad Bing-sökning kan medföra kostnader. Mer information finns på prissidan.
  • Genom att skapa och använda en grundkonfiguration med en anpassad Bing-sökresurs via en kod-först-upplevelse, såsom Azure CLI, eller distribuering via en distributionsmall, godkänner du att vara bunden av och följa användningsvillkoren, som kan uppdateras regelbundet.
  • När du använder Grounding med anpassad Bing-sökning överförs dina kunddata utanför Azures efterlevnadsgräns till tjänsten Grounding med anpassad Bing-sökning. Grundläggning med anpassad Bing-sökning omfattas inte av samma databehandlingsvillkor (inklusive bearbetningslokalitet) och har inte samma efterlevnadsstandarder och certifieringar som Azure AI Foundry Agent Service, enligt användningsvillkoren för Grounding med Bing Custom Search. Det är ditt ansvar att bedöma om användningen av Grounding med anpassad Bing-sökning i din agent uppfyller dina behov och krav.

Så här fungerar grounding med anpassad Bing-sökning

Användarfrågan är det meddelande som en slutanvändare skickar till en agent, till exempel "vilken vattenflaska är tillgänglig?" (förutsatt att du skapar en instans till Contosos produktwebbplatser). Instruktioner är det systemmeddelande som en utvecklare kan ge för att dela kontext och ge instruktioner till AI-modellen om hur man använder olika verktyg eller beter sig.

När en användare skickar en fråga bearbetar kundens AI-modelldistribution först den (med hjälp av de angivna anvisningarna) för att senare utföra en anpassad Bing-sökfråga (som är synlig för utvecklare). Vid grundning med anpassad Bing-sökning returneras relevanta sökresultat till kundens modellutplacering, som sedan genererar den slutliga utdata.

Anmärkning

När du använder Grounding med anpassad Bing-sökning skickas frågan anpassad sökning i Bing, konfigurationsinstansen, verktygsparametrarna och resursnyckeln till Bing och ingen slutanvändarspecifik information ingår. Din resursnyckel skickas till Bing enbart för fakturering och hastighetsbegränsning.

Auktoriseringen sker mellan Grounding med tjänsten Anpassad sökning i Bing och Azure AI Foundry Agent-tjänsten. Alla frågor för anpassad Bing-sökning som genereras och skickas till Bing i samband med jordning överförs, tillsammans med resursnyckeln och konfigurationsinstansen, utanför Azures efterlevnadsgräns till tjänsten Grounding with Bing Custom Search. Grundandet med anpassad Bing-sökning omfattas av Bings villkor och har inte samma efterlevnadsstandarder och certifieringar som Azure AI Foundry Agent Service, enligt beskrivningen i grunderna med anpassade Bing-sökvillkor. Det är ditt ansvar att bedöma om användningen av grounding med anpassad Bing-sökning i din agent uppfyller dina behov och krav.

Utvecklare och slutanvändare har inte åtkomst till råinnehåll som returneras från Grounding med anpassad Bing-sökning. Modellsvaret innehåller dock citat med länkar till de webbplatser som används för att generera svaret och kan lagras med hjälp av de mekanismer som tillhandahålls av agenttjänsten. Du kan hämta modellsvaret genom att komma åt data i tråden som skapades. Dessa referenser måste behållas och visas i exakt den form som tillhandahålls av Microsoft, enligt Bing Custom Searchs användnings- och visningskrav.

Inställningar

Anmärkning

Du kan endast använda Azure OpenAI-modeller med Grounding i samband med Bings anpassade sökning.

  1. Skapa en Azure AI-agent genom att följa stegen i snabbstarten.

  2. Skapa en grundskapande resurs med Bing anpassad sökning i Azure-portalen. Du måste ha rollen ägare eller deltagare i din prenumeration eller resursgrupp för att kunna skapa den. Se till att du skapar den här Grounding-resursen med anpassad Bing-sökning i samma resursgrupp som din Azure AI-agent, ditt AI-projekt och dina andra resurser.

  3. Efter att du har skapat en koppling med Bing Custom Search-resursen kan du skapa en konfigurationsinstans.

    1. Gå till grounding med en anpassad Bing-sökresurs som skapats

    2. Välj Resurshantering på den vänstra panelen.

    3. Välj Konfigurationer.

    4. Välj Skapa en ny konfiguration.

När du skapar eller uppdaterar en konfiguration anger du följande information:

  1. Namnet på konfigurationen. Det här kan ändras när du vill.

  2. Inkludera URL:er för att definiera dina söksektorer i minst ett av följande fält:

    Anmärkning

    Med anpassad Bing-sökning returneras endast resultat för domäner och webbsidor som är offentliga och har indexerats av Bing.

    • Domän (till exempel https://www.microsoft.com)
    • Domän och sökväg (till exempel https://www.microsoft.com/surface)
    • Webbsida (till exempel https://www.microsoft.com/en-us/p/surface-earbuds/8r9cpq146064)

    1. Tillåtna domäner att söka mot. Om du vill inkludera undersidor för tillåtna domäner kontrollerar du att domänerna har högst 2 nivåer av undersidor.

    2. Blockerade domäner att exkludera från sökutrymmet.

  3. Ta reda på om du vill ta med undersidor. Ett undersida-segment anger en domänväg. Bing söker igenom allt innehåll som finns på och under sökvägen. Du kan ange högst två undermappar i sökvägen. Till exempel www.microsoft.com/windows/.

  4. Justera rangordningen om det behövs.

  5. Gå till skärmen Agenter för din agent i Azure AI Foundry-portalen och rulla nedåt i fönstret Installation till höger om kunskap. Välj sedan Lägg till.

    En skärmbild av agentskärmen i AI Foundry-portalen.

  6. Välj verktyget Grounding with Bing Custom Search (Anpassad sökning i Bing ).

  7. Välj för att skapa en ny anslutning eller använd en befintlig anslutning

    1. För en ny anslutning, välj din Grounding med resursen Bing Custom Search.

  8. När du har anslutit till en resurs väljer du konfigurationsnamnet.

  9. Spara verktyget och börja chatta med din agent.

Konfigurationsfunktioner för anpassad sökning

Grundläggning med anpassad Bing-sökning är ett kraftfullt verktyg som gör att du kan välja ett underområde på webben för att begränsa agentens grundkunskaper. Här hittar du några tips för hur du kan dra största möjliga nytta av den här funktionen:

  1. Om du äger en offentlig webbplats som du vill inkludera i sökningen men Bing inte har indexerat kan du läsa dokumentationen för Bing-webbansvariga om du vill ha mer information om hur du indexerar din webbplats. Dokumentationen för webbansvariga innehåller också information om hur du får Bing att crawla din webbplats om indexet är inaktuellt.

  2. Du kan bara blockera vissa domäner och utföra en sökning mot resten av webben (till exempel en konkurrents webbplats).

Valfria parametrar

När du lägger till verktyget Grounding med anpassad Bing-sökning i din agent kan du skicka följande parametrar. De här parametrarna påverkar utdata från verktyget Grounding med anpassat Bing-sökverktyg och AI-modellen kanske inte använder alla utdata fullt ut. Se kodexemplen för information om API-versionsstöd och hur du skickar dessa parametrar.

Namn Värde Typ Krävs
count Antalet sökresultat som ska returneras i svaret. Standardvärdet är 5 och det maximala värdet är 50. Det faktiska antalet som levereras kan vara mindre än begärt. Det är möjligt för flera sidor att inkludera viss överlappning i resultaten. Den här parametern påverkar endast webbsideresultat. Det är möjligt att AI-modellen kanske inte använder alla sökresultat som returneras av Bing. UnsignedShort Nej
freshness Filtrera sökresultaten efter följande skiftlägesokänsliga åldersvärden:
Dag: Returnera webbsidor som Bing har identifierat under de senaste 24 timmarna.
Vecka: Returnera webbsidor som Bing har identifierat under de senaste 7 dagarna.
Månad: Returnera webbsidor som Bing har identifierat under de senaste 30 dagarna. Om du vill få artiklar identifierade av Bing under en viss tidsram anger du ett datumintervall i formuläret: YYYY-MM-DD..YYYY-MM-DD. Till exempel freshness=2019-02-01..2019-05-30. Om du vill begränsa resultatet till ett enda datum anger du den här parametern till ett specifikt datum. Till exempel freshness=2019-02-04.		 Sträng Nej
market Marknaden där resultaten kommer ifrån. mkt Är vanligtvis det land där användaren gör begäran från. Det kan dock vara ett annat land om användaren inte finns i ett land där Bing levererar resultat. Marknaden måste vara i följande form: <language>-<country/region>. Till exempel en-US. Strängen är skiftlägesokänslig. En lista över möjliga marknadsvärden finns i Marknadskoder. Om det är känt uppmanas du att alltid ange marknaden. Att ange marknaden hjälper Bing att dirigera begäran och returnera ett lämpligt och optimalt svar. Om du anger en marknad som inte anges i Marknadskoder använder Bing en marknadskod som passar bäst baserat på en intern mappning som kan komma att ändras. Sträng Nej
set_lang Språket som ska användas för användargränssnittssträngar. Du kan ange språket med antingen en 2-bokstavs- eller 4-bokstavskod. Att använda 4-bokstavskoder är att föredra.
En lista över språkkoder som stöds finns i Språk som stöds i Bing.
Bing läser in de lokaliserade strängarna om setlang innehåller en giltig neutral kulturkod på 2 bokstäver (fr) eller en giltig 4-bokstavsspecifik kulturkod (fr-ca). Till exempel laddar fr-caBing de fr neutrala kulturkodsträngarna.
Om setlang inte är giltigt (till exempel zh) eller om Bing inte stöder språket (till exempel af, af-na), är Bing standardvärdet en (engelska).
Om du vill ange 2-bokstavskoden anger du den här parametern till en ISO 639-1-språkkod.
Om du vill ange 4-bokstavskoden använder du formuläret <language>-<country/region> där <language> är en ISO 639-1-språkkod (neutral kultur) och <country/region> är en ISO 3166-lands-/regionkod (specifik kultur). Använd till exempel en-US för engelska i USA.
Även om det är valfritt bör du alltid ange språket. Normalt anger setLang du till samma språk som anges av mkt om inte användaren vill att användargränssnittssträngarna ska visas på ett annat språk.		 Sträng Nej