Документация

Документация PromptFlowEngine

PromptFlowEngine — это один детерминированный движок на TypeScript (@promptflow/engine), который разбирает, анализирует, реструктурирует, оптимизирует, проверяет и оценивает промпты. Веб-рабочее пространство, расширения для Chrome и VS Code, сервер MCP, HTTP API и CLI — это интерфейсы к одному и тому же движку, поэтому промпт везде получает один и тот же результат. Впервые здесь? Начните с быстрого старта.

Обучение

Основные понятия

Интеграции

Безопасность

Руководства по темам

Руководства по промпт-инжинирингу объясняют приёмы, которые проверяют правила движка. Каждая тема ниже открывает свой раздел указателя руководств.

  • Основы (5): Что такое промпт-инжиниринг, как заниматься им шаг за шагом и какие привычки отличают промпт, который сработал один раз, от промпта, который работает всегда.
  • Типы промптов (4): Базовые формы промпта: с примерами и без, с ролью, в виде системного промпта и вокруг обязательного формата вывода.
  • Техники (5): Методы для сложных задач: пошаговые рассуждения, разделение работы на несколько промптов, инструменты для модели и улучшение промпта по измерениям.
  • Оптимизация, тестирование и безопасность (6): Промпты в продакшене: бюджеты токенов и контекста, оценка, версионирование, защита от инъекций и как не допускать секретов в промптах.
  • ИИ-агенты и MCP (3): Промпты, которые управляют инструментами, а не дают один ответ: инструкции для агентов, поиск информации и Model Context Protocol.
  • Руководства по моделям (3): Что меняется от провайдера к провайдеру: как модели OpenAI, Anthropic и Google по-разному воспринимают инструкции, контекст и форматы.

Библиотека промптов и шаблоны

В библиотеке промптов собраны узкоспециализированные промпты, которые можно копировать и адаптировать. Хорошая отправная точка — категории для разработчиков:

  • Промпты: Разработка ПО: Промпты для планирования изменений, ревью кода, написания тестов и отладки, построенные так, чтобы ассистент возвращал работу, которую можно проверить.
  • Промпты: ИИ-инжиниринг: Промпты для разработки на моделях: проектирование оценок, написание определений инструментов и планирование конвейеров поиска.
  • Промпты: Промпт-инжиниринг: Промпты о промптах: критика черновика, создание тестовых случаев и преобразование запроса в структурированный системный промпт.
  • Промпты: DevOps: Промпты для доставки и эксплуатации: ревью пайплайнов, написание ранбуков и усиление образов контейнеров.
  • Промпты: Исследования: Промпты для чтения и сравнения источников: резюме статей, отделяющие результаты от утверждений, и сравнительные таблицы литературы.
  • Промпты: Продуктивность: Промпты для повседневной работы: превращение заметок в план, расстановка приоритетов в списке задач и составление понятных ответов на письма.

Шаблоны промптов — более длинные заготовки для повторного использования, где {{variables}} обозначают меняющиеся части: ревью pull request, ответ службы поддержки клиенту, извлечение структурированных данных, резюме встречи, классификация обращений и системный промпт агента с инструментами.

Основной рабочий процесс

Кодовая база → промпт → ИИ → кодовая база. Начните с имеющегося кода, превратите черновой запрос в структурированный инженерный промпт, привязанный к этому коду, отправьте его модели, которой вы уже пользуетесь, а затем сверьте полученное с задачей. Расширение для VS Code проходит весь цикл; остальные продукты закрывают шаг с промптом там, где вы работаете.

Продукты

Эти страницы — справочник. Обзор каждого продукта см. в разделе AI-инструменты для промптов: анализатор промптов, оптимизатор промптов, сканер безопасности промптов, тестирование промптов и оценка промптов.

Чего он не делает

  • Он не вызывает языковую модель. Каждый результат получен по задокументированным правилам, поэтому он бесплатный, мгновенный, приватный и воспроизводимый.
  • Он не выдумывает недостающее содержимое. Пробелы вроде неуказанного формата вывода становятся рекомендациями для вас.
  • Он не запускает ваш промпт на модели. Тестирование на моделях — в планах.