> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Demander à Milian

> Interroger Milian par API avec autorisation explicite des crédits supplémentaires.

Avec **POST /api/v1/milian/ask** ou l’outil MCP **ask\_milian**, Milian répond aux questions, analyse les données autorisées et recommande les prochaines étapes. Il ne modifie pas les ressources de l’espace de travail.

## Autorisation et crédits

Avant **chaque** question, informez l’utilisateur que Milian consomme des **crédits supplémentaires** et obtenez son autorisation explicite. Définissez `confirmed` sur `true` uniquement après cet accord. La connexion d’un client ou l’autorisation d’accès ne vaut pas accord pour de futures questions payantes.

L’utilisation est facturée à l’espace de travail actif **aux mêmes tarifs que Milian dans le tableau de bord**. Les crédits disponibles sont vérifiés avant la génération. La réponse indique les crédits réellement débités ; le travail effectué peut être facturé même si une étape ultérieure échoue. Chaque question suivante ou nouvelle tentative est payante : ne relancez pas automatiquement.

## Accès et requête

Utilisez une clé API d’espace de travail ou un jeton OAuth avec `milian:write` et les autorisations de lecture nécessaires, comme `calls:read`. Pour OAuth, sélectionnez **Milian** et les groupes de données à analyser. Milian est facultatif et n’est inclus ni dans les sept groupes par défaut ni dans le profil public Assistant History. Les rôles Viewer et Billing ne peuvent pas lancer de questions payantes.

Les questions sont indépendantes et ne sont pas ajoutées à l’historique du tableau de bord. Incluez le contexte nécessaire.

```json theme={null}
{"question":"Analyse mes derniers appels et recommande des améliorations.","confirmed":true,"locale":"fr"}
```

Envoyez ce corps avec une authentification Bearer au point de terminaison ci-dessus, après autorisation. Sous `data`, la réponse contient la référence `id`, `answer`, les `credits` réellement débités, `status` et `billing_complete`. Vérifiez ces deux indicateurs. Un crédit insuffisant avant le démarrage renvoie HTTP 402, une autorisation manquante HTTP 400 et des droits insuffisants HTTP 403.

Voir [Outils et portées MCP](/fr/mcp/tools-and-scopes).