Tokiadocs
⌘K

Prompts library

Salve seus prompts reutilizáveis com variáveis {{var}}, versionamento append-only e playground integrado. Cobra do seu saldo BRL na execução.

Por que usar Prompts library

  • Stop copy-paste: seus prompts ficam num lugar, versionados. Edição muda body → cria nova versão automaticamente.
  • Playground integrado: teste rapidamente sem configurar SDK ou curl. Dá pra trocar modelo on-the-fly.
  • Histórico de custo: cada run aparece com modelo, tokens e custo BRL. Vê padrão de gastos por prompt.
  • Compartilhar com time: exporta como curl, Python ou JSON. Copy → cola no time.

Como usar (5 passos)

  1. Crie em /dashboard/prompts/new. Dê nome, body com placeholders, tags.
  2. Use {{nome_da_var}} no body. Sistema detecta automaticamente.
  3. No detalhe (/dashboard/prompts/[id]), use o playground: preencha vars + escolha modelo + cole sua API key (sk-...) + roda.
  4. Veja resposta + link "ver session →" pra debug detalhado.
  5. Exporte como curl/Python/JSON quando quiser usar fora do dashboard.

Sintaxe de variáveis

Use chaves duplas com nome alfanumérico + underscore: {{nome}}, {{produto_x}}, {{user_email}}. Vars não preenchidas no playground ficam literais (não dá erro). Máximo 20 vars por prompt.

Versionamento

Toda edição que muda body ou variables cria uma nova PromptVersion (append-only — versões antigas nunca somem). A versão atual é o que aparece no playground; histórico completo fica acessível na seção "Histórico de versões". Você pode adicionar nota da versão (ex: "ajustei tom mais formal") pra navegação mais clara depois.

Playground + Sessions

Cada run do playground cria automaticamente uma Session com prefixo prompt-<prompt_id>-<timestamp>. Isso significa que você vê o histórico de runs do prompt em duas telas:

  • Aba "Histórico de runs" na página do prompt — últimos 20 com custo médio.
  • /dashboard/sessions filtrando pelo prefixo do prompt.

Endpoints API

  • GET /me/prompts — lista prompts do user
  • POST /me/prompts — cria (versão 1)
  • GET /me/prompts/<id> — detalhe
  • PATCH /me/prompts/<id> — atualiza (nova versão se body mudou)
  • DELETE /me/prompts/<id> — remove (cascata em versões)
  • GET /me/prompts/<id>/versions — histórico versões
  • POST /me/prompts/<id>/clone — duplica
  • GET /me/prompts/<id>/runs?limit=20 — histórico runs (via Sessions)
  • POST /me/prompts/<id>/run — renderiza vars + executa via /v1/chat/completions

Custos

Templates são gratuitos pra criar e armazenar. Cobrança ocorre apenas quando você roda no playground via /me/prompts/:id/run — usa a mesma tabela de markup /docs/pricing do modelo escolhido. Recomendamos test-free (gpt-oss-120b) pra desenvolvimento com custo R$ 0,00.

Limites

  • Nome: 3-120 chars
  • Body: 1-32.000 chars
  • Variables: máximo 20, padrão [a-zA-Z0-9_]{1,40}
  • Tags: máximo 10, cada uma até 24 chars
  • Sem limite de versões (append-only)
  • Run history: últimos 100 (default 20)

Veja também