Een code-interpreter gebruiken om Python-code te genereren en uit te voeren

Met codeinterpreter 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 pcF-onderdeelvoorbeeld (Code Interpreter Power Apps Component Framework) controleren om te begrijpen hoe ze het Dataverse-bericht Predict kunnen gebruiken om prompts aan te roepen en de geretourneerde antwoorden te verwerken.

Requirements

• Licentieverlening: Facturering en licenties voor Microsoft Copilot Studio. 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 de code-interpretatiefunctie in één oogopslag

Met de code-interpretatiefunctie kunnen agents Python-code schrijven en uitvoeren voor geavanceerde taken. Gebruiksvoorbeelden zijn onder andere:

• Verwerking van Excel-bestanden: Excel-werkbladen maken, kopiëren en bijwerken in een werkmap, StyleNames lezen, StyleNames toepassen, opmaak kopiëren tussen cellen, formules kopiëren en bijwerken in cellen, enzovoort.
• Verwerking van Word- en PowerPoint-bestanden.
• Verwerking van PDF-bestanden: PDF-bestanden maken en kopiëren, tabellen lezen en alinea's voor tekst 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

U kunt op twee manieren prompts maken:

• De optie Uw eigen prompt bouwen gebruiken in AI Hub in Power Apps
• Binnen een prompthulpprogramma dat is toegevoegd aan een agent in Copilot Studio op agentniveau

Voor meer informatie over prompts, zie Promptsoverzicht.

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

Een nieuwe lege prompt maken en code-interpreter inschakelen voor de prompt

Eerst begint u met het maken van een nieuwe lege prompt in AI Hub of Copilot Studio. Vervolgens schakelt u de code-interpreter in in de promptinstellingen.

Prompt maken in Power Apps AI Hub en code-interpreter inschakelen

U kunt een nieuwe lege prompt maken in AI Hub in Power Apps en code-interpreter inschakelen in de promptinstellingen. U kunt voorbeelden zien van het schrijven en configureren van prompts die gebruikmaken van code-interpreter. Zie Code-interpreter gebruiken in promptvoorbeelden.

1. Ga naar Power Apps.

2. Selecteer AI-hub in het linkerdeelvenster.

3. Selecteer Prompts.

   

4. Selecteer Uw eigen prompt bouwen.

   

5. Geef de naam van uw prompt op.

6. Selecteer in het gedeelte Instructies de drie stippen (...), en selecteer vervolgens Instellingen.

   

7. Schakel op de pagina Instellingen code-interpreter in.

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

Er wordt een lege prompt gemaakt met de code-interpreter ingeschakeld. Vervolgens kunt u de promptinstructies schrijven en de prompt zo nodig configureren.

Een prompt maken als een hulpprogramma in een agent en code-interpreter inschakelen

U kunt een nieuwe lege prompt maken als een hulpprogramma in een agent in Copilot Studio en de code-interpreter voor die prompt inschakelen. Verderop in dit artikel laten we u zien hoe u een prompt schrijft en configureert die gebruikmaakt van een code-interpreter.

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

2. Selecteer het tabblad Hulpprogramma's en selecteer vervolgens Een hulpprogramma toevoegen>Nieuw hulpprogramma>Prompt.

   

   De ingesloten interface voor het maken van prompts wordt geopend in Copilot Studio.

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

   

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

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

Er wordt een lege prompt gemaakt met de code-interpreter ingeschakeld. Vervolgens kunt u de promptinstructies schrijven en de prompt zo nodig configureren.

Volgende acties met de code-interpreter in prompts

Vervolgens kunt u de promptinstructies schrijven en de prompt zo nodig configureren.

Zie Code-interpreterpromptvoorbeelden voor gedetailleerde voorbeelden van hoe je een code-interpreter kunt gebruiken in prompts.

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. Bijvoorbeeld, het gebruik van de Direct Line zonder authenticatie geselecteerd werkt niet voor scenario's met code interpreter.

Verwante informatie

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