Produto

Extensão do VS Code

Versão 2.7.0. O PromptFlowEngine para VS Code gira em torno de um fluxo de trabalho: Código → Prompt → IA → Código. Ele roda o motor no próprio processo: sem servidor, sem Python e sem chamadas próprias a modelos.

Disponível no Visual Studio Marketplace como promptflow-ai.ide-extension. Esta página descreve a versão do repositório; o Marketplace pode trazer a versão anterior até a próxima ser publicada. A extensão em si está em inglês.

O fluxo de trabalho

Codebase → Prompt → AI → Codebase

CODEBASE   pick a scope: workspace, current file, chosen files, or none
   ↓       only files relevant to the task are read
PROMPT     describe the change in your own words
   ↓       the engine structures it and grounds it in the code
AI         send to VS Code Chat, copy, or save
   ↓       secrets and personal data are checked first
CODEBASE   review the changes in Source Control,
           or build a review prompt from the modified files

Abra o ícone do PromptFlowEngine na Barra de Atividades. O painel percorre as quatro etapas em ordem.

1. Código

Escolha Entire workspace, Current file, Choose files or folder ou No code. Os arquivos são filtrados (sem node_modules, saída de build nem binários), pontuados pela relevância para a tarefa e limitados, de modo que o prompt leva o punhado de arquivos que importam em vez do repositório.

2. Prompt

Digite a tarefa do jeito que você falaria. Generate prompt produz um prompt de engenharia em seções: papel, objetivo, contexto do projeto, o código relevante, requisitos, restrições, casos-limite, testes, critérios de aceite e saída esperada. As seções só aparecem quando a tarefa precisa delas: um pedido de “explique isto” não recebe plano de testes. O painel mostra quantas linhas vieram da sua tarefa, do código e das orientações acrescentadas, e o prompt continua editável. É a mesma reestruturação que a ferramenta MCP e a API HTTP oferecem.

3. IA

Send to AI Chat abre o prompt no VS Code Chat (ou o copia quando isso não está disponível). Antes de qualquer coisa sair, a proteção de privacidade procura credenciais e dados pessoais. Modos: strict (bloquear), redact (padrão, substituir por marcadores), warn (perguntar). Reduce tokens remove enchimento e repetições com edições verificadas que preservam o significado.

4. Código

Quando a IA edita seus arquivos, Review changes abre o Controle do Código-Fonte para você manter ou descartar cada mudança. Build review prompt lê os arquivos com mudanças não confirmadas e gera um prompt de revisão que os confere com a tarefa original. Ele exige a extensão Git integrada e apenas lê: nunca prepara, confirma nem reverte nada.

Comandos

PromptFlowEngine: Codebase → Prompt
PromptFlowEngine: Codebase → Prompt from Selection
PromptFlowEngine: Open PromptOps Workspace
PromptFlowEngine: Optimize Prompt
PromptFlowEngine: Restructure Prompt
PromptFlowEngine: Analyze Prompt
PromptFlowEngine: Compare Original vs Restructured
PromptFlowEngine: Send Prompt to AI Chat
PromptFlowEngine: Prompt → Codebase (Review Changes)
PromptFlowEngine: Insert Prompt Template
PromptFlowEngine: Select Model for Tokens and Cost
PromptFlowEngine: Connect to Organization
PromptFlowEngine: Organization Status
PromptFlowEngine: Install Agent Hooks (Claude Code, Cursor, Windsurf, Copilot, Gemini CLI)
PromptFlowEngine: Remove Agent Hooks
PromptFlowEngine: Turn On Activity History
PromptFlowEngine: Pause or Resume Activity History
PromptFlowEngine: Turn Off Activity History
PromptFlowEngine: Show Activity History
PromptFlowEngine: Turn Prompt Text in History On or Off
PromptFlowEngine: Set Activity History Retention
PromptFlowEngine: Export Activity History
PromptFlowEngine: Delete Activity History
PromptFlowEngine: Sign In
PromptFlowEngine: Sign Out
PromptFlowEngine: Account and Activity Status
PromptFlowEngine: Show Protection Dashboard
PromptFlowEngine: Scan Selection for Sensitive Data
PromptFlowEngine: Redact Sensitive Data in Selection
PromptFlowEngine: Protection Status
PromptFlowEngine: Reset Protection Metrics

Restructure Prompt funciona na seleção ou no documento inteiro, abre um diff do original com o reestruturado e oferece substituir o texto, enviá-lo ao chat ou copiá-lo. Analyze Prompt lista no canal de saída do PromptFlowEngine a pontuação de qualidade, a contagem de tokens, o custo de entrada estimado e cada problema com seu motivo e correção. Insert Prompt Template insere no cursor um dos modelos ou prompts da biblioteca. Select Model for Tokens and Cost escolhe qualquer modelo do catálogo de modelos. A barra de status mostra os tokens e a pontuação de qualidade do último prompt.

Restructure, Analyze, Insert Prompt Template e Send também estão no menu de contexto do editor, em PromptFlowEngine, e todo comando tem um atalho de teclado sob Ctrl+Alt+P (Cmd+Alt+P no macOS):

Ctrl+Alt+P O: Optimize Prompt
Ctrl+Alt+P W: Open PromptOps Workspace
Ctrl+Alt+P R: Restructure Prompt
Ctrl+Alt+P A: Analyze Prompt
Ctrl+Alt+P T: Insert Prompt Template
Ctrl+Alt+P S: Send Prompt to AI Chat
Ctrl+Alt+P M: Select Model for Tokens and Cost
Ctrl+Alt+P P: Codebase → Prompt

Instalação

No VS Code, abra a visão de Extensões e procure por PromptFlowEngine, ou execute:

shell

code --install-extension promptflow-ai.ide-extension

Para compilar exatamente esta versão a partir do código-fonte:

shell

# from the root of your PromptFlowEngine checkout
corepack enable && pnpm install
pnpm --filter ide-extension build
cd apps/vscode-extension && pnpm exec vsce package --no-dependencies
code --install-extension ide-extension-2.7.0.vsix

Modo agente do Copilot

Na ativação, a extensão registra seu servidor MCP incluído em .vscode/mcp.json (exige node no PATH), para que os agentes chamem diretamente as mesmas ferramentas. Veja o cliente MCP.

Configurações

Configuração	Padrão	Finalidade
`promptflow.mcpServerCommand`	`"node"`	Advanced: overrides the command used to launch the external MCP server registered for GitHub Copilot Agent mode (.vscode/mcp.json). The panel and PromptFlowEngine commands don't use this; they run in-process. Leave unset to use the bundled server.
`promptflow.mcpServerArgs`	`[]`	Advanced: arguments for promptflow.mcpServerCommand. Leave unset to use the bundled server.
`promptflow.model`	`""`	Model used for token counts and cost estimates, as a model id from the catalog (for example gpt-4.1 or claude-sonnet-5-5). Leave empty to use promptflow.defaultProvider.
`promptflow.defaultProvider`	`"gpt"`	Model family used for token counts when promptflow.model is empty. Kept for existing configurations.
`promptflow.codebaseMaxFiles`	`2000`	Maximum number of files scanned per Codebase → Prompt run, before relevance filtering.
`promptflow.codebaseMaxRelevantFiles`	`12`	Maximum number of files included as relevant context in a generated prompt.
`promptflow.privacy.enabled`	`true`	Scan prompts for sensitive data (credentials, PII, cloud secrets) before they're sent to AI Chat or copied for that purpose.
`promptflow.privacy.mode`	`"redact"`	How PromptFlowEngine reacts when sensitive data is detected in an outbound prompt. When this editor is connected to an organization, its policy applies instead.
`promptflow.privacy.exclusions`	`[]`	Exact substrings that should never be treated as sensitive (e.g. a shared team email alias).
`promptflow.privacy.customPatterns`	`[]`	Additional organization-specific sensitive-data patterns, detected alongside the built-in ones.
`promptflow.exposure.enabled`	`true`	Warn when an open file contains credentials that an AI assistant could attach as context. Detection is on this device; values are never shown or sent.
`promptflow.enterprise.enrollmentKey`	`""`	Set by IT: an enrollment key from the PromptFlowEngine admin console (pfe_…). Connects this editor to the organization on start.
`promptflow.enterprise.server`	`""`	Set by IT: the PromptFlowEngine server origin. Defaults to https://promptflowengine.com.
`promptflow.enterprise.userEmail`	`""`	Set by IT (optional): the user’s work email, so their devices count as one seat. Only a keyed hash is stored.
`promptflow.account.server`	`"https://promptflowengine.com"`
`promptflow.diagnostics.errorReports`	`false`
`promptflow.dashboard.metrics`	`true`	Keep daily counts (prompts scanned, categories found, warned/redacted/blocked/handed off) for the Protection Dashboard. Counts only, on this machine, for 90 days; no prompt text or values. Turn off to stop counting; "Reset Protection Metrics" deletes what was kept.

As chaves de configuração mantêm o prefixo promptflow. das versões anteriores, então a configuração existente é preservada.

Novidades da 2.2

O catálogo de modelos completo substitui as quatro famílias de modelos, com o preço de tabela de cada modelo, a data em que foi verificado e se a contagem de tokens é exata.
Novos comandos: Insert Prompt Template e Select Model for Tokens and Cost. Nova configuração: promptflow.model.
O Analyze Prompt agora informa qualidade, tokens, custo e a correção de cada problema.
Um menu de contexto no editor e atalhos de teclado.
Corrigido: um modelo sem preço de referência não recebe mais o custo de outro modelo; a entrada do Copilot em .vscode/mcp.json é reparada após uma atualização; um mcp.json com comentários nunca é sobrescrito.

Novidades da 2.1

Renomeada para PromptFlowEngine em todo lugar: nome de exibição, Barra de Atividades, comandos, mensagens e canal de saída.
A visão Optimize separada e o comando Optimize Prompt foram removidos. A redução de tokens agora é uma ação dentro do painel de fluxo de trabalho.
Novos: Restructure Prompt, o escopo “No code”, a etapa de revisão e um prompt gerado editável.
Os prompts gerados vêm do motor compartilhado, com seções escolhidas por tarefa em vez de um template fixo.
O painel agora roda sob uma Content Security Policy rigorosa.