Använda kodtolken i en uppmaning för att generera och köra Python kod

Genom att använda kodtolken i Microsoft Copilot Studio och promptbyggarpromptar kan skapare bygga AI-agenter som:

• Kör Python-kod för dataanalys, bearbetning av Word, Excel, PowerPoint och PDF-filer samt visualiseringar. Lär dig om begränsningar i Word-dokumentinnehåll i Hur agenten läser uppladdade dokument.
• Använd språkmodeller för generativa svar.

Den här funktionen är skräddarsydd för utvecklare, affärsanalytiker och lågkodstillverkare. Kodgenerering och exekvering integreras smidigt med Copilot Studio-ekosystemet för att skapa kraftfulla, AI-drivna lösningar.

För att lära sig hur man använder Dataverse-meddelandet Predict för att anropa prompts och bearbeta de svar som returneras, bör utvecklare läsa Code Interpreter for developers och granska Code Interpreter Power Apps Component Framework (PCF)-komponentexemplet.

Förutsättningar

• Licensing: Microsoft Copilot Studio fakturering och licensiering. Kodgenerering och körning räknas som text- och generativa AI-verktyg (premiumfunktioner ).

• Regioner som stöds: Tillgängligt för alla offentliga moln. Nationella moln stöds inte för närvarande.

Funktioner för kodtolkar

Agenter som använder kodtolkaren kan skriva och köra Python-kod för avancerade uppgifter. Exempel på användningsfall är:

• Excel-filbehandling: Skapa, kopiera och uppdatera Excel-arbetsblad i en arbetsbok. Läs och tillämpa cellstilar. Kopiera formatering mellan celler. Kopiera och uppdatera formler mellan celler med mera.
• Word och PowerPoint filbearbetning. För Word-dokument läser agenten text från standardstycken och tabeller i dokumentets brödtext. Läs mer i Hur agenten läser uppladdade dokument.
• PDF-filbehandling: Skapa och kopiera PDF-filer. Läs tabeller och textstycken.
• Bearbetning av Dataverse-tabelldata.
• Komplexa matematiska och statistiska beräkningar.
• Dataanalys, datamanipulation och datavisualisering (till exempel diagram och grafer).

Kodtolken lägger till följande funktioner i prompter:

• Stöd för filer som utdatatyp i prompter.
• Stöd för Excel filer som indata- och utdatatyper för frågor.

Skapa prompter på något av två sätt:

• I Power Apps: Använd alternativet Build your own prompt i AI Hub.
• I Copilot Studio: Lägg till en uppmaning som ett verktyg på agent- eller ämnesnivå.

Läs mer om frågor i Översikt över frågor.

Du kan också använda kodtolk i agentchatten i Copilot Studio.

Starta en ny uppmaning i Power Apps AI Hub och aktivera kodtolk

Du kan starta en ny prompt i AI Hub i Power Apps och aktivera kodtolken i promptinställningarna.

1. Gå till Power Apps.

2. Välj AI-hubb i det vänstra fönstret.

3. Välj Prompter.

   

4. Välj Skapa en egen prompt.

   

5. Ange ett namn för din uppmaning.

6. I avsnittet Instruktioner väljer du de tre punkterna (...) och väljer sedan Inställningar.

   

7. Aktivera kodtolkare på Inställningar.

8. Stäng Inställningar för att återgå till frågeredigeraren.

Frågeredigeraren är öppen med kodtolken aktiverad. Skriv sedan instruktioner för din fråga.

Starta en ny uppmaning som ett verktyg inom en programvaruagent och aktivera kodtolken.

Du kan starta en ny fråga som ett verktyg i en agent i Copilot Studio och aktivera kodtolken för den prompten.

1. I Copilot Studio går du till agenten där du vill använda kodtolkare.

2. Lägg till en ny uppmaning till agenten som ett verktyg, antingen på agentnivå eller ämnesnivå.

   • Lägg till en fråga på agentnivå:

     1. Gå till sidan Verktyg .

     2. Välj Lägg till ett verktyg>Fråga.

   • Lägg till en fråga på ämnesnivå:

     1. Gå till sidan Ämnen och välj det ämne där du vill lägga till uppmaningen.

     2. Välj Lägg till nod i den position i ämnet där du vill lägga till prompten.

     3. Välj Lägg till ett verktyg>Ny fråga.

   Gränssnittet för att skapa kommandon med den inbäddade promptbyggaren öppnas.

3. I informationsfältet väljer du de tre punkterna (...) och väljer sedan Inställningar.

   

4. På sidan Inställningar väljer du Aktivera kodtolkare.

5. Stäng Inställningar för att återgå till frågeredigeraren.

Frågeredigeraren är öppen med kodtolken aktiverad. Skriv sedan instruktioner för din fråga.

Skriv instruktioner för din uppmaning

Skriv sedan promptinstruktionerna, konfigurera prompten vid behov och spara för att skapa prompten.

Läs mer om hur du använder kodtolkare i kodtolkar-prompt-exempel.

Metodtips för kodtolk i prompter

• Använd andra AI-verktyg som Copilot för att få den optimerade uppmaningen att starta.
• Använd exakta prompter med exempel (få frågor).
• Ange utdata (till exempel "Returnera som JSON" eller "Excel" eller "PDF").

Limitations

• Det går inte att analysera flera filer som laddats upp i en enda uppmaning.
• Det går inte att returnera flera filoutdata med en enda uppmaning.
• Det går inte att ställa frågor om en uppladdad fil över flera varv.
• För att använda kodtolk behöver du konfigurera din agent i agentinställningarna att använda användarautentisering. Att till exempel använda Direct Line med No authentication selected fungerar inte för scenarier med hjälp av kodtolk.

Troubleshooting

Om du får fel när du använder kodtolkare kan du prova följande steg:

1. Kontrollera att alla nödvändiga behörigheter har beviljats. Kontrollera att användarkontot och agenten har nödvändiga behörigheter för att köra kodtolkarens prompter.
2. Verifiera konfigurationsinställningarna. Bekräfta att kodtolken är aktiverad i promptinställningarna och att agenten är konfigurerad för att använda användarautentisering.
3. Mer information finns i felloggarna. Granska felloggarna i Copilot Studio eller den associerade Power Platform-miljön för att identifiera rotorsaken till problemet och vidta korrigerande åtgärder.

Relaterad information

• Använd kodtolk för att analysera strukturerad data
• Kodtolkare för utvecklare
• PcF-komponentexempel för kodtolk