| Инструмент | Что делает |
|---|---|
optimize_prompt | Optimize a prompt with deterministic, verified transforms (duplicates, filler, optional sections). Every candidate is checked to preserve all sentences, requirements, code, and variables; the original is kept if nothing is better. Returns the selected prompt, token savings, quality score, and what changed. |
optimize_prompt_pipeline | Run the optimization pipeline and return per-stage results plus token and estimated cost metrics, in the result shape used by the PromptFlow VS Code extension. |
compress_prompt | Remove exact duplicate sentences and extra whitespace without rewriting any wording. |
validate_prompt | Check a prompt for missing objective or output format, ambiguity, conflicting instructions, duplicates, prompt-injection patterns, secrets, and undelimited variables. isValid is false only when a critical issue exists. |
estimate_tokens | Count tokens and estimate input cost for a model. "exact" is true only for OpenAI models with a loaded tokenizer; other providers are approximate. Costs are estimates from a reference price table. |
analyze_prompt | Detect intent, task type, technical domain, requested output, requirements, and entities (languages, frameworks, file paths, identifiers). |
extract_entities | Extract languages, frameworks, libraries, cloud platforms, services, technologies, file paths, identifiers, URLs, and commands. |
summarize_context | Extractive summary: the first N unique, non-empty sentences of a context block, in order. Does not rank or rewrite. |
score_prompt | Score prompt quality 0-100: 100 minus a penalty per issue (critical 30, warning 10, info 3; capped at 50 with any critical issue), with per-dimension scores and suggestions. |
evaluate_prompt | Full quality report: overall score, grade, eight quality dimensions with the checks that failed, and every finding with why it matters and how to fix it. |
compare_prompts | Compare two prompts: token and estimated cost delta, quality delta per dimension, and which findings were resolved or introduced. |
scan_prompt_security | Prompt-injection risk (0-100, signature-based, with threat ids), sensitive-data counts by category, undelimited template variables, and destructive operations. Never returns detected secret values. |
scan_sensitive_data | Scan text for credentials, cloud secrets, and PII with local deterministic detectors. Returns offsets and per-category counts, never the sensitive values. |
sanitize_prompt | Replace detected sensitive data with placeholders such as [REDACTED_API_KEY]. Returns the sanitized text and counts, never the original values. Use before sending a prompt to an external model. |
restructure_prompt | Turn a loosely written request into a sectioned engineering prompt: Role, Objective, Context, Requirements, Constraints, Edge cases, Testing, Acceptance criteria, Expected output. Only sections with content appear. The author's clauses are kept and reordered; for software tasks, fixed engineering guidance chosen by intent and topic is added, and every line is labeled "prompt" or "engine" so additions can be reviewed. Set scaffold=false to reorganize without adding guidance. |
convert_structured_payload | Convert a JSON payload to TOON (Token-Oriented Object Notation) and say whether to use it. Returns token counts for pretty JSON, compact JSON and TOON, a round-trip check (the TOON must decode back to the same value), and the recommendation: "toon" only when it round-trips and saves at least 5 % over compact JSON, otherwise "json". Lossless or it keeps JSON. |
simulate_cost | Simulate what a prompt costs across models at a request volume, from catalog list prices (labelled simulated, never a bill). Optionally optimizes the prompt first and reports hypothetical savings. Flags models whose context window is too small. |
analyze_context_budget | Measure the context sources you intend to send with a prompt: tokens and share per source, context-window usage with an output reserve, sensitive data (categories and counts only), instruction-like text in retrieved sources, and duplicates. Reads only the text passed in; never reads files. |
run_prompt_tests | Run a regression suite against a prompt. Assertions check the prompt (contains, not_contains, matches, max_tokens, min_quality, no_finding, max_severity, has_variables, max_injection_risk, no_sensitive_data, output_format) and, when a case carries a recorded model response, the response (response_valid_json, response_has_keys, response_contains, response_max_chars). With baseline_prompt, also runs the suite on the baseline and lists cases that regressed. No model is called. |
Интеграция с агентами
MCP-сервер для анализа промптов
Подключите PromptFlowEngine к ИИ-агентам и MCP-совместимым процессам. Ваш ассистент сможет анализировать, перестраивать, оптимизировать и очищать промпт как шаг своей работы.
- Транспорт stdio
- Инструменты только для чтения
- Сборка из исходников
Что он делает
Model Context Protocol — стандартный способ, которым ИИ-приложение вызывает внешние инструменты. PromptFlowEngine поставляется с MCP-сервером, который предоставляет движок в виде инструментов, поэтому агент в GitHub Copilot, Claude Desktop, Claude Code, Cursor или вашем собственном клиенте может использовать его без отдельного кода интеграции.
Сервер работает на вашем компьютере как дочерний процесс клиента и общается по JSON-RPC через stdio. Он читает только переданные аргументы, не делает сетевых запросов и не имеет инструментов для файлов и оболочки. Каждый инструмент помечен как только для чтения и идемпотентный.
Нет ни размещённого эндпоинта, ни аутентификации для настройки. Пакет npm ещё не опубликован, поэтому сервер собирают из репозитория и указывают клиенту путь к собранному файлу. Для удалённого использования вызывайте HTTP API.
Практический пример
Инструменты, которые получает ваш агент
Этот список строится из реестра инструментов самого сервера при сборке страницы, поэтому совпадает с тем, что клиент видит после подключения. Результаты проверки и сгенерированные промпты показаны на английском — так, как их возвращают движок и API.
{
"servers": {
"promptflow": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/checkout/packages/mcp-server/dist/bin.js"]
}
}
}Use promptflow to restructure this before you start:
"fix login issue and make google login work and don't break anything"Инструментов: 19, все только для чтения. Другие клиенты используют ту же команду под ключом mcpServers.
Главные преимущества
Одна конфигурация — много клиентов
Одна и та же запись о сервере работает в любом клиенте с поддержкой MCP-серверов через stdio.
Безопасно для агента
Нет доступа к файлам, оболочке и сети, поэтому агент, получивший инъекцию в промпт, не сможет через него ничего достать.
Детерминированные результаты
Агент, дважды вызвавший инструмент с одними аргументами, получит одинаковый ответ.
Ошибки, с которыми агент справится
Неверные аргументы возвращают ошибку инструмента с причиной, чтобы агент исправил их и повторил вызов.
Возможности
Инструменты для промптов
Анализ, проверка, оптимизация, реструктуризация, сравнение, оценка токенов, сканирование и очистка.
Ресурсы
Каталог правил и каталог моделей доступны для чтения как MCP-ресурсы.
Промпт для ревью
Встроенный MCP-промпт просит ассистента оценить и оптимизировать промпт, переданный как данные.
Ограничения размера
Настраиваемый предел числа символов в одном аргументе.
Логи без содержимого
Отладочные логи фиксируют имя инструмента, размер входа, результат и длительность, но никогда не текст.
Встроен в VS Code
Расширение для VS Code само регистрирует сервер при активации.
Для кого
- Разработчикам с агентами для программированияПусть агент перестроит расплывчатую задачу в спецификацию, прежде чем начнёт править файлы.
- Тем, кто создаёт агентовДайте агенту детерминированный способ проверять и очищать промпты, которые он пишет для субагентов и других моделей.
- Командам, стандартизирующимся на MCPДобавьте проверку качества промптов и обнаружение секретов во все MCP-клиенты одной записью о сервере.
Сценарии использования
- 01
Сначала спецификация, потом код
Попросите агента сначала перестроить задачу с помощью promptflow, а затем реализовать её по критериям приёмки.
- 02
Очистка перед делегированием
Пусть агент-оркестратор очищает контекст, прежде чем передать его другой модели или инструменту.
- 03
Проверка сгенерированных промптов
Когда агент пишет промпт для подзадачи, проверьте его и автоматически исправьте критические находки.
- 04
Бюджет токенов
Пусть агент оценит количество токенов в черновике, прежде чем решать, сколько контекста включить.
Частые вопросы
Что такое MCP-сервер?
MCP-сервер — это программа, которая предоставляет ИИ-приложению инструменты, ресурсы и промпты по протоколу Model Context Protocol. ИИ-приложение, называемое клиентом, решает, когда их вызывать.
С какими MCP-клиентами он работает?
С любым клиентом, который может запустить локальный stdio-сервер, включая режим агента GitHub Copilot в VS Code, Claude Desktop, Claude Code и Cursor.
Есть ли размещённый или удалённый MCP-эндпоинт?
Нет. Транспорт — только stdio, сервер работает на вашем компьютере. Для удалённого доступа используйте HTTP API.
Может ли сервер читать мои файлы?
Нет. У него нет инструментов для файлов, оболочки и сети. Он обрабатывает только текст, переданный инструменту в качестве аргумента.
Другие возможности PromptFlowEngine
Все продукты работают на одном движке, поэтому сочетаются без сюрпризов.
- ИнтеграцияHTTP APIВстраивайте анализ и оптимизацию промптов прямо в свои приложения.
- ИнтеграцияРасширение для VS CodeОптимизация промптов PromptFlowEngine прямо в вашем процессе разработки.
- ИнструментБезопасность промптовОбнаруживает фразы-инъекции, утёкшие секреты и персональные данные и маскирует их.
- ДокументацияДокументация MCP-клиентаСправка и настройка.
- ДокументацияРасширение для VS CodeСправка и настройка.
Техника, лежащая в основе
Руководства из базы знаний по промпт-инжинирингу, объясняющие идеи, которые применяет этот продукт.
- РуководствоЧто такое MCP? Model Context Protocol простыми словамиКак MCP подключает ИИ-приложения к инструментам и данным, его строительные блоки и модель безопасности.
- РуководствоПромпты для ИИ-агентов: инструкции, инструменты и рабочие процессыИнструкции агента, описания инструментов, управление контекстом и когда рабочий процесс лучше агента.
- РуководствоReAct-промптинг: рассуждение и действие с инструментамиКак работает цикл «рассуждение — действие — наблюдение», с примером промпта и типичными сбоями.
Один движок — везде, где вы работаете с ИИ.
Бесплатно, детерминированно и приватно. Без регистрации.