Tilføj et offentligt websted som videnkilde

Note

Funktionerne i denne artikel drives af standardledningsnettet, som bruger de faktureringsmuligheder beskrevet i Licensering for agenter drevet af standardledningsnettet. Lær, hvordan du får adgang til standardfunktioner i Access standardagenter og agentflows.

Når du tilføjer offentlige websteder som videnkilder på agentniveau, bruger du offentligt tilgængelige oplysninger til at forbedre din agents rækkevidde.

Tilføj et offentligt websted

Hvis du vil tilføje et offentligt websted som en videnskilde, skal du udføre følgende trin:

  1. Åbn agenten.

  2. Vælg Tilføj viden fra siden Oversigt eller Viden eller fra Egenskaber for en generativ svarnode.

  3. Vælg offentlige websteder.

    Skærmbillede af dialogen Tilføj viden i Copilot Studio, der viser typer videnskilder, inklusive muligheden for offentlige hjemmesider.

  4. Indtast URL'en til den offentlige hjemmeside i feltet for linket til offentlige hjemmesider . For at bruge en variabel i stedet for en statisk URL, vælg variabelvælgerikonet (x) ved siden af URL-feltet og vælg en variabel Brugerdefineret, System eller Miljø . Vælg Tilføj for at tilføje linket til listen.

  5. Rediger eventuelt Navn-feltet (hjemmesidens URL bruges som standard).

  6. Rediger eventuelt feltet beskrivelse . En beskrivelse udfyldes automatisk som standard. At give en detaljeret beskrivelse er især nyttigt, hvis generativ AI er aktiveret, da beskrivelsen understøtter generativ orkestrering.

    Skærmbillede af formularen Tilføj offentlige hjemmesider, der viser URL-linket tilføjet med automatisk udfyldte Navn- og Beskrivelsesfelter og knappen Tilføj til agent.

  7. Vælg Føj til agent for at afslutte tilføjelsen af videnkilden.

    Skærmbillede af videnssiden i Copilot Studio, der viser den nyligt tilføjede offentlige hjemmeside videnskilde i listen med Klar-status.

  8. Test din agent for at se, hvor godt den reagerer på spørgsmål relateret til indholdet fra dit websted. Du ønsker måske at teste kant-case-spørgsmål for at afgøre, om du har brug for en lavere moderation for at være mere inkluderende.

Overvejelser om URL

Den URL-adresse, du bruger i din agent, repræsenterer omfanget af indhold til generering af svar. Nogle URL-adresser har krav og begrænsninger.

Note

Søgeforespørgselslængde

Når agenten svarer fra en offentlig hjemmeside, bruger den Grounding med Bing Search og sender en søgeforespørgsel til Bing som en webforespørgsel. Den samlede længde af denne forespørgsel, inklusive søgeforespørgslen, må ikke overstige 2.048 tegn. Hvis forespørgslen er lang nok til at få anmodningen over denne grænse, springer agenten søgningen over og returnerer ingen resultater fra hjemmesiden.

For offentlige hjemmesider baseres søgeforespørgslen på brugerens fulde spørgsmål, omformuleret for at inkludere relevant kontekst fra samtalen. Flere faktorer kan gøre denne forespørgsel lang nok til at nå grænsen:

  • Lange brugerspørgsmål.
  • Lange eller komplekse samtaler, fordi forespørgslen indeholder relevant kontekst fra tidligere ture.
  • Sprog, der bruger multibyte-tegn, såsom japansk, kinesisk og koreansk, fordi hvert tegn udvides til flere tegn, når det kodes i anmodningen.

Tip!

For at mindske risikoen for at nå denne grænse, hold spørgsmålene korte og fokuserer samtalerne.

URL-type og struktur

  • URL-adressen kan have op til to dybdeniveauer med understier angivet med en skråstreg /. Et efterfølgende skråstreg er dog tilladt.

    Gyldig Ikke gyldig
    www.contoso.com
    www.fabrikam.com/engines/rotary
    www.fabrikam.com/engines/rotary/
    www.fabrikam.com/engines/rotary/dual-shaft
  • Hvis en URL-adresse omdirigerer til et andet websted på øverste niveau, er indhold fra begge URL-adresser ikke inkluderet i resultaterne:

    Hvis www.fabrikam.com f.eks. omdirigerer til www.contoso.fabrikam.com, genererer din agent ikke svar ud fra indhold på nogen af disse URL-adresser.

  • URL-adresser, der peger på et websted, der kræver godkendelse, eller dem, der ikke er indekseret af Bing, understøttes ikke.

    Wikier og SharePoint websteder kræver f.eks. godkendelse, så du kan ikke bruge dem:

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

URL-domænestruktur

Din agent bruger alt indhold, der kan ses offentligt, i den URL-adresse, du angiver, herunder underdomæner under et domæne på øverste niveau, til at generere indhold.

Eksempler:

  • Hvis du bruger www.fabrikam.com/engines/rotary, bruger agenten også indholdet på www.fabrikam.com/engines/rotary/dual-shaft til at generere svar.

    Agenten bruger ikke indhold på www.fabrikam.com/tools, da værktøjer ikke er et underdomæne af roterende .

  • Hvis du bruger www.fabrikam.com ( www findes), bruger agenten ikke indhold på news.fabrikam.com ( www findes ikke), da nyheder er et underdomæne under domænet på øverste niveau fabrikam.com.

  • Hvis du bruger fabrikam.com, bruger agenten indhold på www.fabrikam.com og news.fabrikam.com, da de er placeret under det øverste domæne fabrikam.com.

Sociale netværk og forum-URL'er

Din agent kan generere meningsløse, irrelevante eller upassende svar, hvis du bruger et forum eller et socialt netværkswebsted som din URL. Derfor øger fællesskabsindhold på sociale netværk ofte risikoen for, at flere svar bliver afvist.

For mere information, se Ofte stillede spørgsmål for generative svar. AI er trænet til at undgå at generere ondsindede og stødende reaktioner.

URL-adresser til søgemaskine

Undgå at bruge URL'er til søgemaskiner som f.eks. bing.com, fordi de ikke giver brugbare svar.

Brug variabler som URL-adresser

Brug variabler på et offentligt websted eller SharePoint URL-adresser til videnkilder til dynamisk at styre omfanget af det indhold, som din agent bruger.

I stedet for at oprette flere videnkilder til forskellige scenarier skal du definere en enkelt videnkilde og indsætte en variabel i URL-adressen. På kørselstidspunktet fortolker Copilot Studio variablen og bruger den resulterende URL-adresse til jordforbindelse.

Variabel understøttelse

Når du tilføjer eller redigerer et offentligt websted eller SharePoint URL-adresse til videnkilden, kan du indsætte en variabel i feltet URL-adresse.

Brug en variabel til at:

  • Føj en sti til en grundlæggende URL-adresse

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

  • Erstat hele URL-adressen

    {variable}

På kørselstidspunktet oversættes variablen til en strengværdi. Videnkilden er begrænset til den løste URL-adresse.

Note

Hvis du bruger en variabel, ændres den URL-adresse, der bruges til jordforbindelse. Det ændrer ikke kravene til URL-strukturen eller dybdebegrænsningerne for offentlige websteder.

Opret og angiv en variabel

Sådan bruger du en variabel på et offentligt websted eller SharePoint videnkilde:

  1. Opret en strengvariabel med globalt omfang.

  2. Angiv variabelværdien ved hjælp af en af følgende indstillinger:

  3. Indsæt variablen i feltet URL-adresse ved at vælge {x} (Indsæt variabel).

  4. Test agenten for at bekræfte, at variablen oversættes til den forventede URL-adresse.

Eksempel: Omfang efter produkt

Du kan bruge viden til forskellige produktområder baseret på brugerens forespørgsel.

  1. Brug et emneinput til at registrere produktnavnet som en variabel med navnet Product.

  2. Tilføj noden Angiv variabelværdi efter udløsernoden , og opret en ny variabel med navnet ProductTable.

  3. Brug en Power Fx-formel til at definere og knytte produktnavnene til URL-stier.

     Table(
         { Product: "Copilot", Path: "microsoft-365-copilot" },
         { Product: "Teams", Path: "microsoft-teams" },
         { Product: "Surface", Path: "surface" }
     )
    
  4. Tilføj en anden node for angiv variabelværdi , og brug den til at oprette en ny global strengtypevariabel med navnet GlobalProductURL.

  5. I indstillingen Til-værdi skal du vælge Formel og bruge en Power Fx-funktion til at udføre et opslag i tabellen baseret på værdien af Product inputvariablen , Topic.Productsom følger:

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

  6. Brug variablen i URL-adressen til videnskilden:

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

Agenten forespørger kun den områdebelagte del af webstedet på kørselstidspunktet.

Almindelige scenarier

Brug variabler i kilder til viden om offentlige websteder til:

  • Produktbaseret routing: Omfangsforespørgsler til specifik produktdokumentation.

  • Filtrering af område eller sprog: Knyt User.Language til lokaliserede URL-adresser (f.eks. en-us, it-it).

  • Miljøspecifikke URL-adresser: Skift mellem udviklings-, test- og produktionswebsteder.

Overvejelser

  • Kilder til viden om offentlige websteder bruger Bing-søgning og er afhængige af indekseret indhold.
  • Grænser for URL-dybde gælder stadig, når du bruger variabler.
  • Variabler ændrer kun DESTINATIONS-URL-adressen. De påvirker ikke, hvordan indhold indekseres eller hentes.

Vigtig

Variablen skal oversættes til en gyldig offentlig URL-adresse, der opfylder kravene til kilder til viden om offentlige websteder. Ugyldige eller ikke-understøttede URL-adresser returnerer muligvis ikke resultater.