Dela via

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

Med kodtolken i Microsoft Copilot Studio och prompt builder-prompter kan skaparna skapa AI-agenter som:

  • Kör Python kod för dataanalys, bearbetning Word, Excel, PowerPoint- och PDF-filer samt visualiseringar
  • Använda språkmodeller för generativa svar

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

Utvecklare bör läsa Code-tolken för utvecklare och granska komponentexemplet Code Power Apps Component Framework(PCF) för att förstå hur de kan använda Dataverse-Predict meddelande för att anropa uppmaningar och bearbeta svaren som returneras.

Kravspecifikation

Funktioner för kodtolkar

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

  • Excel filbearbetning: Skapa, kopiera och uppdatera Excel kalkylblad i en arbetsbok, läsa och tillämpa cellformat, kopiera formatering mellan celler, kopiera och uppdatera formler mellan celler med mera.
  • Word och PowerPoint filbearbetning.
  • PDF-filbearbetning: Skapa och kopiera PDF-filer, läsa tabeller och textstycken.
  • Bearbetning av Dataverse-tabelldata.
  • Komplexa matematiska och statistiska beräkningar.
  • Dataanalys, manipulering och visualisering (till exempel diagram och diagram).

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 kodtolkare 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.

    Skärmbild av att välja prompter i AI-hubben.

  4. Välj Skapa en egen prompt.

    Skärmbild av att välja skapa en egen fråga i AI Hub.

  5. Ange ett namn för din uppmaning.

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

    Skärmbild av hur du öppnar promptinstä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.

    Skärmbild av inställningarna för att öppna prompten.

  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

Sedan kan du skriva anvisningarna för prompten, konfigurera prompten efter 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").

Begränsningar

  • 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.

Felsökning

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.
  • Last updated on