System One pour agents de code

Les agents de code peuvent installer un petit pack d’instructions, puis écrire des intégrations System One à partir du SDK TypeScript publié et de l’API HTTP hébergée. Le skill ne crée pas d’outil, ne dépense pas de crédits à lui seul et n’accorde aucune permission d’exécution.

Installez une fois le skill agent System One, puis réutilisez des prompts pour la classification, le routage d’outils et les contrôles de fin dans Claude Code, Cursor ou Codex. Le skill appelle l’API System One hébergée et renvoie des décisions typées Choice / Score / Noul ; l’exécution reste locale.

Cette page concerne l’installation d’un skill dans un agent de code. Pour embarquer une étape de décision dans votre propre produit agent, voir Intégration agent.

Prêt pour les questions

Q : Comment ajouter les skills System One à Claude Code ?
A : Installez le skill agent System One, puis collez un prompt pour classification, routage d’outils ou contrôles de fin. Le skill appelle l’API System One et renvoie des décisions typées.

Prêt pour les questions

Comment ajouter les skills System One à Claude Code ? Installez le skill agent System One, puis collez un prompt pour la classification, le routage d’outils ou les contrôles de fin. Le skill appelle l’API System One et renvoie des décisions typées.

Cela fonctionne-t-il avec Cursor ou Codex ? Oui. Même schéma skill/prompt ; l’exécution reste dans l’agent.

Qu’est-ce qu’un Claude Code skill ici ? Un skill agent réutilisable qui enseigne à Claude Code à appeler Choice, Score ou Noul pour des décisions structurées.

Installation en une commande

Le CLI ouvert skills installe des paquets SKILL.md depuis des chemins GitHub :

npx skills add system-one-ai/system-one-web/skills/system-one

Le CLI accepte également le dépôt avec un filtre de skill, une URL d’arborescence main, un clone local ou une URL Git avec #branch. N’utilisez pas /tree/<branche-séparée-par-des-slashes>/ : le CLI gère mal ces chemins.

npx skills add system-one-ai/system-one-web --skill system-one
npx skills add https://github.com/system-one-ai/system-one-web/tree/main/skills/system-one
npx skills add ./skills/system-one
npx skills add /absolute/path/to/system-one-web/skills/system-one
npx skills add https://github.com/system-one-ai/system-one-web.git#<branch> --skill system-one

Ou installez le skill anglais directement depuis ce site, sans cloner le dépôt :

npx skills add https://system-one.dev

Repli manuel : copiez skills/system-one/ vers .agents/skills/system-one/, puis collez AGENTS.md dans les instructions du projet et cursor-rules.mdc dans .cursor/rules/.

Configurer l’agent une fois

Créez une clé de plateforme dans la console API keys. Gardez-la sur le serveur.

export SYSTEM_ONE_API_KEY="replace-with-your-platform-key"
export SYSTEM_ONE_BASE_URL="https://system-one.dev/v1"
# Worker local après `pnpm dev` :
# export SYSTEM_ONE_BASE_URL="http://localhost:7001/v1"

Omettez model pour que l’API hébergée utilise son défaut de déploiement. N’inventez pas et ne figez pas un identifiant de modèle. Pour choisir un autre modèle, demandez à l’agent de charger GET /v1/models et de copier un name exact dans la requête ou dans SYSTEM_ONE_MODEL. Le trio SDK texte hébergé est @system-one-ai/core@0.6.0, @system-one-ai/adapter-system-one@0.6.0 et @system-one-ai/transport-fetch@0.6.0. Les opérations publiques sont uniquement GET /v1/models et POST /v1/systemone.

Facturation

Les nouveaux comptes reçoivent 100 crédits gratuits à l’inscription. Le coût dépend de la taille de la requête : chaque 4 Ko est un bloc, et une taille inférieure compte quand même comme un bloc. Coût = blocs × questions × prix unitaire du modèle. Les appels échoués ne sont pas facturés.

Prompts à copier-coller

Après l’installation, collez l’un de ces prompts. Chacun demande à l’agent de proposer une décision typée et de laisser l’exécution dans votre application.

Ajouter un classifieur

Use the System One skill. Add a server-side classifier that sends this support message to Choice teams billing, support, or review. Install only @system-one-ai/core@0.6.0, @system-one-ai/adapter-system-one@0.6.0, and @system-one-ai/transport-fetch@0.6.0. Omit model so the API default is used; do not invent or hardcode a model id. Persist an Idempotency-Key. Return the selected team, probabilities, and confidence. If confidence is missing or the top two probabilities are close, route to review. Do not assign the ticket or contact the customer.

Message: I was charged twice for my annual plan and need a refund.

Router les outils

Use the System One skill before wiring any tool dispatcher. Define a Choice among the allowlisted tools search_docs, ask_user, and human_review. Omit model so the API default is used. Keep maxRetries at 0 and store the Idempotency-Key with the exact request. If the answer is missing, the request fails, or confidence is low, choose human_review. Do not execute a tool, invent a tool name, or put the API key in the prompt.

User request: Can you explain how credits are calculated?

Contrôle de fin

Use the System One skill to check whether this task looks complete. Ask a Noul question for "the stated objective is met" and a Choice among complete, verify_more, and incomplete. Omit model so the API default is used. Treat probability near 0.5, missing answers, and failed requests as verify_more. Do not mark the work done or skip tests.

Objective: add API-key authentication to the production endpoint.
Completed: added the Authorization check and API-key lookup.
Verification: unit tests pass; production request and rate-limit behavior were not tested.

L’agent doit garder SYSTEM_ONE_API_KEY hors des sources et de la conversation. Une probabilité élevée n’est pas une permission de rembourser, d’appeler un outil ou de clore une tâche.

Modèles

Le skill n’a besoin d’aucun modèle figé : omettez model et laissez l’API utiliser son défaut. Pour un choix explicite, copiez un name exact de GET /v1/models. Voir Choisir un modèle pour comparer les modèles, leurs entrées, leurs limites et leurs prix.

Dépannage

• L’agent n’appelle pas l’API. Vérifiez que SYSTEM_ONE_API_KEY et SYSTEM_ONE_BASE_URL sont définis dans l’environnement du serveur, et que le skill a bien été installé.
• Une clé est refusée. Créez une clé de plateforme dans la console ; une clé expirée ou révoquée ne fonctionne pas.
• La commande d’installation échoue. Évitez la forme /tree/<branche-séparée-par-des-slashes>/ ; utilisez le chemin du dépôt ou une URL Git avec #branch.
• Un débit semble doublé. Conservez la même Idempotency-Key et la même requête pour une relance. Voir Clé d’idempotence.
• Le modèle renvoie une erreur. Vérifiez le code d’erreur dans X-System-One-Error-Code et la source dans X-System-One-Error-Source. Voir Codes d’erreur API.

Liens internes : Intégration agent, Choisir un modèle, Clé d’idempotence.