Développer · CLI

La commande reperes

L'API REPERES en ligne de commande, livrée avec le SDK Python : utile pour explorer les réponses, écrire un script ou rejouer un cas. Code source : confidensia-lab/reperes-kit.

Installation

pip install reperes
export REPERES_API_KEY=rpr_sk_…
reperes --version

Exemples

reperes context "Quels repères pour construire un projet de service ?" --exploration
reperes precision "Quelle est la durée maximale d'un CPOM ?"
reperes valeur smic.horaire --date 2026-03-01
reperes valeur apa.domicile.plafond --coord gir=1
reperes valeur "plafond APA GIR 1"
reperes valeur point.ccn66 --historique
reperes remuneration ccn66 educateur_specialise --anciennete 10 --etablissement mecs --oui surclassement_internat
reperes remuneration ccn51 aide_soignant --etablissement ehpad --quantite heures_dimanche_ferie=14 --temps 0.8
reperes trajectoire ccn66 moniteur_educateur --etablissement ime --lecture carriere --debut 2016 --reference 2024-06
reperes esat --part 35 --effectif 30 --sante-esat 20 --sante-travailleur 20 --prevoyance 15
reperes autonomie scenario.json --prix 32
printf '%s' 'Ma question' | reperes context -
reperes outil reperes_valeur --arguments '{"id": "smic.horaire", "date": "2026-03-01"}'
reperes agent remuneration --message "Coût d'un éducateur spécialisé, 10 ans, MECS ?" --session s.json --json

Commandes

reperes context « question » [--exploration]
Contexte sourcé, sans rédaction ; - lit la question sur l'entrée standard.
reperes precision « question »
Information ponctuelle et citation vérifiée.
reperes answer « question »
Réponse rédigée (option Génération ou crédits).
reperes valeur <id|question> [--date] [--territoire] [--coord dimension=valeur] [--historique]
Valeur de référence datée et sourcée.
reperes valeurs [--q] [--famille]
Paramètres candidats ou catalogue d'une famille.
reperes remuneration <convention> <emploi> [options] | --modeles
Simulation de rémunération CCN 66 ou CCN 51 ; --modeles : emplois et établissements.
reperes trajectoire <convention> <emploi> [--debut] [--fin] [--lecture] [--reference]
Rémunération en euros courants et constants.
reperes esat --part <% SMIC> | --euros <€> [--temps] [--effectif]
Rémunération garantie en ESAT.
reperes autonomie <scenario.json|-> [--prix] [--taux] [--date]
APA à domicile ; un cas de référence est accepté.
reperes source <id> [--content]
Passeport de preuve d'un document (public).
reperes contrats ; schema <contrat> ; openapi
Contrats publiés, schéma d'un contrat, description de l'API (publics).
reperes outils
Catalogue des outils pour modèles : nom, description, schéma des arguments (public).
reperes outil <nom> --arguments <json|-> [--decrire]
Exécute un outil REPERES, sans modèle : arguments JSON (ou entrée standard), résultat JSON ; --decrire donne son schéma.
reperes agent <kit> [--message] [--session] [--json] [--connexion api|cli]
Agent d'un kit (apa, remuneration, esat) : conversation, ou un tour par appel avec session reprise et sortie JSON.
reperes skills [--exporter <dossier>]
Compétences Agent Skills des kits, à exporter pour un agent de code (ex. .claude/skills).

reperes <commande> --help détaille chaque option. Options communes : --pretty (JSON indenté), --erreurs-json (erreurs en JSON), --timeout (180 secondes), --base-url (sinon REPERES_API_URL).

Sortie et codes de sortie

Le JSON reçu sort seul sur la sortie standard ; les erreurs sur la sortie d'erreur, avec le code HTTP et le code d'erreur de l'API, jamais la clé ; avec --erreurs-json, un objet de forme stable {"error", "message", "statut_http", "detail", "upgrade_url"}. Aucune invite interactive, sauf reperes agent sans --message. Un agent de code a rarement besoin de reperes agent : il charge la compétence du kit et appelle reperes outil.

0
Succès, y compris un statut métier (not_found, contexte vide).
1
Échec sans résultat : erreur HTTP ou réseau, clé absente, droit, franchise et crédits épuisés.
2
Arguments invalides.
3
Résultat rendu mais dégradé (recherche indisponible, valeur indisponible, simulation en erreur) : le JSON reste sur la sortie standard et dit pourquoi.