Condividi tramite

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

L'interprete di codice e il creatore di prompt in Microsoft Copilot Studio 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 per le 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.

Gli sviluppatori devono leggere il documento Interprete del codice per sviluppatori ed esaminare l'esempio di componente del Power Apps Component Framework (PCF) per comprendere come possono utilizzare il messaggio Dataverse Predict per attivare richieste ed elaborare le risposte restituite.

Requisiti

Funzionalità dell'interprete del codice

Gli agenti che usano l'interprete di codice possono scrivere ed eseguire Python codice per le attività avanzate. I casi d'uso includono:

  • Elaborazione di file Excel: creare, copiare e aggiornare i fogli di lavoro in una cartella di lavoro, leggere e applicare stili di cella, copiare la formattazione tra le celle, copiare e aggiornare le formule tra le celle e altro ancora.
  • L'elaborazione dei 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 tipologie di input e output per le richieste.

Creare richieste in uno dei due modi seguenti:

  • In Power Apps: usare l'opzione Crea il tuo prompt personalizzato nell'AI Hub.
  • In Copilot Studio: aggiungere un prompt come strumento a livello di agente o argomento.

Altre informazioni sulle richieste sono disponibili in Panoramica dei prompt.

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

Avviare una nuova richiesta in Power Apps hub di intelligenza artificiale e attivare l'interprete del codice

È possibile avviare una nuova richiesta nell'hub di intelligenza artificiale in Power Apps e attivare l'interprete del codice nelle impostazioni del prompt.

  1. Passare a Power Apps.

  2. Selezionare Hub di intelligenza artificiale nel riquadro sinistro.

  3. Selezionare Prompts.

    Screenshot della selezione dei prompt nell'Hub IA.

  4. Seleziona Crea la tua richiesta.

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

  5. Immettere un nome per il prompt.

  6. Nella sezione Istruzioni selezionare i tre puntini (...) e quindi selezionare Impostazioni.

    Screenshot che mostra come aprire le impostazioni dei prompt.

  7. In Impostazioni attivare l'interprete del codice.

  8. Chiudi Impostazioni per tornare all'editor dei prompt.

L'editor del prompt è aperto con l'interprete del codice attivato. Successivamente, scrivere le istruzioni per il prompt.

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

È possibile avviare un nuovo prompt come strumento all'interno di un agente in Copilot Studio e attivare l'interprete del codice per tale richiesta.

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

  2. Aggiungi un nuovo prompt all'agente come strumento, sia a livello di agente che di argomento.

    • Aggiungere un prompt a livello di agente:

      1. Passare alla pagina Strumenti .

      2. Selezionare Aggiungi uno strumento>Prompt.

    • Aggiungere un prompt a livello di tema:

      1. Passare alla pagina Argomenti e selezionare l'argomento in cui si vuole aggiungere il prompt.

      2. Selezionare Aggiungi nodo nella posizione nell'argomento in cui si vuole aggiungere il prompt.

      3. Seleziona Aggiungi uno strumento>Nuovo prompt.

    Viene visualizzata l'interfaccia di creazione incorporata del prompt.

  3. Nella barra delle informazioni selezionare i tre puntini (...) e quindi selezionare Impostazioni.

    Screenshot delle impostazioni del prompt di apertura.

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

  5. Chiudi Impostazioni per tornare all'editor dei prompt.

L'editor del prompt è aperto con l'interprete del codice attivato. Scrivere quindi le istruzioni per il prompt.

Scrivere istruzioni per il tuo prompt

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

Scopri come utilizzare l'interprete di codice nei prompt negli esempi di prompt dell'interprete di 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 "Return as 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, l'uso di Direct Line con Nessuna autenticazione selezionata non funziona per gli scenari che usano l'interprete del 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