Ask & Generate

// Utilisation basique avec le RAG
const result = await orka.ask({
  question: 'Comment réinitialiser mon mot de passe?',
  knowledge: 'support-docs',  // Nom de votre base de connaissances
});
 
console.log(result.answer);  // Pour réinitialiser votre mot de passe, allez dans Paramètres > Sécurité...
 
// Utilisation avancée avec toutes les options
const result = await orka.ask({
  question: 'Comment réinitialiser mon mot de passe?',
  knowledge: 'support-docs',
  systemPrompt: 'Vous êtes un agent de support helpful. Soyez concis et amical.',
  topK: 5,                    // Nombre de morceaux de contexte à récupérer
  minScore: 0.7,              // Score de similarité minimum pour les morceaux
  temperature: 0.7,           // Créativité du LLM (0-1)
  maxTokens: 1024,            // Longueur maximale de la réponse
  includeContext: true,       // Retourner les morceaux récupérés dans le résultat
});
 
console.log(result.answer);           // La réponse générée
console.log(result.context);          // Tableau des morceaux récupérés
console.log(result.latencyMs);        // Temps d'exécution total
console.log(result.usage.totalTokens); // Tokens consommés

// Génération simple
const response = await orka.generate('Write a haiku about TypeScript');
console.log(response); // "Types flow like water..." (string)
 
// Avec options
const response = await orka.generate('Résumez cet article: [article text]', {
  temperature: 0.3,      // Plus bas pour une sortie plus déterministe
  maxTokens: 200,        // Limite la longueur de la réponse
  systemPrompt: 'Vous êtes un résumé professionnel. Soyez concis.',
});
 
// Écriture créative
const story = await orka.generate('Écris une courte histoire sur un robot', {
  temperature: 0.9,      // Plus haut pour plus de créativité
  maxTokens: 1000,
  systemPrompt: 'Vous êtes un écrivain de fiction créatif.',
});
 
// Génération de code
const code = await orka.generate('Écris une fonction TypeScript pour trier un tableau', {
  temperature: 0.2,      // Bas pour du code précis
  systemPrompt: 'Vous êtes un expert développeur TypeScript. Retournez uniquement du code.',
});

// Single text embedding
const [embedding] = await orka.embed('Bonjour le monde');
console.log(embedding.length); // e.g., 1536 (dépend du modèle)
console.log(embedding[0]);     // e.g., 0.0234 (première dimension)
 
// Multiple texts (batched for efficiency)
const embeddings = await orka.embed([
  'Comment réinitialiser mon mot de passe?',
  'J'ai oublié mes identifiants de connexion',
  'Quel est le temps aujourd'hui?',
]);
 
// Compare similarity (cosine similarity)
function cosineSimilarity(a: number[], b: number[]): number {
  const dot = a.reduce((sum, val, i) => sum + val * b[i], 0);
  const magA = Math.sqrt(a.reduce((sum, val) => sum + val * val, 0));
  const magB = Math.sqrt(b.reduce((sum, val) => sum + val * val, 0));
  return dot / (magA * magB);
}
 
const sim1 = cosineSimilarity(embeddings[0], embeddings[1]); // ~0.85 (similar)
const sim2 = cosineSimilarity(embeddings[0], embeddings[2]); // ~0.45 (different)

import { createOrka } from '@orka-js/core';
import { OpenAIAdapter } from '@orka-js/openai';
import { MemoryVectorAdapter } from '@orka-js/memory';
 
const orka = createOrka({
  llm: new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! }),
  vectorDB: new MemoryVectorAdapter(),
});
 
// 1. Créer une base de connaissances
await orka.knowledge.create({
  name: 'product-docs',
  source: [
    'Notre produit supporte le mode sombre. Allez dans Paramètres > Apparence pour l'activer.',
    'Pour réinitialiser votre mot de passe, cliquez sur "Mot de passe oublié" sur la page de connexion.',
    'Les utilisateurs premium ont accès à des appels API illimités et un support prioritaire.',
  ],
});
 
// 2. Poser des questions le RAG
const result = await orka.ask({
  question: 'Comment activer le mode sombre?',
  knowledge: 'product-docs',
  topK: 3,
  includeContext: true,
});
 
console.log('Answer:', result.answer);
// "To enable dark mode, go to Settings > Appearance."
 
console.log('Sources:', result.context?.map(c => c.content.slice(0, 50)));
// ["Our product supports dark mode. Go to Settings > ..."]
 
// 3. Génération directe (pas de RAG)
const summary = await orka.generate(
  'Résume: ' + result.answer,
  { temperature: 0.3, maxTokens: 50 }
);
 
// 4. Obtenir des embeddings pour une logique personnalisée
const [queryEmbed] = await orka.embed('paramètres du mode sombre');
console.log('Dimensions de l'embedding:', queryEmbed.length);