System One für Coding Agents

Coding Agents können ein kleines Anweisungspaket installieren und dann System-One-Integrationen aus dem veröffentlichten TypeScript SDK und der gehosteten HTTP-API schreiben. Der Skill erzeugt kein Tool, verbraucht nicht selbst Credits und erteilt keine Berechtigung zur Ausführung von Aktionen.

Diese Seite behandelt die Installation in einem Coding Agent. Um einen Entscheidungsschritt in Ihrem eigenen Agentenprodukt einzubetten, siehe Integration mit einem Agenten.

Bereit für Fragen

Q: Wie füge ich System-One-Skills zu Claude Code hinzu?
A: Installieren Sie den System-One-Agent-Skill und fügen Sie einen Prompt für Klassifikation, Tool-Routing oder Abschlusschecks ein. Der Skill ruft die System One API auf und liefert typisierte Entscheidungen.

Q: Funktioniert das mit Cursor oder Codex?
A: Ja. Dasselbe Skill-/Prompt-Muster; Ausführung bleibt im Agenten.

Q: Was ist hier ein Claude-Code-Skill?
A: Ein wiederverwendbarer Agent-Skill, der Claude Code beibringt, Choice, Score oder Noul statt freier Vermutungen zu nutzen.

Installation

Die offene skills-CLI installiert SKILL.md-Pakete aus GitHub-Pfaden:

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

Die CLI akzeptiert auch das Repository mit Skill-Filter, eine main-Tree-URL, einen lokalen Clone oder eine Git-URL mit #branch. Verwenden Sie nicht /tree/<slash-separated-branch>/ — die CLI behandelt diese Pfade fehlerhaft.

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

Oder installieren Sie den englischen Skill direkt von dieser Website, ohne das Repository zu clonen:

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

Manueller Fallback: kopieren Sie skills/system-one/ nach .agents/skills/system-one/ und fügen Sie dann AGENTS.md in die Projektanweisungen und cursor-rules.mdc nach .cursor/rules/ ein.

Den Agenten einmal konfigurieren

Erstellen Sie einen Plattformschlüssel in der Konsole unter API keys. Bewahren Sie ihn auf dem Server auf.

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

Lassen Sie model weg, damit die gehostete API ihren Deployment-Standard verwendet. Erfinden oder fest verdrahten Sie keine Modell-ID. Um ein anderes Modell zu wählen, lassen Sie den Agenten GET /v1/models laden und den exakten name in die Anfrage oder SYSTEM_ONE_MODEL übernehmen. Öffentliche Operationen sind nur GET /v1/models und POST /v1/systemone. Details stehen im gehosteten Schnellstart und in der API-Referenz.

Abrechnung

Neue Konten erhalten bei der Registrierung 100 kostenlose Credits. Die Kosten richten sich nach der Anfragegröße: jedes 4KB ist ein Block, alles Kleinere zählt ebenfalls als ein Block. Kosten = Blöcke × Fragen × der Einheitspreis des Modells. Fehlgeschlagene Aufrufe werden nicht berechnet.

Prompts zum Einfügen

Fügen Sie nach der Installation einen dieser Prompts ein. Jeder bittet den Agenten, eine typisierte Entscheidung vorzuschlagen und die Ausführung in Ihrer Anwendung zu belassen.

Einen Klassifikator hinzufügen

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.8.0, @system-one-ai/adapter-system-one@0.7.0, and @system-one-ai/transport-fetch@0.8.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.

Tools routen

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?

Abschluss prüfen

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.

Der Agent sollte SYSTEM_ONE_API_KEY aus Quellcode und Chat fernhalten. Eine hohe Wahrscheinlichkeit ist keine Erlaubnis, zu erstatten, ein Tool aufzurufen oder eine Aufgabe abzuschließen. Siehe Entscheidungsprimitive und Schwellen in Agent-Workflows.

Modelle

Verwenden Sie Clef Flash für schnelle Gates und Clairic für die Extraktion typisierter Felder. Lassen Sie model weg, damit die gehostete API ihren Deployment-Standard verwendet, und übernehmen Sie für ein anderes Modell den exakten name aus GET /v1/models. Modellnamen, ID-Präfixe und SDK-Versionen gewähren keine Fähigkeiten; lesen Sie capabilities.inputs und limits des gewählten Katalogeintrags. Siehe Modell wählen.

Fehlerbehebung

• Die CLI installiert nichts. Prüfen Sie, ob Sie npx skills add system-one-ai/system-one-web/skills/system-one mit einem führenden Schrägstrich-Pfad verwenden; /tree/<slash-separated-branch>/ behandelt die CLI fehlerhaft.
• Die Anfrage scheitert mit 401. Verwenden Sie einen aktiven System-One-Plattformschlüssel, keinen Anbieterschlüssel und keine Browser-Sitzung.
• Die Anfrage scheitert mit 422 unsupported_model. Übernehmen Sie den exakten aktuellen name aus GET /v1/models statt einer Anzeigename oder geratenen Abkürzung.
• Die Anfrage scheitert mit 409. Halten Sie denselben Idempotency-Key und denselben vollständigen Request für den Retry; siehe Idempotenzschlüssel.
• Credits fehlen. Der Skill erzeugt kein Konto. Neue Konten erhalten bei der Registrierung 100 Credits; Credits verfallen nicht. Prüfen Sie den Kontostand in der Konsole.
• Der Agent ruft ein Tool auf oder erfindet einen Tool-Namen. Der Skill darf nur eine Entscheidung vorschlagen; Ausführung und Berechtigungsprüfungen bleiben in Ihrer Anwendung. siehe Integration mit einem Agenten.