Describe la tarea. Scribe conduce.

Scribe es la IA de Writ. Dices en lenguaje llano lo que quieres; abre un navegador real, encuentra la página, valida un selector en ella, y construye el monitor, el workflow o el crawl. Trabaja por turnos, y se detiene antes de cualquier cosa que te cueste dinero o toque tus cuentas.

aprobación ▸ se detiene

Se detiene y pregunta. Ese es el diseño.

Una misión avanza por turnos. Cuando necesita algo de ti, se detiene: la sesión pasa a awaiting_input y lleva un pending_request que describe qué espera. Hay tres formas de pausa:

capacidades ▸ una herramienta por turno

Qué le puedes pedir.

Scribe elige exactamente una herramienta por turno, de un juego fijo. No puede inventarse una herramienta, así que la lista de abajo es todo lo que una misión puede hacer:

sitios ▸ dos, no uno

Scribe cloud y Scribe de escritorio no son lo mismo.

Hay dos implementaciones, y se diferencian en lo que tienen permitido construir. Lee la fila que corresponde a dónde ejecutas antes de planear una misión sobre ella.

En el agente de escritorio

La misma forma, en loopback, contra el agente que corre en tu propia máquina — y gratis, porque el navegador es tuyo:

sesión ▸ qué consultas

La misión corre en segundo plano. Tú la consultas.

El arranque responde al instante con un id de sesión y una URL de consulta — una misión de navegación sobrevive a una petición HTTP, así que un handle es la respuesta honesta. Cada consulta devuelve la misma proyección:

Arrancar, consultar, responder

Una misión de principio a fin, en HTTP puro.

# 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 ▸ responder a una pausa

Responder al turno que tienes delante.

Una respuesta lleva turn_seq y un objeto answers indexado por los campos que pidió la pausa. turn_seq es un bloqueo optimista: devuelve el que leíste. Si la misión avanzó, recibes 409 — refresca y responde al turno actual en vez de pisar uno más nuevo.

Lo mismo, en tu propia máquina

Loopback, un token local, y el alcance más estrecho del escritorio — vigilar y avisar.

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"

límites ▸ sin rodeos

Qué no hará Scribe.

Conviene leerlo antes de planear sobre ello. Ninguno de estos puntos es un ajuste que puedas cambiar:

1. No hace el pedido — Para una compra, deja el pago preparado hasta el botón de pagar y ahí se detiene. El último clic es tuyo.
2. Nunca pide un número de tarjeta — El pago se recoge como una elección — una tarjeta ya guardada en el comercio, el autorrelleno de tu propio navegador en tu propia máquina, o una tarjeta virtual. El modelo no puede pedir un número. Si tomas la vía avanzada e introduces uno tú mismo, se sella en la bóveda según llega y solo un marcador alcanza el plan.
3. No puede inventarse una herramienta — Una herramienta por turno, del juego fijo de esta página. No hay acción libre.
4. No corre autoalojada — Scribe no forma parte del coordinador autoalojado.
5. Scribe de escritorio es más estrecha — Sin redacción de compra automática, y sin lotes de monitors multisitio.
6. No emite sus argumentos ni sus resultados — El razonamiento visible es la herramienta elegida y un pensamiento breve. Nada más.

plan ▸ qué cuesta

Qué necesita, y qué gasta.

Scribe necesita un plan que incluya asistencia de IA. El gasto en tokens se mide y se muestra dentro de la propia sesión — el campo tokens lleva input, output y los créditos consumidos hasta ahora, así que una misión larga nunca es una sorpresa al final. Una misión en tu propia máquina conduce tu propio navegador, así que el tiempo de navegador es gratis; los tokens de IA se siguen midiendo.

referencia ▸ siguiente

Lo que Scribe te construye

faq

Preguntas de Scribe, respondidas.

fin ▸ pídeselo

Describe una tarea y mírala detenerse.

La forma más rápida de entender el modelo de aprobación es arrancar una misión y leer el primer pending_request en el que se detiene.