Użyj interpretera kodu w wierszu polecenia, aby wygenerować i wykonać kod Python

Interpreter kodu w Microsoft Copilot Studio i monitach konstruktora podpowiedzi umożliwia twórcom tworzenie agentów sztucznej inteligencji, którzy:

  • Wykonywanie kodu Python na potrzeby analizy danych, przetwarzania Word, Excel, PowerPoint i plików PDF oraz wizualizacji
  • Używanie modeli językowych do generowania odpowiedzi

Ta funkcja jest dostosowana do deweloperów, analityków biznesowych i twórców kodu o niskim poziomie. Generowanie i wykonywanie kodu bezproblemowo integruje się z ekosystemem Copilot Studio w celu tworzenia zaawansowanych rozwiązań opartych na sztucznej inteligencji.

Deweloperzy powinni przeczytać interpreter kodu dla deweloperów i zobaczyć przykład komponentu Code interpreter Power Apps Component Framework (PCF), aby zrozumieć, jak mogą korzystać z komunikatu Dataverse Predict do wywoływania monitów i przetwarzania zwróconych odpowiedzi.

Requirements

Możliwości interpretera kodu

Agenci używający interpretera kodu mogą pisać i uruchamiać kod Python na potrzeby zadań zaawansowanych. Przypadki użycia obejmują:

  • Przetwarzanie plików Excel: tworzenie, kopiowanie i aktualizowanie arkuszy kalkulacyjnych Excel w skoroszycie, odczytywanie i stosowanie stylów komórek, kopiowanie formatowania między komórkami, kopiowanie i aktualizowanie formuł między komórkami, i nie tylko.
  • Przetwarzanie plików Word i PowerPoint.
  • Przetwarzanie plików PDF: tworzenie i kopiowanie plików PDF, odczytywanie tabel i akapitów tekstowych.
  • Przetwarzanie danych tabeli Dataverse.
  • Złożone obliczenia matematyczne i statystyczne.
  • Analiza danych, manipulowanie i wizualizacja (na przykład wykresy i wykresy).

Interpreter kodu dodaje następujące możliwości, aby wyświetlić monity:

  • Obsługa plików jako typu danych wyjściowych w monitach.
  • Obsługa plików Excel jako typów danych wejściowych i wyjściowych w przypadku monitów.

Utwórz polecenia na jeden z dwóch sposobów:

  • W Power Apps: użyj opcji Utwórz własny monit w AI Hub.
  • W Copilot Studio: Dodaj monit jako narzędzie na poziomie agenta lub tematu.

Dowiedz się więcej o podpowiedziach w Przeglądzie podpowiedzi.

Można również użyć interpretera kodu w czacie agenta w Copilot Studio.

Uruchom nowy monit w usłudze Power Apps AI Hub i włącz interpreter kodu

Nowy monit można uruchomić w usłudze AI Hub w Power Apps i włączyć interpreter kodu w ustawieniach monitu.

  1. Przejdź do Power Apps.

  2. Wybierz Centrum AI w lewym panelu.

  3. Wybierz pozycję Monity.

    Zrzut ekranu przedstawiający wybieranie monitów w centrum sztucznej inteligencji.

  4. Wybierz Utwórz własny prompt.

    Zrzut ekranu przedstawiający wybór opcji

  5. Wprowadź nazwę komunikatu.

  6. W sekcji Instrukcje wybierz trzy kropki (...), a następnie wybierz pozycję Ustawienia.

    Zrzut ekranu przedstawiający sposób otwierania ustawień monitu.

  7. W obszarze Ustawienia włącz interpreter kodu.

  8. Zamknij Ustawienia, aby powrócić do edytora poleceń.

Edytor monitów jest otwarty z włączonym interpreterem kodu. Następnie napisz instrukcje dotyczące monitu.

Uruchom nowy monit jako narzędzie w agencie i włącz interpreter kodu

Możesz uruchomić nowy monit jako narzędzie w agencie w Copilot Studio i włączyć interpreter kodu dla tego monitu.

  1. W Copilot Studio przejdź do agenta, w którym chcesz użyć interpretera kodu.

  2. Dodaj nowy monit do agenta jako narzędzie na poziomie agenta lub tematu.

    • Dodaj monit na poziomie agenta:

      1. Przejdź do strony Narzędzia .

      2. Wybierz Dodaj narzędzie>Podpowiedź.

    • Dodaj monit na poziomie tematu:

      1. Przejdź do strony Tematy i wybierz temat, w którym chcesz dodać monit.

      2. Wybierz Dodaj węzeł w miejscu w temacie, gdzie chcesz dodać monit.

      3. Wybierz pozycję Dodaj narzędzie>Nowy monit.

    Interfejs do tworzenia wbudowanych monitów otwiera się.

  3. Na pasku informacji wybierz trzy kropki (...), a następnie wybierz pozycję Ustawienia.

    Zrzut ekranu przedstawiający otwieranie ustawień monitu.

  4. Na stronie Ustawienia wybierz Włącz interpreter kodu.

  5. Zamknij Ustawienia, aby powrócić do edytora poleceń.

Edytor monitów jest otwarty z włączonym interpreterem kodu. Następnie napisz instrukcje dotyczące monitu.

Napisz instrukcje dla swojego polecenia

Następnie możesz napisać instrukcje monitu, skonfigurować monit zgodnie z potrzebami i zapisać, aby utworzyć monit.

Dowiedz się więcej o sposobie używania interpretera kodu w monitach w przykładach monitów interpretera kodu.

Najlepsze rozwiązania dotyczące interpretera kodu w monitach

  • Użyj innych narzędzi sztucznej inteligencji, takich jak Copilot, aby uzyskać zoptymalizowany monit o uruchomienie.
  • Użyj precyzyjnych monitów z przykładami (monitowanie o kilka strzałów).
  • Określ dane wyjściowe (na przykład "Return as JSON" lub "Excel" lub "PDF").

Ograniczenia

  • Analizowanie wielu plików wgranych za jednym poleceniem nie jest obsługiwane.
  • Zwracanie wielu danych wyjściowych pliku w jednym wierszu polecenia nie jest obsługiwane.
  • Zadawanie pytań dotyczących przekazanego pliku podczas wielu rund nie jest obsługiwane.
  • Aby używać interpretera kodu, musisz skonfigurować agenta w ustawieniach agenta, aby korzystał z uwierzytelniania użytkownika. Na przykład użycie Direct Line z Bez uwierzytelniania nie działa w scenariuszach korzystających z interpretera kodu.

Troubleshooting

Jeśli wystąpią błędy podczas korzystania z interpretera kodu, spróbuj wykonać następujące czynności:

  1. Upewnij się, że udzielono wszystkich wymaganych uprawnień. Sprawdź, czy konto użytkownika i agent mają niezbędne uprawnienia do wykonywania monitów interpretera kodu.
  2. Zweryfikuj ustawienia konfiguracji. Upewnij się, że interpreter kodu jest włączony w ustawieniach monitu i czy agent jest skonfigurowany do korzystania z uwierzytelniania użytkownika.
  3. Szczegółowe informacje można znaleźć w dziennikach błędów. Przejrzyj dzienniki błędów w Copilot Studio lub skojarzonym środowisku platformy Power Platform, aby zidentyfikować główną przyczynę problemu i podjąć działania naprawcze.