Paramètres par MCP

Un agent de code connecté au point d’accès MCP lit les paramètres de ton organisation, planifie une modification et l’applique avec trois outils : get_settings, plan_settings et apply_settings. Il agit avec le rôle de la personne dont il utilise la clé API. Il peut modifier ce que cette personne pourrait modifier dans l’application, avec les mêmes contrôles, et les journaux d’audit enregistrent chaque modification comme faite par cette personne, par MCP.

Ce qu’un agent peut modifier

Tale lit et écrit chaque type de paramètre avec son propre code et les contrôles qu’applique l’application : les règles de rôle sont donc les mêmes que dans l’application.

Une ressource a un identifiant au sein de son type : un fournisseur, son nom ; des identifiants, <provider>/<name> avec le nom encodé en URI ; une politique, sa clé, comme password_policy ; un projet, son identifiant ; un agent, <projectId>/<agentId> ; une tâche, <projectId>/<taskId>. Le modèle d’embedding, le branding et les paramètres du déploiement n’ont pas d’identifiant. get_settings liste les paramètres des projets et des agents page par page, sur les projets que tu peux lire ; il ne lit la description d’une tâche et son contexte de relecture que par l’identifiant de la tâche.

Certaines modifications restent dans Tale :

• Chaque secret, comme la clé API d’un fournisseur, un abonnement ou la clé du fournisseur de modération, est saisi par une personne dans Tale.
• La politique de conservation et la politique des demandes des personnes concernées changent uniquement par leurs propres procédures échelonnées.
• Les images du branding sont téléversées dans Tale. Un nom de fichier qu’un agent définit doit désigner une image déjà téléversée.
• Par MCP, le modèle d’embedding lui-même ne change que tant que les connaissances de l’organisation ne contiennent aucun document et aucun site web : ainsi, les vecteurs de deux modèles ne se rencontrent jamais dans une même recherche. Son seuil de similarité et ses limites d’utilisation changent à tout moment ; si des documents sont indexés, une personne change le modèle dans Tale.
• L’agent standard d’un projet suit la politique standard_agent, que modifie le type governance ; ses propres instructions, outils et modèle ne sont pas des paramètres.
• Aucun type ne couvre les membres, les équipes, les connectors, les skills, les compétences, les conservations légales, les journaux d’audit, les métriques ni les paramètres personnels. get_settings sans arguments indique ce que couvre chaque type.

Faire une modification

1. Appelle get_settings sans arguments. La réponse liste chaque type, indique si ce déploiement le sert et si ton rôle peut le lire et le modifier.
2. Lis ce que tu veux modifier avec get_settings et kinds (et ids). Chaque ressource arrive avec sa key, sa config et son hash.
3. Planifie la modification avec plan_settings. Un set remplace toute la ressource par sa config : envoie donc chaque champ qui doit rester, tel que tu l’as lu. Le plan indique pour chaque modification son action, son diff, ses effets et son risque, ou le refus qui l’arrête. Rien n’est écrit.
4. Montre le plan à la personne et attends sa décision. Commence par les effets et le risque.
5. Applique les mêmes modifications avec apply_settings. expected associe la key de chaque ressource modifiée au hash que tu as lu, ou null pour une ressource que tu crées.

Voici les arguments d’un plan qui active la rotation des mots de passe :

{
  "changes": [
    {
      "kind": "governance",
      "id": "password_policy",
      "op": "set",
      "config": {
        "minLength": 12,
        "requireUpper": true,
        "requireLower": true,
        "requireDigit": true,
        "requireSpecial": true,
        "rotationDays": 90
      }
    }
  ]
}

Le plan indique l’effet sur les membres, car la rotation fait expirer les mots de passe déjà définis. Le hash est raccourci ici :

{
  "ok": true,
  "changes": [
    {
      "kind": "governance",
      "id": "password_policy",
      "key": "governance/password_policy",
      "op": "set",
      "action": "update",
      "currentHash": "5c1f…",
      "diff": [{ "path": "/rotationDays", "before": 0, "after": 90 }],
      "effects": ["may-lock-out-members"],
      "risk": "critical"
    }
  ]
}

Pour l’appliquer, envoie les mêmes changes avec "expected": { "governance/password_policy": "5c1f…" }, en utilisant le hash complet. Avant toute écriture, chaque modification est de nouveau planifiée par rapport à ce qui est enregistré maintenant. Si l’une est refusée, ou si une ressource a changé depuis ta lecture, rien n’est appliqué. Sinon, les modifications s’exécutent dans un ordre fixe d’un type à l’autre, pour que ce à quoi une ressource fait référence existe d’abord. La première modification qui échoue arrête les suivantes, et la réponse indique ce qui a été appliqué (applied), ce qui a échoué (failed) et ce qui a été ignoré (skipped). Une modification déjà appliquée n’est pas annulée.

apply_settings demande à la personne avant chaque appel et dispose de son propre budget.

Lire les effets d’un plan

Le risque d’un plan est le plus élevé entre le risque de base de son type et celui de ses effets. Voici les effets que peuvent nommer les types servis aujourd’hui :

La référence des paramètres que get_docs renvoie pour le sujet settings (aussi tale://docs/settings) liste tout le vocabulaire, les champs de chaque type et chaque politique.

Secrets

Aucun secret n’entre dans un appel de paramètres ni n’en sort. Un secret enregistré se lit {"masked": true, "preview": "…"}, de même que tout ce qu’un paramètre enregistré contient et que Tale ne montre jamais dans l’enregistrement d’une exécution : une clé que quelqu’un a collée dans une politique ou une instruction, une clé saisie dans un en-tête dont le nom dit qu’il en contient une, ou un mot de passe dans une adresse. Un en-tête qui ne fait que nommer le secret enregistré, comme Bearer {{secret}}, se lit tel qu’il est enregistré. Une clé dans un texte plus long masque tout le texte. Renvoie une valeur masquée telle quelle pour garder ce qui y est enregistré, ou remplace toute la valeur. Une modification qui contient un secret est refusée avec SECRET_ARGUMENT_REFUSED, qui indique où le secret a été trouvé, jamais sa valeur. Une personne saisit un nouveau secret dans Tale.

Quand une modification est refusée

Un refus arrive sous forme de données, avec un error, un code, un hint et parfois data, jamais comme une connexion interrompue. Voici les codes qu’un agent rencontre le plus souvent :

La référence des paramètres liste chaque code. La page du point d’accès MCP décrit les arguments et les réponses des outils.