Bruk kodetolker i en ledetekst til å generere og kjøre Python kode

Kodetolker i Microsoft Copilot Studio og promptbyggeren lar brukere bygge AI-agenter som:

  • Utfør Python kode for dataanalyse, behandling av Word, Excel, PowerPoint og PDF-filer og visualiseringer
  • Bruk språkmodeller for generative svar

Denne funksjonen er tilpasset utviklere, forretningsanalytikere og lavkodeutviklere. Kodegenerering og utførelse integreres sømløst med det Copilot Studio økosystemet for å skape kraftige, AI-drevne løsninger.

Utviklere bør lese Kodetolker for utviklere og se gjennom Code-tolken Power Apps component Framework (PCF)-komponenteksempel for å forstå hvordan de kan bruke Dataverse-Predict-meldingen til å aktivere ledetekster og behandle svarene som returneres.

Forutsetninger

Kodetolkerfunksjoner

Agenter som bruker kodetolker, kan skrive og kjøre Python kode for avanserte oppgaver. Brukstilfeller omfatter følgende:

  • Excel filbehandling: Opprette, kopiere og oppdatere Excel regneark i en arbeidsbok, lese og bruke cellestiler, kopiere formatering på tvers av celler, kopiere og oppdatere formler på tvers av celler og mer.
  • Word og PowerPoint filbehandling.
  • PDF-filbehandling: Opprette og kopiere PDF-filer, lese tabeller og tekstavsnitt.
  • Datavers tabelldatabehandling.
  • Kompliserte matematiske og statistiske beregninger.
  • Dataanalyse, manipulering og visualisering (f.eks. diagrammer og grafer).

Kodetolk legger til følgende funksjoner i instruksjoner:

  • Støtte for filer som utdatatype i ledetekster.
  • Støtte for Excel filer som inndata- og utdatatyper for ledetekster.

Opprett ledetekster på én av to måter:

  • I Power Apps: Bruk alternativet Bygg din egen ledetekst i AI Hub.
  • I Copilot Studio: Legg til en ledetekst som et verktøy på agent- eller emnenivå.

Finn ut mer om ledetekster i ledetekstoversikt.

Du kan også bruke kodetolk i agentchat i Copilot Studio.

Start en ny ledetekst i Power Apps AI Hub, og aktiver kodetolk

Du kan starte en ny ledetekst i AI Hub i Power Apps og aktivere kodetolker i ledetekstinnstillingene.

  1. Gå til Power Apps.

  2. Velg AI-hub i den venstre ruten.

  3. Velg Instruksjoner.

    Skjermbilde av å velge ledetekster i AI-huben.

  4. Velg Lag ditt eget spørsmål.

    Skjermbilde av å velge bygg din egen ledetekst i AI-huben.

  5. Skriv inn et navn for ledeteksten.

  6. Velg de tre prikkene (...) i Instruksjoner-delen, og velg deretter Innstillinger.

    Skjermbilde av hvordan du åpner ledetekstinnstillinger.

  7. Aktiver kodetolk ved innstillinger.

  8. Lukk Innstillinger for å gå tilbake til redigeringsprogrammet for ledetekst.

Redigeringsprogrammet for ledetekst er åpent med kodetolker aktivert. Deretter skriver du instruksjoner for ledeteksten.

Start en ny ledetekst som et verktøy i en agent, og slå på kodetolker

Du kan starte en ny ledetekst som et verktøy i en agent i Copilot Studio og aktivere kodetolker for denne ledeteksten.

  1. Gå til agenten der du vil bruke kodetolk i Copilot Studio.

  2. Legg til en ny ledetekst i agenten som et verktøy, enten på agentnivå eller emnenivå.

    • Legg til en ledetekst på agentnivå:

      1. Gå til Verktøy-siden .

      2. Velg Legg til et verktøy>Kommando.

    • Legg til en ledetekst på emnenivå:

      1. Gå til Emner-siden , og velg emnet der du vil legge til ledeteksten.

      2. Velg Legg til node i plasseringen i emnet der du vil legge til ledeteksten.

      3. Velg Legg til et verktøy>Ny ledetekst.

    Det innebygde ledeverktøyets ledetekstredigeringsgrensesnitt åpnes.

  3. Velg de tre prikkene (...) på informasjonslinjen, og velg deretter Innstillinger.

    Skjermbilde av innstillingene for åpningsledetekst.

  4. Velg Aktiver kodetolk på siden Innstillinger.

  5. Lukk Innstillinger for å gå tilbake til redigeringsprogrammet for ledetekst.

Redigeringsprogrammet for ledetekst er åpent med kodetolker aktivert. Deretter skriver du instruksjoner for ledeteksten.

Skrive instruksjoner for ledeteksten

Deretter kan du skrive ledetekstinstruksjonene, konfigurere ledeteksten etter behov og lagre for å opprette ledeteksten.

Lær mer om hvordan du bruker kodetolker i ledetekster i ledeteksteksempler for kode.

Anbefalte fremgangsmåter for kodetolker i ledetekster

  • Bruk andre kunstig intelligens-verktøy som Copilot for å få den optimaliserte ledeteksten til å starte.
  • Bruk nøyaktige instruksjoner med eksempler (few-shot-instruksjon).
  • Angi utdata (for eksempel «Returner som JSON» eller «Excel» eller «PDF»).

Begrensninger

  • Analyse av flere filer som er lastet opp i én enkelt ledetekst, støttes ikke.
  • Retur av flere filutdata i én enkelt ledetekst støttes ikke.
  • Det støttes ikke å stille spørsmål om en opplastet fil over flere ganger.
  • For å bruke kodetolker må du konfigurere agenten din i agentinnstillingene til å bruke brukerautentisering. Hvis du for eksempel bruker Direct Line med No authentication valgt, fungerer ikke for scenarioer som bruker kodetolker.

Feilsøking

Hvis det oppstår feil når du bruker kodetolker, kan du prøve følgende fremgangsmåte:

  1. Kontroller at alle nødvendige tillatelser er gitt. Kontroller at brukerkontoen og agenten har de nødvendige tillatelsene til å kjøre ledetekster for kodetolker.
  2. Kontroller konfigurasjonsinnstillingene. Bekreft at kodetolker er aktivert i ledetekstinnstillingene, og at agenten er konfigurert til å bruke brukergodkjenning.
  3. Se feillogger for detaljert informasjon. Se gjennom feilloggene i Copilot Studio eller det tilknyttede Power Platform-miljøet for å identifisere årsaken til problemet og utføre korrigerende tiltak.