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

Note

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

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

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

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

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

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

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

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

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

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

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

Note

Для поиска по содержимому файла Excel используйте интерпретатор кода вместо семантического поиска. Семантический поиск имеет ограничения для индексации ячеек.

Создайте запросы одним из двух способов:

  • В Power Apps: используйте вариант создать свой собственный запрос в Центре ИИ.
  • В Copilot Studio: добавьте запрос в качестве инструмента на уровне агента или темы.

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

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

Начните новый запрос в Центре ИИ Power Apps и включите интерпретатор кода

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

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

  2. В левой области выберите Центр ИИ.

  3. Выберите Запросы.

    Снимок экрана выбора запросов в Центре ИИ.

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

    Снимок экрана, демонстрирующий выбор пункта «Создать собственный запрос» в Центре ИИ.

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

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

    Снимок экрана, демонстрирующий открытие настроек запроса.

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

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

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

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

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

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

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

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

      1. Вернитесь на страницу Инструменты.

      2. Выберите Добавить инструмент>Запрос.

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

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

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

      3. Выберите Добавить инструмент>Новый запрос.

    Открывается интерфейс создания запросов встроенного конструктора запросов.

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

    Снимок экрана, демонстрирующий открытие настроек запроса.

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

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

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

Напишите инструкции для вашего запроса

Далее напишите инструкции к запросу, настройте запрос по необходимости и сохраните для создания запроса.

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

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

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

Ограничения

Note

Агент может не читать текст в документах Word, который появляется только в текстовых полях, фигурах, WordArt, SmartArt, заголовках или основаниях, а также в встроенных или связанных объектах. Узнайте подробности и советы в разделе «Как агент читает загруженные документы».

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

Troubleshooting

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

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