Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

A API de Prompts permite que você armazene, versiona e gerencie modelos de prompt de forma centralizada. Cada alteração em um modelo cria uma versão imutável, fornecendo um histórico completo de mudanças com a possibilidade de reverter para qualquer versão anterior a qualquer momento. Os modelos suportam marcadores {{variable}} que são renderizados no servidor quando você recupera um prompt, permitindo reutilizar o mesmo modelo em diferentes contextos.

​
Criar um prompt

Crie um prompt com um nome e modelo. A primeira versão é criada automaticamente. 
mka1 llm prompts create \
  --body '{
    "name": "greeting",
    "description": "Um modelo simples de saudação",
    "template": "Hello, {{name}}! Welcome to {{company}}.",
    "metadata": { "team": "onboarding" }
  }' \
  -H 'X-On-Behalf-Of: <end-user-id>'

​
Recuperar um prompt com variáveis renderizadas

Passe variables como parâmetro de consulta para renderizar o modelo com seus valores. Marcadores não correspondentes permanecem inalterados. 
mka1 llm prompts get \
  --id prompt_abc123 \
  --variables '{"name":"Alice","company":"Acme"}'

​
Listar prompts

Recupere uma lista paginada de todos os prompts. Use after para paginação baseada em cursor. 
mka1 llm prompts list --limit 10 --order desc

​
Atualizar metadados do prompt

Atualize o nome, descrição ou metadados de um prompt. Para alterar o modelo, crie uma nova versão. 
mka1 llm prompts update \
  --id prompt_abc123 \
  --body '{
    "name": "welcome-greeting",
    "description": "Saudação atualizada para o fluxo de boas-vindas",
    "metadata": { "team": "onboarding", "reviewed": true }
  }'

​
Criar uma nova versão

Cada alteração no modelo cria uma nova versão. A nova versão se torna automaticamente a versão ativa. 
mka1 llm prompts create-version \
  --id prompt_abc123 \
  --body '{
    "template": "Hi {{name}}! Welcome aboard at {{company}}. Your onboarding starts {{date}}."
  }'

​
Visualizar histórico de versões

Liste todas as versões de um prompt para ver seu histórico completo de alterações. 
mka1 llm prompts list-versions --id prompt_abc123 --order desc

​
Recuperar uma versão específica

Busque uma versão única pelo seu número de versão. 
mka1 llm prompts get-version --id prompt_abc123 --version-param 1

​
Reverter para uma versão anterior

A reversão define uma versão anterior como a versão ativa. Todas as versões são preservadas — a reversão não exclui versões mais recentes, então você sempre pode avançar novamente. 
# Atualmente na versão 2, reverter para a versão 1
mka1 llm prompts rollback --id prompt_abc123 --version-param 1

​
Excluir um prompt

Excluir um prompt o remove permanentemente, junto com todas as suas versões. 
mka1 llm prompts delete --id prompt_abc123

​
Exemplo completo: fluxo de versionamento e reversão

Este exemplo demonstra o ciclo de vida completo — criação de um prompt, iteração no modelo, revisão do histórico e reversão. 
# 1. Crie um prompt com o modelo inicial
mka1 llm prompts create \
  --body '{
    "name": "support-reply",
    "template": "Hi {{customer}}, thanks for contacting us about {{issue}}."
  }'
# → { "id": "prompt_abc123", "active_version": 1, ... }

# 2. Lance a v2 com um tom mais amigável
mka1 llm prompts create-version \
  --id prompt_abc123 \
  --body '{
    "template": "Hey {{customer}}! We got your message about {{issue}} and are on it."
  }'

# 3. Recupere o prompt com variáveis renderizadas
mka1 llm prompts get \
  --id prompt_abc123 \
  --variables '{"customer":"Alice","issue":"billing"}'

# 4. Revise o histórico de versões
mka1 llm prompts list-versions --id prompt_abc123 --order asc

# 5. Reverter para a v1
mka1 llm prompts rollback --id prompt_abc123 --version-param 1

# 6. Limpeza
mka1 llm prompts delete --id prompt_abc123

​
Detalhes do comportamento

AspectoDetalhe
VersionamentoImutável — cada alteração no modelo cria uma nova versão que não pode ser modificada
Versão ativaNovas versões são ativadas automaticamente; use a reversão para alternar para outra versão
ReversãoNão destrutivo — define active_version sem excluir versões mais recentes
PaginaçãoBaseada em cursor para listar prompts — use o parâmetro after com first_id/last_id da resposta
Renderização do modeloNo servidor — passe o parâmetro de consulta variables; marcadores não correspondentes são preservados
PropriedadePor chave de API — prompts são isolados por contexto de autenticação
ConcorrênciaDetecção de conflito — criação concorrente de versões retorna 409

​
Próximos passos