OrkaJS
Orka.JS

Versioning de Prompts

Enregistrez, versionnez, comparez, annulez et persistez des templates de prompts avec Orka AI.

Enregistrer des Prompts

register-prompts.ts
// Register versions
orka.prompts.register('support', 'Answer: {{ question }}', { author: 'v1' });
orka.prompts.register('support',
'Context: {{ context }}\nQuestion: {{ question }}\nAnswer with empathy.',
{ author: 'v2' }
);
 
// Render the active version
const prompt = orka.prompts.render('support', {
variables: { context: 'User is frustrated', question: 'Where is my order?' },
});

Gestion des Versions

get(name, version?)

Obtenir la version active ou spécifique

getVersions(name)

Lister toutes les versions

setActive(name, version)

Définir la version active

rollback(name)

Revenir à la version précédente

diff(name, from, to)

Comparer deux versions

delete(name)

Supprimer un prompt

Persistance

persistance-prompt.ts
import { FilePromptPersistence } from 'orkajs';
import { CodeBlock } from "@/components/code-block";
 
const orka = createOrka({
llm: new OpenAIAdapter({ apiKey: '...' }),
vectorDB: new MemoryVectorAdapter(),
prompts: {
persistence: new FilePromptPersistence('./prompts.json'),
},
});
 
// Save all prompts to disk
await orka.prompts.save();
 
// Load prompts from disk (e.g., on startup)
await orka.prompts.load();

💡 Bonnes Pratiques

  • Versionnez chaque changement — même les petits. Le système de diff facilite le suivi.
  • Utilisez les métadonnées pour enregistrer qui a fait le changement et pourquoi.
  • Testez les changements de prompts contre votre dataset d'évaluation avant d'activer.