API: Prompt Versions¶

Visao Geral¶

Versionamento automatico de prompts. Cada alteracao no SystemPrompt de um Agent ou nas Instructions de um Step cria um snapshot automatico da versao anterior. Permite visualizar historico, comparar e restaurar versoes.

Endpoints¶

GET /api/agents/{agentId}/prompt-versions¶

Lista o historico de versoes do SystemPrompt de um agent.

Response (200 OK):

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "version": 2,
    "content": "Voce e um assistente de TI...",
    "optimizedContent": "Assistente TI. Regras: ...",
    "createdAt": "2024-01-20T14:00:00Z"
  },
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "version": 1,
    "content": "Voce e um bot de suporte...",
    "optimizedContent": null,
    "createdAt": "2024-01-15T10:30:00Z"
  }
]

Versoes ordenadas da mais recente para a mais antiga.

GET /api/agents/{agentId}/steps/{stepId}/prompt-versions¶

Lista o historico de versoes das Instructions de um step.

Response: Mesmo formato acima.

Erros: - 404 — Step nao encontrado ou nao pertence ao agent

POST /api/agents/{agentId}/prompt-versions/{id}/restore¶

Restaura uma versao anterior. O conteudo atual e salvo como nova versao antes da restauracao. Requer role Admin.

Response (204 No Content): Sucesso

Erros: - 404 — Versao nao encontrada - 403 — Usuario nao e Admin

Comportamento: 1. Snapshot do estado atual e criado automaticamente 2. Conteudo da versao selecionada e aplicado 3. Prompt e re-otimizado via PromptOptimizationService 4. Cache invalidado (para agents)

Multi-tenancy¶

Versoes sao filtradas automaticamente pelo tenant do usuario autenticado via query filters no AppDbContext.

Modelo de Dados¶

Ver data-model.md para detalhes da entidade PromptVersion.