Используйте интерпретатор кода в запросе для генерации и выполнения кода на Python

Интерпретатор кода в Microsoft Copilot Studio и подсказки для сборщика подсказок позволяют создателям создавать агенты ИИ, которые:

  • Выполняйте код на Python для анализа данных, обработки файлов Word, Excel, PowerPoint и PDF, а также визуализаций
  • Используйте языковые модели для генеративных ответов

Эта функция адаптирована для разработчиков, бизнес-аналитиков и разработчиков low-code. Генерация и исполнение кода бесшовно интегрируются с экосистемой Copilot Studio, создавая мощные решения, основанные на ИИ.

Разработчикам следует прочитать Code interpreter for developers и изучить Code interpreter Power Apps Component Framework (PCF) образец компонентов чтобы понять, как они могут использовать сообщение Dataverse Predict для вызова запросов и обработки возвращаемых ответов.

Необходимые условия

Возможности интерпретатора кода

Агенты, использующие интерпретатор кода, могут писать и запускать код на Python для сложных задач. К вариантам использования относятся:

  • Обработка файлов Excel: Создавайте, копируйте и обновляйте рабочие листы Excel в рабочей тетради, читайте и применяйте стили ячеек, копируйте форматирование между ячейками, копируйте и обновляйте формулы между ячейками и многое другое.
  • Обработка файлов Word и PowerPoint.
  • Обработка PDF-файлов: создание и копирование PDF-файлов, чтение таблиц и текстовых абзацев.
  • Обработка данных таблиц Dataverse.
  • Сложные математические и статистические вычисления.
  • Анализ, обработка и визуализация данных (например, диаграммы и графики).

Интерпретатор кода добавляет следующие возможности к запросам:

  • Поддержка файлов как выходного типа в подсказках.
  • Поддержка файлов Excel как типов входа и вывода для подсказок.

Создавайте подсказки двумя способами:

  • В Power Apps: Используйте опцию Build your own prompt в AI Hub.
  • В Copilot Studio: Добавьте подсказку как инструмент на уровне агента или темы.

Узнайте больше о подсказках в обзоре подсказок.

Также можно использовать интерпретатор кода в чате агентов в Copilot Studio.

Запустите новый запрос в Power Apps AI Hub и включите интерпретатор кода

Вы можете запустить новый запрос в AI Hub в Power Apps и включить интерпретатор кода в настройках запросов.

  1. Перейдите к Power Apps.

  2. Выберите AI hub в левой панели.

  3. Выберите «Подсказки».

    Скриншот выбора подсказок в AI hub.

  4. Выберите Создание собственного запроса.

    Скриншот выбора «создать собственный запрос» в AI hub.

  5. Введите имя для вашего запроса.

  6. В разделе «Инструкции » выберите три точки (...), а затем выберите «Настройки».

    Скриншот того, как открыть настройки подсказок.

  7. В настройках включите интерпретатор кода.

  8. Закройте настройки , чтобы вернуться в редактор подсказок.

Редактор заданий открыт с включённым интерпретатором кода. Далее напишите инструкции к вашему заданию.

Запустите новый запрос как инструмент внутри агента и включите интерпретатор кода

Вы можете запустить новый запрос как инструмент внутри агента в Copilot Studio и включить интерпретатор кода для этого запроса.

  1. В Copilot Studio перейдите к агенту, где хотите использовать интерпретатор кода.

  2. Добавьте новый запрос в агента как инструмент, либо на уровне агента, либо на уровне темы.

    • Добавьте подсказку на уровне агента:

      1. Перейдите на страницу «Инструменты ».

      2. Выберите «Добавить подсказку инструмента>».

    • Добавьте подсказку на уровне темы:

      1. Перейдите на страницу «Темы » и выберите тему, куда хотите добавить запрос.

      2. Выберите добавить узел в позиции в теме, куда хотите добавить запрос.

      3. Выберите «Добавить инструмент>: Новое задание».

    Открывается интерфейс создания встроенных подсказок для сборщика подсказок.

  3. На панели информации выберите три точки (...), а затем выберите Настройки.

    Скриншот настроек открытия подсказок.

  4. На странице «Настройки » выберите «Включить интерпретатор кода».

  5. Закройте настройки , чтобы вернуться в редактор подсказок.

Редактор заданий открыт с включённым интерпретатором кода. Далее напишите инструкции к вашему заданию.

Напишите инструкции к вашему заданию

Далее вы можете написать инструкции для подсказки, настроить запрос по необходимости и сохранить для создания запроса.

Узнайте больше о том, как использовать интерпретатор кода в подсказках в примерах запросов интерпретатора кода.

Лучшие практики для интерпретатора кода в подсказках

  • Используйте другие инструменты ИИ, например Copilot, чтобы получить оптимизированный запрос для запуска.
  • Используйте точные подсказки с примерами (подсказка с несколькими выстрелами).
  • Указывайте выходы (например, «Return as JSON» или «Excel» или «PDF»).

Ограничения

  • Анализ нескольких файлов, загруженных в одном запросе, не поддерживается.
  • Возврат нескольких выводов файлов в одном запросе не поддерживается.
  • Задавать вопросы о загруженном файле на протяжении нескольких ходов не поддерживается.
  • Чтобы использовать интерпретатор кода, нужно настроить агента в настройках агента для использования аутентификации пользователя. Например, использование Direct Line с выбранным без аутентификации не работает для сценариев с интерпретатором кода.

Troubleshooting

Если при использовании интерпретатора кода возникают ошибки, выполните следующие шаги:

  1. Убедитесь, что все необходимые разрешения предоставлены. Убедитесь, что учетная запись пользователя и агент имеют необходимые права для выполнения запросов интерпретатора кода.
  2. Проверьте параметры конфигурации. Убедитесь, что интерпретатор кода включён в настройках запросов и что ваш агент настроен на использование аутентификации пользователя.
  3. Обратитесь к журналам ошибок для получения подробной информации. Проверьте журналы ошибок в Copilot Studio или соответствующей среде Power Platform, чтобы выявить коренную причину проблемы и принять меры по устранению.
  • Last updated on