AI sessions.

Une session IA est un agent IA autonome qui pilote un vrai navigateur vers un objectif que vous décrivez — et enregistre les étapes qui ont fonctionné dans un workflow réutilisable. C’est ainsi qu’une automatisation décrite devient déterministe.

Writ s’exécute sur vos propres comptes, avec vos propres identifiants et données, sur les sites que vous êtes autorisé à utiliser.

modèle ▸ ce que c’est

Un objectif en entrée, un workflow en sortie.

Vous donnez à la session un objectif et une URL d’entrée. Elle observe la page, choisit des actions, vérifie les résultats, et continue jusqu’à atteindre l’objectif, toucher une limite ou être annulée. Ce qu’elle a fait ne se perd pas dans une transcription : les étapes qui fonctionnent deviennent un workflow éditable, rejouable sans IA.

C’est la voie de création « décrire » — Scribe au-dessus d’une session IA. Le résultat enregistré est du JSON de workflow ordinaire : lisez-le, élaguez-le, réenregistrez-en des parties.

requête ▸ les champs

Champs de session.

Une session se crée avec :

Champ	Rôle
`goal`	Ce que la session doit accomplir, en mots simples.
`entry_url`	Où le navigateur démarre.
`form_data`	Les valeurs que la session peut utiliser — et sur lesquelles le workflow enregistré sera paramétré.
`ai_model`	Le modèle qui pilote la session.
`mode`	Le comportement de la session vis-à-vis de son objectif.
`max_steps`	Plafond d’étapes enregistrées.
`max_actions`	Plafond d’actions que l’agent peut effectuer.
`timeout_ms`	Budget de temps global de la session.
`headless`	Si le navigateur affiche une fenêtre visible.
`execution_target`	Où le navigateur s’exécute.
`default_persona_id`	La persona dont la session peut utiliser l’état de connexion sauvegardé et le 2FA.
`auto_validate`	Rejouer le workflow enregistré pour prouver qu’il fonctionne ; validation_status vaut pending, passed ou failed.

cycle de vie ▸ cinq statuts

Statuts de session.

Une session rapporte l’un de cinq statuts :

Statut	Signification
`pending`	Créée, le navigateur n’est pas encore piloté.
`running`	L’agent observe et agit.
`completed`	L’objectif est atteint ; les résultats et tout workflow enregistré sont disponibles.
`failed`	La session s’est terminée sans atteindre l’objectif — l’erreur dit pourquoi.
`cancelled`	Arrêtée sur demande.

télémétrie ▸ ce qu’elle rapporte

Ce qu’une session rapporte.

Pendant son exécution — et après son règlement — une session expose exactement ce qu’elle a fait et ce que cela a coûté :

Champ	Ce qu’il vous dit
`steps_taken`	Combien d’étapes l’agent a effectuées.
`workflows_generated`	Combien de workflows la session a enregistrés.
`input_tokens / output_tokens / total tokens`	L’usage de tokens, ventilé par direction.
`ai_calls_count`	Combien d’appels au modèle la session a faits.
`credits_consumed / ai_cost_usd`	Ce que la session a prélevé sur votre pool inclus, et son coût en USD.
`progress_message / current_url`	La narration en direct : ce que fait l’agent, et où se trouve le navigateur.

api ▸ la surface

La surface API.

Les sessions sont des ressources REST ordinaires :

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

Exécuter une session exige le scope workflows:execute sur la clé appelante. link-workflow rattache un workflow enregistré à la session qui l’a produit.

secrets ▸ le contrat

Ce que le modèle ne voit jamais.

Identifiants et secrets sont masqués de bout en bout : le modèle ne voit jamais que des marqueurs [SECURE:key] dans ce qu’il lit, et émet des placeholders {{secret:key}} dans ce qu’il écrit. Les vraies valeurs se résolvent à l’envoi — hors du modèle, hors de la transcription, hors du workflow enregistré.

assist ▸ assistants en un coup

Les assistants en un coup ne sont pas des sessions.

À côté des sessions, des endpoints AI-assist répondent à une seule requête puis s’arrêtent — pas de boucle navigateur, pas de workflow enregistré :

Assistant	Ce qu’il fait
`chat`	Une question, une réponse, dans le contexte du produit.
`generate-extract`	Ébaucher une étape extract pour une page.
`build-scraper`	Ébaucher un workflow d’extraction à partir d’une description.
`optimize-workflow`	Proposer une version plus robuste d’un workflow existant — en aperçu, jamais une réécriture silencieuse.
`find-selectors`	Proposer des sélecteurs stables pour un élément.
`generate-automation`	Ébaucher une automatisation déclencheur/action à partir d’une description.
`generate-streaming-script`	Écrire le script avancé d’une session de streaming.

S’il vous faut la boucle navigateur — observer, agir, vérifier, enregistrer — c’est une session. S’il vous faut un seul artefact généré, c’est un assistant. Les sessions de streaming ont leur propre référence : streaming.

facturation ▸ au token, à plat

Comment l’IA est facturée.

L’IA est facturée à plat, sans distinction de modèle : 3,20 $ par million de tokens, quel que soit le modèle — et sans frais par appel. Les sessions puisent d’abord dans le pool de crédits inclus de votre plan.

L’allocation de tokens IA de votre plan est de la télémétrie — un repère d’usage, pas une bande gratuite séparée. Ce qu’une session a réellement consommé est toujours visible sur la session elle-même ; voir facturation & utilisation.

suite ▸ où aller

Continuez.

Workflows — ce qu’est le résultat enregistré, et comment il s’exécute sans IA.
Streaming — gardez un navigateur adossé à une session ouvert et pilotez-le depuis votre propre client.
Facturation & utilisation — le pool de crédits où puisent les sessions.