Décrivez la tâche. Scribe pilote.

Scribe est l’IA de Writ. Vous dites ce que vous voulez en langage clair ; elle ouvre un vrai navigateur, trouve la page, y valide un sélecteur, et construit le moniteur, le workflow ou le crawl. Elle travaille par tours, et elle s’arrête avant tout ce qui vous coûte de l’argent ou touche à vos comptes.

validation ▸ elle s’arrête

Elle s’arrête et demande. C’est le principe.

Une mission avance par tours. Quand elle a besoin de vous, elle s’arrête : la session passe en awaiting_input et porte un pending_request qui décrit ce qu’elle attend. Il y a trois formes de pause :

capacités ▸ un outil par tour

Ce que vous pouvez lui demander.

Scribe choisit exactement un outil par tour, dans un jeu fixe. Elle ne peut pas inventer d’outil : la liste ci-dessous est donc tout ce qu’une mission peut faire.

lieux ▸ deux, pas un

Scribe cloud et Scribe desktop ne sont pas la même chose.

Il y a deux implémentations, et elles diffèrent par ce qu’elles ont le droit de construire. Lisez la ligne qui correspond à votre lieu d’exécution avant de bâtir une mission dessus.

Sur l’agent desktop

La même forme, en loopback, contre l’agent qui tourne sur votre propre machine — et gratuite, puisque le navigateur est le vôtre :

session ▸ ce que vous interrogez

La mission tourne en arrière-plan. Vous l’interrogez.

Le démarrage répond aussitôt avec un id de session et une URL d’interrogation — une mission de navigation survit à une requête HTTP, donc un handle est la réponse honnête. Chaque interrogation rend la même projection :

Démarrer, interroger, répondre

Une mission de bout en bout, en HTTP pur.

# Describe the job. goal is 3-2000 characters; url is an optional seed.
curl -X POST https://api.usewrit.app/api/ai-concierge/start \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "goal": "Watch the price of the 15-inch model and alert me under $1,200",
    "url": "https://example.com/laptops/15"
  }'

{
  "session_id": 4021,
  "status": "planning",
  "poll_url": "/api/ai-concierge/4021"
}

// The mission runs in the background from here. Poll poll_url.
// Every poll answers the same projection:
{
  "session_id": 4021,
  "status": "awaiting_input",
  "phase": "proposing",
  "goal": "...",
  "platform": "cloud",
  "progress_message": "Found the price on the page.",
  "transcript": [],
  "thoughts": [ { "tool": "propose_selectors", "thought": "The price sits in the buy box.", "ts": "..." } ],
  "plan": {},
  "pending_request": { "kind": "text", "requests": [] },
  "resources": {},
  "turn_seq": 3,
  "tokens": { "input": 8120, "output": 940, "credits": 29 },
  "error_message": null
}

# Poll until status is awaiting_input, then answer the CURRENT turn.
curl https://api.usewrit.app/api/ai-concierge/4021 -H "Authorization: Bearer $WRIT_API_KEY"

# turn_seq is an optimistic lock: send back the one you just read.
# A stale turn_seq answers 409 — re-read and answer the current turn.
curl -X POST https://api.usewrit.app/api/ai-concierge/4021/respond \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"turn_seq": 3, "answers": {"threshold": "1200"}}'

# Ask it a follow-up about what it just built.
curl -X POST https://api.usewrit.app/api/ai-concierge/4021/ask \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "How do I call this endpoint from my own code?"}'

# Attach a saved login identity. null clears it.
curl -X POST https://api.usewrit.app/api/ai-concierge/4021/persona \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"persona_id": 12}'

# Stop mid-turn (the mission parks, resumable) — or end it.
curl -X POST https://api.usewrit.app/api/ai-concierge/4021/interrupt -H "Authorization: Bearer $WRIT_API_KEY"
curl -X POST https://api.usewrit.app/api/ai-concierge/4021/cancel    -H "Authorization: Bearer $WRIT_API_KEY"

# Every mission you have run.
curl https://api.usewrit.app/api/ai-concierge -H "Authorization: Bearer $WRIT_API_KEY"

respond ▸ répondre à une pause

Répondre au tour qui est devant vous.

Une réponse porte turn_seq et un objet answers indexé par les champs demandés. turn_seq est un verrou optimiste : renvoyez celui que vous avez lu. Si la mission a avancé, vous recevez 409 — rafraîchissez et répondez au tour courant au lieu d’écraser un tour plus récent.

La même chose, sur votre machine

Loopback, un token local, et le périmètre plus étroit du desktop — surveiller et notifier.

curl -X POST http://127.0.0.1:8131/v1/ai-concierge/start \
  -H "Authorization: Bearer $WRIT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"goal": "Tell me when this page changes", "url": "https://example.com/status"}'

curl http://127.0.0.1:8131/v1/ai-concierge     -H "Authorization: Bearer $WRIT_TOKEN"
curl http://127.0.0.1:8131/v1/ai-concierge/7   -H "Authorization: Bearer $WRIT_TOKEN"

curl -X POST http://127.0.0.1:8131/v1/ai-concierge/7/respond \
  -H "Authorization: Bearer $WRIT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"turn_seq": 2, "answers": {"confirm": true}}'

curl -X POST http://127.0.0.1:8131/v1/ai-concierge/7/interrupt -H "Authorization: Bearer $WRIT_TOKEN"
curl -X POST http://127.0.0.1:8131/v1/ai-concierge/7/cancel    -H "Authorization: Bearer $WRIT_TOKEN"

limites ▸ franchement

Ce que Scribe ne fera pas.

À lire avant de bâtir dessus. Aucun de ces points n’est un réglage que vous pouvez changer :

1. Elle ne passe pas la commande — Pour un achat, elle prépare le paiement jusqu’au bouton de paiement et s’arrête là. Le dernier clic est le vôtre.
2. Elle ne demande jamais de numéro de carte — Le paiement se recueille comme un choix — une carte déjà enregistrée chez le marchand, l’autoremplissage de votre propre navigateur sur votre propre machine, ou une carte virtuelle. Le modèle ne peut pas réclamer de numéro. Si vous prenez la voie avancée et en saisissez un vous-même, il est scellé dans le coffre dès son arrivée et seul un marqueur atteint le plan.
3. Elle ne peut pas inventer d’outil — Un outil par tour, dans le jeu fixe décrit sur cette page. Il n’y a pas d’action libre.
4. Elle ne tourne pas en auto-hébergé — Scribe ne fait pas partie du coordinateur auto-hébergé.
5. Scribe desktop est plus étroite — Pas de rédaction d’achat automatique, et pas de lots de moniteurs multi-sites.
6. Elle ne diffuse ni ses arguments ni ses résultats — Le raisonnement visible est l’outil choisi et une courte pensée. Rien de plus.

plan ▸ ce que ça coûte

Ce qu’il lui faut, et ce qu’elle dépense.

Scribe demande un plan incluant l’assistance IA. La dépense en tokens est décomptée et affichée dans la session elle-même — le champ tokens porte input, output et les crédits consommés jusqu’ici, pour qu’une longue mission ne soit jamais une surprise à la fin. Une mission sur votre propre machine pilote votre propre navigateur : le temps de navigateur est donc gratuit, les tokens IA restent décomptés.

référence ▸ suite

Ce que Scribe construit pour vous

faq

Questions Scribe, répondues.

fin ▸ demandez-lui

Décrivez une tâche et regardez-la s’arrêter.

La façon la plus rapide de comprendre le modèle de validation est de démarrer une mission et de lire le premier pending_request sur lequel elle s’arrête.