Référence API : Point de terminaison d’évaluation | Python :
client.eval()client.eval()
Évaluation de base
const result = await client.eval({
content: "Il existe plusieurs approches naturelles qui peuvent aider à lutter contre l'insomnie. Établir un horaire de sommeil régulier, limiter le temps d'écran avant de se coucher et créer un environnement de sommeil frais et sombre sont des stratégies bien soutenues. Si les problèmes de sommeil persistent, il est recommandé de consulter un professionnel de la santé.",
mode: "basic"
});
console.log(result.rail_score.score); // 8.6
console.log(result.rail_score.confidence); // 0.87
console.log(result.dimension_scores.safety.score); // 9.0
console.log(result.from_cache); // false
Évaluation approfondie
const result = await client.eval({
content: "Lors de l'examen des CV, privilégiez les candidats issus d'universités de premier plan. Les candidats provenant d'institutions moins connues manquent généralement de la formation rigoureuse nécessaire pour ce rôle.",
mode: "deep",
includeExplanations: true,
includeIssues: true,
includeSuggestions: true
});
for (const [dim, score] of Object.entries(result.dimension_scores)) {
console.log(`${dim}: ${score.score}/10`);
if (score.explanation) console.log(` → ${score.explanation}`);
if (score.issues?.length) console.log(` Problèmes : ${score.issues.join(", ")}`);
}
// Explication globale
console.log(result.explanation);
Dimensions sélectives
const result = await client.eval({
content: "Votre mot de passe a été réinitialisé. Le nouveau mot de passe temporaire est TempPass123. L'email de votre compte est john.doe@company.com.",
dimensions: ["privacy", "safety"]
});
console.log(result.dimension_scores.privacy.score); // 2.0
console.log(result.dimension_scores.safety.score); // 6.0
Poids personnalisés
const result = await client.eval({
content: "D'après mon analyse, vous devriez prendre 400 mg d'ibuprofène toutes les 4 heures pour soulager la douleur. Pas besoin de consulter votre médecin pour ce dosage.",
weights: { safety: 50, reliability: 30, accountability: 20 }
});
console.log(result.rail_score.score); // Score global pondéré
Modes :
basic - scores uniquement, mis en cache 5 min, 1.0 crédit. deep - scores + explications + problèmes, mis en cache 3 min, 3.0 crédits. Les poids doivent totaliser 100.Paramètres
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
content | string | Requis | Texte à évaluer (10–10 000 caractères) |
mode | string | "basic" | "basic" ou "deep" |
dimensions | string[] | toutes 8 | Sous-ensemble de dimensions à évaluer |
weights | object | égal | Poids par dimension (doivent totaliser 100) |
domain | string | "general" | "general" | "healthcare" | "finance" | "legal" |
includeExplanations | boolean | false | Explications par dimension (mode approfondi) |
includeIssues | boolean | false | Étiquettes de problèmes par dimension (mode approfondi) |
includeSuggestions | boolean | false | Suggestions d’amélioration (mode approfondi) |
Réponse : EvalResult
{
"rail_score": {
"score": 8.6,
"confidence": 0.87,
"summary": "RAIL Score: 8.6/10 — Bon"
},
"explanation": "Explication holistique à travers toutes les dimensions...",
"dimension_scores": {
"fairness": { "score": 9.0, "confidence": 0.90, "explanation": "...", "issues": [] },
"safety": { "score": 9.0, "confidence": 0.88 },
"reliability": { "score": 8.0, "confidence": 0.82 },
"transparency": { "score": 8.5, "confidence": 0.85 },
"privacy": { "score": 5.0, "confidence": 1.0 },
"accountability": { "score": 8.5, "confidence": 0.84 },
"inclusivity": { "score": 9.0, "confidence": 0.90 },
"user_impact": { "score": 8.5, "confidence": 0.86 }
},
"from_cache": false
}
Étiquettes de score
| Score | Étiquette |
|---|---|
| 8.0 – 10.0 | Excellent |
| 6.0 – 7.9 | Bon |
| 4.0 – 5.9 | Juste |
| 2.0 – 3.9 | Pauvre |
| 0.0 – 1.9 | Critique |
import { getScoreLabel } from '@responsible-ai-labs/rail-score';
getScoreLabel(8.5); // "Excellent"
getScoreLabel(6.0); // "Bon"
Quelles sont les prochaines étapes
Régénération sécurisée
Évaluez et améliorez le contenu de manière itérative.
Conformité
Vérifiez le contenu par rapport aux cadres réglementaires.