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

Door gebruik te maken van de codeinterpreter in Microsoft Copilot Studio en promptbuilder-prompts, kunnen makers AI-agenten bouwen die:

• Voer Python-code uit voor data-analyse, verwerking van Word-, Excel-, PowerPoint- en PDF-bestanden, en visualisaties. Lees meer over de beperkingen van Word-documentinhoud in Hoe de agent geüploade documenten leest.
• Gebruik taalmodellen 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.

Om te leren hoe je het Dataverse-bericht Predict gebruikt om prompts aan te roepen en de teruggegeven antwoorden te verwerken, moeten ontwikkelaars Code interpreter voor ontwikkelaars lezen en het Code Interpreter Power Apps Component Framework (PCF) componentvoorbeeld bekijken.

Prerequisites

• Licentieverlening: Facturering en licenties voor Microsoft Copilot Studio. Codegeneratie en -uitvoering vallen onder de functies voor tekst en generatieve AI (premium).

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

Mogelijkheden van code-interpreters

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

• Excel-bestandsverwerking: Maak Excel-werkbladen aan, kopieer en werk ze bij in een werkboek. Lees en pas celstijlen toe. Kopieer opmaak tussen cellen. Kopieer en werk formules bij in meerdere cellen, en meer.
• Word en PowerPoint bestandsverwerking. Voor Word-documenten leest de agent tekst uit standaardparagrafen en tabellen in de documenttekst. Lees meer in Hoe de agent geüploade documenten leest.
• PDF-bestandsverwerking: Maak en kopieer PDF-bestanden. Lees tabellen en tekstparagrafen.
• 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 vindt u in Overzicht van 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 Hulpprogramma's.

     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 ingesloten interface voor het ontwerpen van prompts 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 schrijf je de prompt-instructies, configureer je de prompt indien nodig en sla je op 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').

Limitations

• 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