AI sessions.

Una sesión de IA es un agente de IA autónomo que conduce un navegador real hacia un objetivo que describes — y graba los pasos que funcionaron en un workflow reutilizable. Así una automatización descrita se vuelve determinista.

Writ se ejecuta en tus propias cuentas, con tus propias credenciales y datos, en los sitios que estás autorizado a usar.

modelo ▸ qué es

Objetivo dentro, workflow fuera.

Le das a la sesión un objetivo y una URL de entrada. Observa la página, elige acciones, verifica resultados y sigue hasta alcanzar el objetivo, tocar un límite o ser cancelada. Lo que hizo no se pierde en una transcripción: los pasos que funcionan se convierten en un workflow editable, reproducible sin IA.

Esta es la vía de creación de «describir» — Scribe sobre una sesión de IA. El resultado grabado es JSON de workflow corriente: léelo, recórtalo, regraba partes.

petición ▸ los campos

Campos de la sesión.

Una sesión se crea con:

Campo	Rol
`goal`	Qué debe lograr la sesión, en palabras sencillas.
`entry_url`	Dónde arranca el navegador.
`form_data`	Valores que la sesión puede usar — y sobre los que se parametrizará el workflow grabado.
`ai_model`	Qué modelo conduce la sesión.
`mode`	Cómo se comporta la sesión respecto a su objetivo.
`max_steps`	Tope de pasos grabados.
`max_actions`	Tope de acciones que el agente puede realizar.
`timeout_ms`	Presupuesto de tiempo global de la sesión.
`headless`	Si el navegador muestra una ventana visible.
`execution_target`	Dónde corre el navegador.
`default_persona_id`	La persona cuyo estado de sesión guardado y 2FA puede usar la sesión.
`auto_validate`	Reproducir el workflow grabado para demostrar que funciona; validation_status es pending, passed o failed.

ciclo de vida ▸ cinco estados

Estados de la sesión.

Una sesión informa uno de cinco estados:

Estado	Significado
`pending`	Creada, aún sin conducir el navegador.
`running`	El agente observa y actúa.
`completed`	Se alcanzó el objetivo; los resultados y cualquier workflow grabado están disponibles.
`failed`	La sesión terminó sin alcanzar el objetivo — el error dice por qué.
`cancelled`	Detenida a petición.

telemetría ▸ qué informa

Qué informa una sesión.

Mientras corre — y después de resolverse — una sesión expone exactamente qué hizo y qué costó:

Campo	Qué te dice
`steps_taken`	Cuántos pasos ha realizado el agente.
`workflows_generated`	Cuántos workflows grabó la sesión.
`input_tokens / output_tokens / total tokens`	Uso de tokens, desglosado por dirección.
`ai_calls_count`	Cuántas llamadas al modelo hizo la sesión.
`credits_consumed / ai_cost_usd`	Lo que la sesión consumió de tu fondo incluido, y su coste en USD.
`progress_message / current_url`	Narración en vivo: qué hace el agente y dónde está el navegador.

api ▸ la superficie

La superficie API.

Las sesiones son recursos REST corrientes:

GET    /api/automation/ai-sessions
POST   /api/automation/ai-sessions
GET    /api/automation/ai-sessions/{id}
GET    /api/automation/ai-sessions/{id}/steps
PATCH  /api/automation/ai-sessions/{id}
DELETE /api/automation/ai-sessions/{id}
POST   /api/automation/ai-sessions/{id}/cancel
POST   /api/automation/ai-sessions/{id}/link-workflow

Ejecutar una sesión requiere el scope workflows:execute en la clave llamante. link-workflow vincula un workflow grabado a la sesión que lo produjo.

secretos ▸ el contrato

Lo que el modelo nunca ve.

Credenciales y secretos van enmascarados de extremo a extremo: el modelo solo ve marcadores [SECURE:key] en lo que lee, y emite placeholders {{secret:key}} en lo que escribe. Los valores reales se resuelven al despachar — fuera del modelo, fuera de la transcripción, fuera del workflow grabado.

assist ▸ ayudantes de un disparo

Los ayudantes de un disparo no son sesiones.

Junto a las sesiones, unos endpoints AI-assist responden a una sola petición y paran — sin bucle de navegador, sin workflow grabado:

Ayudante	Qué hace
`chat`	Una pregunta, una respuesta, en el contexto del producto.
`generate-extract`	Bosquejar un paso extract para una página.
`build-scraper`	Bosquejar un workflow de extracción a partir de una descripción.
`optimize-workflow`	Proponer una versión más robusta de un workflow existente — como vista previa, nunca una reescritura silenciosa.
`find-selectors`	Proponer selectores estables para un elemento.
`generate-automation`	Bosquejar una automatización trigger/acción a partir de una descripción.
`generate-streaming-script`	Escribir el script avanzado de una sesión de streaming.

Si necesitas el bucle de navegador — observar, actuar, verificar, grabar — eso es una sesión. Si necesitas un solo artefacto generado, eso es un ayudante. Las sesiones de streaming tienen su propia referencia: streaming.

facturación ▸ por token, plana

Cómo se factura la IA.

La IA se factura plana y sin distinción de modelo: $3,20 por millón de tokens, sea cual sea el modelo — y sin tarifa por llamada. Las sesiones consumen primero del fondo de créditos incluido de tu plan.

La asignación de tokens de IA de tu plan es telemetría — una referencia de uso, no una banda gratuita aparte. Lo que una sesión consumió de verdad siempre es visible en la propia sesión; consulta facturación y uso.

siguiente ▸ a dónde ir

Sigue adelante.

Workflows — qué es el resultado grabado y cómo corre sin IA.
Streaming — mantén abierto un navegador respaldado por una sesión y condúcelo desde tu propio cliente.
Facturación y uso — el fondo de créditos del que consumen las sesiones.