Dela via


Använda kodtolkare för att analysera strukturerade data (förhandsversion)

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Med hjälp av kodtolken kan Copilot Studio-agenter generera och köra Python kod när de behöver svara på användarfrågor. Kodtolkaren stöder uppgifter som statistisk analys, tabellkopplingar, prognostisering och diagramgenerering. Dessa uppgifter fungerar med strukturerade filer som CSV och Excel.

Viktigt!

Den här artikeln innehåller Microsoft Copilot Studio förhandsversionsdokumentation och kan komma att ändras.

Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att du kan få tidig tillgång och ge feedback.

Om du skapar en produktionsklar agent kan du läsa Översikt över Microsoft Copilot Studio.

Värdeförslaget för att använda kodtolkare för att analysera strukturerade datafiler är:

  • Genom att använda deterministisk, reproducerbar beräkning kan du låsa upp tillförlitlig analys inuti agenter i stället för att förlita dig på den stora språkmodellens inneboende matematik- och slutsatsdragningsfunktioner för att besvara analytiska frågor.
  • Sänk kompetensbarriären för avancerad analys genom att låta användare ställa analytiska frågor på naturligt språk.
  • Generera tabeller och visualiseringar av resultat programmatiskt som användare kan se, ladda ner och återanvända.

Copilot Studio-agenter kan använda kodtolkare för att analysera strukturerade filer som tillhandahålls till agenten på följande två sätt:

  • När du laddar upp strukturerade filer medan du chattar med agenten som slutanvändare.
  • När du som tillverkare lägger till biblioteket SharePoint Documents som kunskapskälla, som i sin tur innehåller de strukturerade filerna.

Kravspecifikation

Omfattande testade scenarier

Microsoft har testat följande scenarier i stor utsträckning med hög konfidensnivå.

Anmärkning

  • Om ditt scenario inte hör till scenarierna i tabellerna kan det fortfarande fungera. Scenarierna som anges i tabellerna nedan återspeglar den grupp scenarier som Microsoft har testat i stor utsträckning baserat på förväntad kundanvändning.
  • Storleksgränsen för varje fil som kan analyseras av kodtolkaren, oavsett filtyp, är 16 MB. Du kan ladda upp högst 10 filer.

Scenarier för Excel-filer (.xlsx)

Kategori Scenariobeskrivning Exempel 1 Exempel 2 Exempel 3
Uppslag – enkelt blad Hämta ett specifikt värde, en etikett eller en post från ett enda blad i en Excel-fil. Ingen korsradsberäkning behövs. Svaret finns som en direkt cell-/radsökning. Omfattar numeriska värden, textattribut (namn, roller, kategorier) och tidsstämplar. Vilka matcher inkluderar ett lag som gör minst tre mål? Vad var det fria kassaflödet under kvartal 4 2024? Vilket segment tillhör grossistbränslen från och med första kvartalet 2024?

Scenarier för .csv filer

Kategori Scenariobeskrivning Exempel 1 Exempel 2 Exempel 3
Uppslag – enskild fil Hämta ett specifikt värde, ett attribut eller en post från en enda CSV-fil. Omfattar entitetssökningar (kontakter, flygplatser, vindkraftsprojekt), hämtning av värden vid en viss tidpunkt och små tabellsökningar. Ingen aggregering över rader krävs. Vem är utvecklare av Projektet Sunrise Wind? Hur många motorcyklar registrerades i Tennessee 1970? Vem äger Horseshoe Landings flygplats i Keenesburg, CO?
Aggregera – enskild fil Beräkna summor, antal, skillnader, grupperade sammanfattningar eller rankade uppslag i en enda CSV-fil. Omfattar finansiella aggregeringar, villkorsstyrda antal, rangordnade hämtningar (max/min) och sammanfattningar på gruppnivå som returneras som tal, text eller tabeller. Vad var det totala royaltyvärdet för onshore-oljeförsäljning under 2019? Hur många fler lastbilar registrerades i Kalifornien 2020 än 2010? Vilka är de totala försäljningsintäkterna som genereras av varje region i januari 2025?
Uppslag – flera filer Koppla eller korsreferensera flera CSV-filer för att hämta ett specifikt värde eller en lista (till exempel genom att söka efter lager genom att matcha delnamn i en reservlista, inventering och prislista eller fråga efter utsläppsdata genom att koppla sektornamn till en huvudutsläppsfil). Hur många vattenstråleskärare finns det i östlagret? Vad är utbildningspriset för en 10x24 svarv? Hur många 3/8"-borrbitar finns i lager i det östra lagret?
Aggregera – flera filer Aggregera eller jämföra data som är spridda över flera CSV-filer (till exempel summera anställdas timmar över månatliga CSV:er för en kvartalssumma, räkna erbjudanden över årliga CSV-exporter eller rangordna sektorer efter utsläpp mellan anslutna filer). Hur många totala arbetstimmar registrerades under tredje kvartalet? Vilken var den tidigaste gången Chris stämplade in under juli? Vilken sektor producerade mest koldioxid 2020?

Använd kodtolk för analys av en användaruppladdad strukturerad datafil

  1. I Copilot Studio väljer du Settings>Generativ AI. Under Filbearbetningsfunktioner aktiverar du växlingsknappen Filuppladdningar .

  2. Under avsnittet Filbehandlingsfunktioner, aktivera Kodtolken.

  3. Välj Spara.

  4. I testfönstret skriver du en fråga som kräver att agenten utför en beräkning med hjälp av data från en strukturerad datafil. Bifoga datafilen i prompten.

    Ta en skärmdump av en testpanel som visar prompt som kräver generering och exekvering av kod för att slutföra samt bifogande av den strukturerade datafilen.

Använda kodtolkare för analys av en strukturerad datafil som en SharePoint-kunskapskälla

  1. Om din agent inte redan har en SharePoint strukturerad datafil som kunskapskälla lägg till den här SharePoint filen som kunskapskälla.

  2. I Copilot Studio väljer du Settings>Generativ AI. Under avsnittet Filbehandlingsfunktioner, aktivera Kodtolken.

  3. Under Sök, slå på växeln för hyresgästgrafen med semantisk sökning.

  4. Välj Spara.

  5. Om du har lagt till en SharePoint fil enligt anvisningarna i det första steget publicerar du din agent.

  6. Testa din agent genom att ge den en fråga som kräver att agenten gör en beräkning för att kunna svara.