Code-interpreter gebruiken in een prompt om Python code te genereren en uit te voeren

Met code-interpreter in Microsoft Copilot Studio en prompt builder-prompts kunnen makers AI-agents bouwen die:

• Python code uitvoeren voor gegevensanalyse, verwerking van Word, Excel, PowerPoint en PDF-bestanden en visualisaties
• Taalmodellen gebruiken voor generatieve reacties

Deze functie is afgestemd op ontwikkelaars, bedrijfsanalisten en makers met weinig code. Het genereren en uitvoeren van code kan naadloos worden geïntegreerd met het Copilot Studio ecosysteem om krachtige, AI-gestuurde oplossingen te maken.

Ontwikkelaars moeten Code-interpreter voor ontwikkelaars lezen en het Code-interpreter Power Apps PCF-onderdeelvoorbeeld (Component Framework) bekijken om te begrijpen hoe ze het Dataverse-Predict-bericht kunnen gebruiken om prompts aan te roepen en de geretourneerde antwoorden te verwerken.

Requirements

• Licentiesing: Microsoft Copilot Studio facturering en licenties. Aantal keren code genereren en uitvoeren als tekst- en generatieve AI-hulpprogramma's (Premium).

• Ondersteunde regio's: beschikbaar voor alle openbare clouds. Onafhankelijke clouds worden momenteel niet ondersteund.

Mogelijkheden van code-interpreters

Agents die code-interpreter gebruiken, kunnen Python code schrijven en uitvoeren voor geavanceerde taken. Gebruiksvoorbeelden zijn onder andere:

• Excel bestandsverwerking: Excel werkbladen in een werkmap maken, kopiëren en bijwerken, celstijlen lezen en toepassen, opmaak kopiëren tussen cellen, formules kopiëren en bijwerken in cellen en meer.
• Word en PowerPoint bestandsverwerking.
• VERWERKING van PDF-bestanden: PDF-bestanden maken en kopiëren, tabellen en tekst alinea's lezen.
• Gegevensverwerking van Dataverse-tabel.
• Complexe wiskundige en statistische berekeningen.
• Gegevensanalyse, manipulatie en visualisatie (bijvoorbeeld grafieken).

Code-interpreter voegt de volgende mogelijkheden toe aan prompts:

• Ondersteuning voor bestanden als uitvoertype in prompts.
• Ondersteuning voor Excel bestanden als invoer- en uitvoertypen voor prompts.

Maak op twee manieren prompts:

• In Power Apps: Gebruik de optie Build your own prompt in AI Hub.
• In Copilot Studio: Voeg een prompt toe als tool op het niveau van de agent of het thema.

Meer informatie over prompts in het overzicht voor prompts.

U kunt ook code-interpreter gebruiken in agentchat in Copilot Studio.

Een nieuwe prompt starten in Power Apps AI Hub en code-interpreter inschakelen

U kunt een nieuwe prompt starten in AI Hub in Power Apps en code-interpreter inschakelen in de promptinstellingen.

1. Ga naar Power Apps.

2. Selecteer AI-hub in het linkerdeelvenster.

3. Selecteer Prompts.

   

4. Selecteer Uw eigen prompt bouwen.

   

5. Voer een naam in voor uw prompt.

6. Selecteer in de sectie Instructies de drie puntjes (...) en selecteer vervolgens Instellingen.

   

7. Schakel in Instellingen de code-interpreter in.

8. Sluit Instellingen om terug te keren naar de prompteditor.

De prompteditor is geopend met de code-interpreter ingeschakeld. Schrijf vervolgens instructies voor uw prompt.

Een nieuwe prompt starten als een hulpprogramma binnen een agent en code-interpreter inschakelen

U kunt een nieuwe prompt starten als een hulpprogramma in een agent in Copilot Studio en code-interpreter voor die prompt inschakelen.

1. Ga in Copilot Studio naar de agent waar u de code-interpreter wilt gebruiken.

2. Voeg een nieuwe prompt toe aan de agent als hulpprogramma, op agentniveau of op onderwerpniveau.

   • Voeg een prompt toe op agentniveau:

     1. Ga naar de pagina Extra.

     2. Selecteer Een tool toevoegen>Prompt.

   • Voeg een prompt toe op onderwerpniveau:

     1. Ga naar de pagina Onderwerpen en selecteer het onderwerp waaraan u de prompt wilt toevoegen.

     2. Selecteer Het knooppunt Toevoegen in de positie in het onderwerp waar u de prompt wilt toevoegen.

     3. Selecteer Voeg een tool toe>Nieuwe prompt.

   De ontwerpinterface voor ingebedde promptbouwers wordt geopend.

3. Selecteer op de informatiebalk de drie puntjes (...) en selecteer vervolgens Instellingen.

   

4. Selecteer op de pagina Instellingen de optie Code-interpretatiefunctie inschakelen.

5. Sluit Instellingen om terug te keren naar de prompteditor.

De prompteditor is geopend met de code-interpreter ingeschakeld. Schrijf vervolgens instructies voor uw prompt.

Instructies schrijven voor uw prompt

Vervolgens kunt u de promptinstructies schrijven, de prompt zo nodig configureren en opslaan om de prompt te maken.

Meer informatie over hoe je de Code Interpreter kunt gebruiken in prompts vind je in voorbeelden van prompts voor de Code Interpreter.

Aanbevolen procedures voor code-interpreter in prompts

• Gebruik andere AI-hulpprogramma's zoals Copilot om de geoptimaliseerde prompt te krijgen om te beginnen.
• Gebruik nauwkeurige prompts met voorbeelden (few-shot prompting).
• Geef uitvoer op (bijvoorbeeld 'Retourneren als JSON' of 'Excel' of 'PDF').

Beperkingen

• Het analyseren van meerdere bestanden die in één prompt zijn geüpload, wordt niet ondersteund.
• Het retourneren van meerdere bestandsuitvoer in één prompt wordt niet ondersteund.
• Het stellen van vragen over een geüpload bestand over meerdere beurten wordt niet ondersteund.
• Om code interpreter te gebruiken, moet je je agent in agentinstellingen configureren om gebruikersauthenticatie te gebruiken. Als u bijvoorbeeld Direct Line gebruikt met Geen verificatie geselecteerd, werkt dit niet voor scenario's met een code-interpreter.

Troubleshooting

Als er fouten optreden bij het gebruik van code-interpreter, voert u de volgende stappen uit:

1. Zorg ervoor dat alle vereiste machtigingen zijn verleend. Controleer of het gebruikersaccount en de agent over de benodigde machtigingen beschikken om code-interpreterprompts uit te voeren.
2. Controleer de configuratie-instellingen. Controleer of de code-interpreter is ingeschakeld in de promptinstellingen en of uw agent is geconfigureerd voor het gebruik van gebruikersverificatie.
3. Raadpleeg de foutenlogboeken voor gedetailleerde informatie. Bekijk de foutenlogboeken in Copilot Studio of de bijbehorende Power Platform-omgeving om de hoofdoorzaak van het probleem te identificeren en corrigerende maatregelen te nemen.

Verwante informatie

• Gebruik de code-interpreter om gestructureerde data te analyseren
• Code-interpreter voor ontwikkelaars
• Voorbeeld van PCF-component van code-interpreter