Freigeben über


Verwenden des Codedolmetschers in einer Eingabeaufforderung zum Generieren und Ausführen von Python Code

Code-Interpreter in Microsoft Copilot Studio und Eingabeaufforderungen des Prompt-Generators ermöglichen es Nutzern, KI-Agents zu erstellen, die:

  • Ausführen von Python Code für Datenanalyse, Verarbeitung Word, Excel, PowerPoint und PDF-Dateien und Visualisierungen
  • Verwenden von Sprachmodellen für generative Antworten

Diese Funktion ist für Entwickler, Geschäftsanalysten und Entwickler mit geringem Code zugeschnitten. Die Codegenerierung und -ausführung lässt sich nahtlos in das Copilot Studio Ökosystem integrieren, um leistungsstarke, KI-gesteuerte Lösungen zu schaffen.

Entwickler sollten Code-Interpreter für Entwickler lesen und den Code-Interpreter Power Apps Component Framework (PCF)-Komponentenbeispiel lesen um zu verstehen, wie sie die Dataverse Predict-Nachricht verwenden können, um Eingabeaufforderungen aufzurufen und die zurückgegebenen Antworten zu verarbeiten.

Anforderungen

Funktionen des Codedolmetschers

Agents, die Codedolmetscher verwenden, können Python Code für erweiterte Aufgaben schreiben und ausführen. Anwendungsfälle umfassen:

  • Excel Dateiverarbeitung: Erstellen, Kopieren und Aktualisieren Excel Arbeitsblätter in einer Arbeitsmappe, Lesen und Anwenden von Zellformatvorlagen, Kopieren von Formatierungen über Zellen, Kopieren und Aktualisieren von Formeln über Zellen hinweg und vieles mehr.
  • Word und PowerPoint Dateiverarbeitung.
  • PDF-Dateiverarbeitung: Erstellen und Kopieren von PDF-Dateien, Lesen von Tabellen und Textabsätzen.
  • Dataverse Tabellendatenverarbeitung.
  • Komplexe mathematische und statistische Berechnungen.
  • Datenanalyse, Manipulation und Visualisierung (z. B. Diagramme und Grafiken).

Code-Interpreter fügt die folgenden Funktionen zu Eingabeaufforderungen hinzu:

  • Unterstützung für Dateien als Ausgabetyp in Eingabeaufforderungen.
  • Unterstützung für Excel Dateien als Eingabe- und Ausgabetypen für Eingabeaufforderungen.

Erstellen von Prompts auf zwei Arten:

  • In Power Apps: Verwenden Sie die Option Erstellen Sie Ihre eigene Eingabeaufforderung im AI Hub.
  • In Copilot Studio: Fügen Sie eine Eingabeaufforderung als Tool auf Agent- oder Themenebene hinzu.

Weitere Informationen zu Aufforderungen finden Sie in der Übersicht über Aufforderungen.

Sie können auch Codedolmetscher im Agent-Chat in Copilot Studio verwenden.

Starten Sie eine neue Eingabeaufforderung in Power Apps AI Hub, und aktivieren Sie Codedolmetscher

Sie können in Power Apps eine neue Eingabeaufforderung im AI Hub starten und den Codedolmetscher in den Eingabeaufforderungseinstellungen aktivieren.

  1. Wechseln Sie zu Power Apps.

  2. Wählen Sie im linken Bereich KI-Hub aus.

  3. Wählen Sie Eingabeaufforderungen aus.

    Screenshot der Auswahl von Eingabeaufforderungen im KI-Hub.

  4. Wählen Sie Eigene Eingabeaufforderung erstellen.

    Screenshot der Auswahl der Erstellung eines eigenen Prompts im KI-Hub

  5. Geben Sie einen Namen für Ihre Aufforderung ein.

  6. Wählen Sie im Abschnitt "Anweisungen " die drei Punkte (...) und dann "Einstellungen" aus.

    Screenshot, wie man die Einstellungen für Eingabeaufforderungen öffnet.

  7. Aktivieren Sie unter "Einstellungen" den Codedolmetscher.

  8. Schließen Sie "Einstellungen ", um zum Eingabeaufforderungs-Editor zurückzukehren.

Der Eingabeaufforderungs-Editor ist geöffnet, wenn der Codedolmetscher aktiviert ist. Schreiben Sie als Nächstes Anweisungen für Ihre Eingabeaufforderung.

Starten einer neuen Eingabeaufforderung als Tool innerhalb eines Agenten und Aktivieren des Codedolmetschers

Sie können eine neue Eingabeaufforderung als Tool innerhalb eines Agents in Copilot Studio starten und den Codedolmetscher für diese Aufforderung aktivieren.

  1. Wechseln Sie in Copilot Studio zum Agent, in dem Sie Codedolmetscher verwenden möchten.

  2. Fügen Sie dem Agent eine neue Eingabeaufforderung als Tool hinzu, entweder auf Agentebene oder auf Themenebene.

    • Fügen Sie eine Eingabeaufforderung auf Agentebene hinzu:

      1. Wechseln Sie zur Seite Extras.

      2. Wählen Sie Ein Werkzeug hinzufügen>Aufforderung aus.

    • Fügen Sie eine Eingabeaufforderung auf Themenebene hinzu:

      1. Wechseln Sie zur Seite "Themen ", und wählen Sie das Thema aus, in dem Sie die Eingabeaufforderung hinzufügen möchten.

      2. Wählen Sie " Knoten hinzufügen" in der Position im Thema aus, an der Sie die Eingabeaufforderung hinzufügen möchten.

      3. Wählen Sie Ein Werkzeug hinzufügen>Neue Eingabeaufforderung aus.

    Die Benutzeroberfläche des eingebetteten Prompt-Generators öffnet sich.

  3. Wählen Sie auf der Informationsleiste die drei Punkte (...) und dann "Einstellungen" aus.

    Screenshot des Öffnens der Prompt-Einstellungen.

  4. Auf der Seite Einstellungen wählen Sie Code-Interpreter aktivieren aus.

  5. Schließen Sie "Einstellungen ", um zum Eingabeaufforderungs-Editor zurückzukehren.

Der Eingabeaufforderungs-Editor ist geöffnet, wenn der Codedolmetscher aktiviert ist. Schreiben Sie als Nächstes Anweisungen für Ihre Eingabeaufforderung.

Schreiben von Anweisungen für Ihre Eingabeaufforderung

Als Nächstes können Sie die Eingabeaufforderungsanweisungen schreiben, die Eingabeaufforderung nach Bedarf konfigurieren und speichern, um die Eingabeaufforderung zu erstellen.

Erfahren Sie mehr darüber, wie Sie den Code-Interpreter in Beispielen für Eingabeaufforderungen verwenden.

Bewährte Methoden für Code-Interpreter in Prompts

  • Verwenden Sie andere KI-Tools wie Copilot, um die optimierte Eingabeaufforderung für den Start zu erhalten.
  • Verwenden Sie präzise Eingabeaufforderungen mit Beispielen (ein paar Eingabeaufforderungen).
  • Geben Sie Ausgaben an (z. B. "Als JSON zurückgeben" oder "Excel" oder "PDF").

Einschränkungen

  • Das Analysieren mehrerer Dateien, die in einer einzigen Eingabeaufforderung hochgeladen wurden, wird nicht unterstützt.
  • Das Zurückgeben mehrerer Dateiausgaben in einer einzigen Eingabeaufforderung wird nicht unterstützt.
  • Das Stellen von Fragen zu einer hochgeladenen Datei über mehrere Gesprächsrunden wird nicht unterstützt.
  • Um Code Interpreter zu verwenden, musst du deinen Agenten in den Agenteneinstellungen so konfigurieren, dass er Benutzerauthentifizierung verwendet. Beispielsweise funktioniert die Verwendung von Direct Line mit Keine Authentifizierung für Szenarien mit Code Interpreter nicht.

Problembehandlung

Wenn beim Verwenden des Codedolmetschers Fehler auftreten, führen Sie die folgenden Schritte aus:

  1. Stellen Sie sicher, dass alle erforderlichen Berechtigungen erteilt werden. Stellen Sie sicher, dass das Benutzerkonto und der Agent über die erforderlichen Berechtigungen zum Ausführen von Codedolmetscheraufforderungen verfügen.
  2. Überprüfen Sie die Konfigurationseinstellungen. Vergewissern Sie sich, dass der Codedolmetscher in den Eingabeaufforderungseinstellungen aktiviert ist und dass Ihr Agent für die Verwendung der Benutzerauthentifizierung konfiguriert ist.
  3. Weitere Informationen finden Sie in den Fehlerprotokollen. Überprüfen Sie die Fehlerprotokolle in Copilot Studio oder der zugehörigen Power Platform-Umgebung, um die Ursache des Problems zu identifizieren und Korrekturmaßnahmen zu ergreifen.