Condividi tramite

Usare l'interprete di codice in un prompt per generare ed eseguire codice Python

L'interprete di codice in Microsoft Copilot Studio e i prompt dei generatori di richieste consentono agli autori di creare agenti di intelligenza artificiale che:

  • Eseguire codice Python per l'analisi dei dati, l'elaborazione di file Word, Excel, PowerPoint e PDF, e visualizzazioni.
  • Utilizzare modelli linguistici per le risposte generative

Questa funzione è pensata per gli sviluppatori, gli analisti aziendali e i creatori di low-code. La generazione e l'esecuzione del codice si integrano perfettamente con l'ecosistema di Copilot Studio per creare soluzioni avanzate basate sull'intelligenza artificiale.

I programmatori dovrebbero leggere l'interprete del codice per sviluppatori ed esaminare il campione di esempio del componente Power Apps Component Framework (PCF) per capire come possono utilizzare il messaggio Predict Dataverse per attivare prompt e processare le risposte restituite.

Requisiti

Le funzionalità dell'interprete di codice in un colpo d'occhio

L'interprete del codice consente agli agenti di scrivere ed eseguire Python codice per le attività avanzate. I casi d'uso includono:

  • Elaborazione di file Excel: creare, copiare e aggiornare fogli di lavoro Excel in una cartella di lavoro, leggere StyleNames, applicare StyleNames, copiare la formattazione tra le celle, copiare e aggiornare le formule tra le celle e così via.
  • l'elaborazione di file Word e PowerPoint.
  • Elaborazione di file PDF: Creare e copiare file PDF, leggere tabelle e paragrafi di testo.
  • Elaborazione dei dati della tabella dataverse.
  • Calcoli matematici e statistici complessi.
  • Analisi, manipolazione e visualizzazione dei dati (ad esempio, grafici e diagrammi).

L'interprete di codice aggiunge le seguenti funzionalità ai prompt:

  • Supporto per i file come tipo di output nelle richieste
  • Supporto per i file Excel come tipi di input e output per richieste

È possibile creare richieste in due modi:

  • Usando l'opzione Crea il proprio prompt in AI Hub in Power Apps
  • All'interno di uno strumento prompt aggiunto a un agente in Copilot Studio a livello di agente

Per altre informazioni sui prompt, vedere Panoramica dei prompt.

È anche possibile usare l'interprete del codice nella chat dell'agente in Copilot Studio.

Creare un nuovo prompt vuoto e attivare l'interprete del codice per il prompt

Prima di tutto, creare una nuova richiesta vuota nell'hub di intelligenza artificiale o in Copilot Studio. Attivare quindi l'interprete del codice nelle impostazioni di richiesta.

Creare una richiesta nell'hub di intelligenza artificiale Power Apps e attivare l'interprete del codice

È possibile creare un nuovo prompt vuoto nell'hub di intelligenza artificiale in Power Apps e attivare l'interprete del codice nelle impostazioni del prompt. È possibile visualizzare esempi di come scrivere e configurare richieste che usano l'interprete del codice, vedere Usare l'interprete del codice negli esempi di richieste.

  1. Passare a Power Apps.

  2. Selezionare Hub di intelligenza artificiale nel riquadro sinistro.

  3. Selezionare Prompts.

    Screenshot della selezione delle richieste nell'hub di intelligenza artificiale.

  4. Seleziona Crea la tua richiesta.

    Screenshot della selezione del prompt di compilazione personalizzato nell'hub IA.

  5. Indicare il nome della richiesta.

  6. Nella sezione Istruzioni , seleziona i tre punti (...), poi seleziona Impostazioni.

    Screenshot per aprire le impostazioni del prompt.

  7. Nella pagina Impostazioni attivare l'interprete del codice.

  8. Chiudere la pagina delle impostazioni per tornare all'editor dei prompt.

Viene creato un prompt vuoto con l'interprete del codice attivato. Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Creare un prompt come strumento all'interno di un agente e attivare l'interprete del codice

È possibile creare un nuovo prompt vuoto come strumento all'interno di un agente in Copilot Studio e attivare l'interprete del codice per tale richiesta. Più avanti in questo articolo viene illustrato come scrivere e configurare un prompt che usa l'interprete del codice.

  1. In Copilot Studio passare all'agente in cui si vuole attivare l'interprete del codice.

  2. Selezionare la scheda Strumenti, quindi selezionare Aggiungi uno strumento>Nuovo strumento>Prompt.

    Screenshot della selezione di uno strumento di comando.

    L'interfaccia di creazione dei prompt del costruttore di prompt incorporato si apre in Copilot Studio.

  3. Nella barra delle informazioni, seleziona i tre punti (...), poi seleziona Impostazioni .

    Screenshot delle impostazioni del prompt di apertura.

  4. Nella pagina Impostazioni, seleziona Abilita interprete di codice.

  5. Chiudere la pagina delle impostazioni per tornare all'editor dei prompt.

Viene creato un prompt vuoto con l'interprete del codice attivato. Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Passaggi successivi con l'interprete del codice nelle richieste

Successivamente, è possibile scrivere le istruzioni del prompt e configurare il prompt in base alle esigenze.

Per esempi dettagliati su come usare l'interprete di codice nei prompt, vedere Esempi di prompt dell'interprete del codice.

Migliori pratiche per l'interprete di codice nei prompt

  • Usare altri strumenti di intelligenza artificiale come Copilot per avviare il prompt ottimizzato.
  • Usare suggerimenti precisi con esempi (pochi colpi).
  • Specificare gli output (ad esempio, "Restituisci come JSON" o "Excel" o "PDF").

Limitazioni

  • L'analisi di più file caricati in un'unica richiesta non è supportata.
  • La restituzione di più output di file in un singolo prompt non è supportata.
  • Le domande su un file caricato su più turni non sono supportate.
  • Per usare l'interprete del codice, devi configurare il tuo agente, nelle impostazioni dell'agente, per usare l'autenticazione utente. Ad esempio, usare Direct line senza autenticazione selezionata non funziona per scenari che utilizzano l'interprete di codice.

Risoluzione dei problemi

Se si verificano errori quando si usa l'interprete di codice, provare la procedura seguente:

  1. Verificare che siano concesse tutte le autorizzazioni necessarie. Verificare che l'account utente e l'agente dispongano delle autorizzazioni necessarie per eseguire richieste di interprete del codice.
  2. Verificare le impostazioni di configurazione. Verificare che l'interprete del codice sia abilitato nelle impostazioni di richiesta e che l'agente sia configurato per l'uso dell'autenticazione utente.
  3. Per informazioni dettagliate, vedere i log degli errori. Esaminare i log degli errori in Copilot Studio o nell'ambiente Power Platform associato per identificare la causa radice del problema ed eseguire azioni correttive.
  • Last updated on