---
title: "Question à l'agent du Hub"
method: POST
path: "/hub/questions"
---

# Question à l'agent du Hub

`POST /hub/questions`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/hub/questions`
- Auth: HTTP bearer

Une question libre posée à l'agent du Hub, qui raisonne avec Gemini 4 Argon pour les analyses et les dossiers, et Gemini 3.8 Flash, plus rapide, pour les recherches et les questions simples (deux modèles de Google, choisis à chaque question). L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a. Avec une clé personnelle, le profil investisseur, la mémoire du compte et le projet désigné entrent dans son contexte. Coût : 120 crédits par appel réussi.

## Request body

- object
  - `question` string, required
  - `contexte` object
    - `projet_id` string, uuid: Projet du compte dont le contexte est repris (clé personnelle).
    - `annonce` string: Annonce dont parle la question.
    - `cle_ban` string: Adresse dont parle la question.
    - `insee` string: Commune dont parle la question.
  - `memoire` boolean: Faux : ni profil investisseur ni mémoire du compte dans le contexte.
  - `outils_autorises` string[]: Outils MCP que l'agent peut appeler (noms du catalogue) ; absent : toutes les opérations de lecture servies à cette clé.
  - `plafond_credits` integer: Crédits au plus pour la question : son prix plus celui des opérations que l'agent appelle. Au-delà, l'agent conclut avec ce qu'il a.

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `reponse` string, required: La réponse rédigée par l'agent, en Markdown.
  - `appels` object[], required
    - `outil` string, required: Nom de l'outil MCP (et de l'opération) appelé.
    - `entree` object, required
    - `resultat` unknown, required
    - `erreur` object, nullable, required
      - `code` string, required
      - `detail` string, required
    - `credits` integer, required: Crédits de cet appel, compris dans le débit de la question.
  - `sources` string[], required: Les sources des résultats utilisés, lues dans leurs blocs qualite.
  - `questions` string[], required: Les faits que les opérations ont demandés pour aller plus loin ; vide si rien ne manque.
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)