Repolode
Enviar
microsoft

microsoft/prompty

Formato de arquivo Markdown para prompts de LLM, com runtimes para Python, TypeScript, Rust, C# e outras linguagens, além de uma extensão para VS Code que executa e rastreia os prompts.

Ver no GitHubSite
Estrelas
1,286
Forks
135
Issues abertas
23
Último commit
há 5 dias

O que é?

Prompty é um formato de arquivo e uma classe de ativos para prompts de LLM. Um arquivo `.prompty` combina um frontmatter YAML, que armazena o modelo, a conexão, as entradas e as ferramentas, com um corpo em Markdown que define mensagens de system, user e assistant usando templates Jinja2 ou Mustache. O objetivo é manter os prompts portáveis e fáceis de inspecionar, permitindo mover o mesmo arquivo entre aplicações e runtimes sem alterar o texto do prompt.

O projeto oferece runtimes para Python, TypeScript, Rust, C#, Java, Go e Swift, além de pacotes de provedores para OpenAI, Microsoft Foundry e Anthropic. Uma extensão para VS Code adiciona uma barra lateral de conexões, pré-visualização em tempo real, modo de chat e um visualizador de traces que registra as etapas de renderização, parsing e chamadas ao modelo. A versão 2 também adiciona um loop de turnos agentic que executa as ferramentas solicitadas pelo modelo e retorna uma resposta final.

É possível configurar um endpoint compatível com OpenAI na configuração da conexão, permitindo direcionar o mesmo prompt a gateways ou servidores de modelos auto-hospedados, alterando apenas as variáveis de ambiente.

Recursos principais

  • 01Define prompts em arquivos `.prompty` com frontmatter YAML e blocos Markdown para cada papel.
  • 02Oferece suporte a templates Jinja2 e Mustache e a referências de variáveis `${env:VAR}`.
  • 03Disponibiliza runtimes para Python, TypeScript, Rust, C#, Java, Go e Swift.
  • 04Inclui pacotes de provedores para OpenAI, Microsoft Foundry e Anthropic.
  • 05Extensão para VS Code com pré-visualização em tempo real, modo de chat e visualizador de traces.
  • 06Loop de turnos agentic que executa as ferramentas solicitadas pelo modelo até obter uma resposta final.

Casos de uso

  • Manter prompts no controle de versão como arquivos legíveis e separados do código da aplicação.
  • Executar o mesmo prompt no VS Code durante o desenvolvimento e em um serviço Python ou TypeScript em produção.
  • Depurar a renderização dos prompts e as chamadas ao modelo usando arquivos de trace.
  • Direcionar prompts por um gateway compatível com OpenAI ou por um servidor de modelos auto-hospedado.

Início rápido

  1. 1

    Escreva um arquivo .prompty com a configuração do modelo e o corpo do prompt em Markdown

  2. 2

    Instale o pacote Python com suporte ao OpenAI

    uv pip install "prompty[jinja2,openai]"
  3. 3

    Execute o prompt pelo Python com prompty.invoke

  4. 4

    Ou instale os pacotes TypeScript com suporte ao OpenAI

    npm install @prompty/core @prompty/openai

Antes de usar

  • O Prompty v2 é mais recente, e o README pede opiniões sobre ele.
  • Para executar os exemplos, é necessária uma chave de API da OpenAI ou de outro provedor.

Em coleções

Frameworks de teste e ferramentas de automação de testesPlataformas de OpenTelemetry e observabilidade

Tópicos

#prompt-engineering#llm#generative-ai#prompt-management#observability#vs-code-extension#llm-evaluation#llms#promptengineering#prompty

Perguntas frequentes

O que é prompty?
Formato de arquivo Markdown para prompts de LLM, com runtimes para Python, TypeScript, Rust, C# e outras linguagens, além de uma extensão para VS Code que executa e rastreia os prompts. Prompty é um formato de arquivo e uma classe de ativos para prompts de LLM. Um arquivo `.prompty` combina um frontmatter YAML, que armazena o modelo, a conexão, as entradas e as ferramentas, com um corpo em Markdown que define mensagens de system, user e assistant usando templates Jinja2 ou Mustache. O objetivo é manter os prompts portáveis e fáceis de inspecionar, permitindo mover o mesmo arquivo entre aplicações e runtimes sem alterar o texto do prompt.
prompty é gratuito? Qual é a licença?
prompty é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
prompty ainda é mantido?
Manutenção ativa. O último commit de prompty foi em 2 de nov. de 2026.
Para que posso usar prompty?
Manter prompts no controle de versão como arquivos legíveis e separados do código da aplicação. Executar o mesmo prompt no VS Code durante o desenvolvimento e em um serviço Python ou TypeScript em produção. Depurar a renderização dos prompts e as chamadas ao modelo usando arquivos de trace. Direcionar prompts por um gateway compatível com OpenAI ou por um servidor de modelos auto-hospedado.
Como instalar prompty?
Escreva um arquivo .prompty com a configuração do modelo e o corpo do prompt em Markdown Instale o pacote Python com suporte ao OpenAI: uv pip install "prompty[jinja2,openai]" Execute o prompt pelo Python com prompty.invoke Ou instale os pacotes TypeScript com suporte ao OpenAI: npm install @prompty/core @prompty/openai
Onde consigo prompty?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/microsoft/prompty

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados