Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]
Met behulp van code-interpreter kunnen Copilot Studio-agents Python code genereren en uitvoeren wanneer ze moeten reageren op gebruikersprompts. Code-interpreter ondersteunt taken zoals statistische analyse, tabeldeelnames, prognoses en grafiekgeneratie. Deze taken werken met gestructureerde bestanden zoals CSV en Excel.
Belangrijk
Dit artikel bevat Microsoft Copilot Studio preview-documentatie en kan worden gewijzigd.
Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar voor een officiële release zodat u vroeg toegang kunt krijgen en feedback kunt geven.
Als u een productieklare agent bouwt, raadpleegt u Microsoft Copilot Studio Overview.
Het waardevoorstel van het gebruik van code-interpreter voor het analyseren van gestructureerde gegevensbestanden is:
- Met behulp van deterministische, reproduceerbare berekeningen kunt u betrouwbare analyse binnen agents ontgrendelen in plaats van te vertrouwen op de inherente wiskundige en deductiemogelijkheden van het grote taalmodel om analytische vragen te beantwoorden.
- Verlaag de vaardigheidsdrempel voor geavanceerde analyses door gebruikers analytische vragen in natuurlijke taal te laten stellen.
- Genereer tabellen en visualisaties van resultaten programmatisch die gebruikers kunnen zien, downloaden en hergebruiken.
Copilot Studio-agents kunnen code-interpreter gebruiken om gestructureerde bestanden te analyseren die op de agent worden geleverd op de volgende twee manieren:
- Als eindgebruiker uploadt u gestructureerde bestanden tijdens het chatten met de agent.
- Wanneer u als maker SharePoint Documents bibliotheek toevoegt als kennisbron, die de gestructureerde bestanden bevat.
Requirements
Licentiering: Microsoft Copilot Studio licenties en facturering. Aantal keren code genereren en uitvoeren als tekst- en generatieve AI-hulpprogramma's (Premium).
Ondersteunde regio's: beschikbaar voor alle openbare clouds. Soevereine clouds worden momenteel niet ondersteund.
Uitgebreid geteste scenario's
Microsoft heeft de volgende scenario's uitgebreid getest met een hoge mate van vertrouwen.
Opmerking
- Als uw scenario zich niet in de scenario's bevindt die in de tabellen worden vermeld, werkt dit mogelijk nog steeds. De scenario's die in de onderstaande tabellen worden vermeld, weerspiegelen de groep scenario's die Microsoft uitgebreid heeft getest op basis van het verwachte gebruik van de klant.
- De groottelimiet voor elk bestand dat kan worden geanalyseerd door code-interpreter, ongeacht het bestandstype, is 16 MB. U kunt maximaal 10 bestanden uploaden.
Scenario's voor Excel-bestanden (.xlsx)
| Categorie | Beschrijving van scenario | Voorbeeld 1 | Voorbeeld 2 | Voorbeeld 3 |
|---|---|---|---|---|
| Opzoeken - één blad | Een specifieke waarde, label of record ophalen uit één blad van een Excel-bestand. Geen verwerking over meerdere rijen nodig. Het antwoord is te vinden via een directe opzoekactie in cellen/rijen. Behandelt numerieke waarden, tekstkenmerken (namen, rollen, categorieën) en tijdstempels. | Welke doelen zijn uitgerust met een zijnet van minimaal drie doelnetten? | Wat was de vrije kasstroom in het Q4 2024? | Tot welk segment behoren de groothandelsbrandstoffen vanaf Q1 2024? |
Scenario's voor .csv bestanden
| Categorie | Beschrijving van scenario | Voorbeeld 1 | Voorbeeld 2 | Voorbeeld 3 |
|---|---|---|---|---|
| Opzoeken - één bestand | Haal een specifieke waarde, kenmerk of record op uit één CSV-bestand. Behandelt het opzoeken van entiteiten (contactpersonen, luchthavens, windprojecten), het ophalen van waardes op specifieke tijdstippen en kleine opzoekacties voor tabellen. Er is geen aggregatie tussen rijen vereist. | Wie is de ontwikkelaar van het Sunrise Wind-project? | Hoeveel motorfietsen zijn in Tennessee geregistreerd in 1970? | Wie is eigenaar van het vliegveld Horseshoe Landings in Keenesburg, CO? |
| Aggregaat - één bestand | Bereken totalen, aantallen, verschillen, gegroepeerde samenvattingen of gerangschikte zoekacties binnen één CSV-bestand. Behandelt financiële aggregaties, voorwaardelijke tellingen, gerangschikte ophaalbewerkingen (max/min) en samenvattingen op groepsniveau die worden geretourneerd als getallen, tekst of tabellen. | Wat was de totale royaltywaarde van de verkoop van olie aan wal in 2019? | Hoeveel vrachtwagens zijn er in 2020 geregistreerd in Californië dan in 2010? | Wat is de totale omzet die in januari 2025 door elke regio wordt gegenereerd? |
| Opzoeken - meerdere bestanden | Voeg meerdere CSV-bestanden toe of verwijs er kruislings naar om een specifieke waarde of lijst op te halen (bijvoorbeeld door inventaris op te zoeken door namen van onderdelen in een onderdelenlijst, inventaris en prijslijst op te zoeken; of door query's uit te voeren op emissiegegevens door sectornamen toe te voegen aan een hoofduitstootbestand). | Hoeveel waterstraalsnijders zijn er beschikbaar in het East warehouse? | Wat is de educatieve prijs van een 10x24 lathe? | Hoeveel boorbits van 3/8 zijn er op voorraad in het magazijn Oost? |
| Aggregaat - meerdere bestanden | Gegevens aggregeren of vergelijken verspreid over meerdere CSV-bestanden (bijvoorbeeld het optellen van werknemersuren in maandelijkse CSV's voor een kwartaaltotaal, het tellen van deals over jaarlijkse CSV-exports of classificatiesectoren op basis van emissies in gekoppelde bestanden). | Hoeveel totale werkuren zijn opgenomen in Q3? | Wat was het vroegste tijdstip dat Chris in juli begon met werken? | Welke sector heeft in 2020 het meeste CO2 geproduceerd? |
Gebruik de code-interpreter voor de analyse van een door de gebruiker geüploade gestructureerd databestand
Selecteer in Copilot Studio Instellingen>Generatieve AI. Schakel de functie Bestandsuploads in onder Bestandsverwerkingsmogelijkheden.
Schakel onder Bestandsverwerkingsmogelijkheden de schakelaar Code interpreter in.
Selecteer Opslaan.
Schrijf in het testvenster een query waarvoor de agent een berekening moet uitvoeren met behulp van gegevens uit een gestructureerd gegevensbestand. Voeg het gegevensbestand toe aan de prompt.
Maak een screenshot van een testpaneel met een prompt waarin gevraagd wordt om code te genereren en uit te voeren om taken te voltooien en bijlage van een gestructureerd databestand toe te voegen.
Gebruik de code-interpreter voor de analyse van een gestructureerd databestand als kennisbron voor SharePoint
Als uw agent nog geen SharePoint gestructureerd gegevensbestand als kennisbron heeft, dit SharePoint-bestand als kennisbron toevoegen.
Selecteer in Copilot Studio Instellingen>Generatieve AI. Schakel onder Bestandsverwerkingsmogelijkheden de schakelaar Code interpreter in.
Onder Zoeken zet u de tenantgrafiek-instelling aan met de semantische zoekschakelaar.
Selecteer Opslaan.
Als u in de eerste stap een SharePoint-bestand hebt toegevoegd, moet u de agent publiceren.
Test uw agent door deze een query te geven waarvoor de agent een berekening moet uitvoeren om te kunnen antwoorden.