Documentation
Contrôles et événements OpenHands
Bientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.
Authentification et chemin
Préfixe : /v1/customer/tenants/{tenantId}/sandboxes/{sandboxId}. Les requêtes utiliseront un jeton d’accès bearer ou une clé API de l’espace de travail. Les droits de bac à sable et de dépôt indiqués sont des permissions, pas des scopes hérités. Une clé all:all fonctionnera aussi, dans les limites des permissions actuelles de son créateur. Le relais SSH utilise son ticket plutôt qu’un jeton bearer.
Contrôles POST
POST /agent/tasks/steer exigera task_id (UUID) et une consigne non vide d’au plus 8192 octets UTF-8. POST /agent/tasks/pause et POST /agent/tasks/resume exigeront task_id et aucune consigne. Les trois routes exigeront sandboxes:write, ai_chat:use et le propriétaire de la tâche. Une réponse 202 retournera l’objet tâche (id, session_id, stream_id, status). La pause attendra l’appel de modèle en cours. Suivez les événements pour connaître le résultat mis en file. Ne répétez jamais automatiquement un suivi.
GET /agent/tasks/output
Cette route exigera sandboxes:write et le paramètre task_id (UUID). Le paramètre after sera un entier facultatif de 0 ou plus, 0 par défaut. Une réponse 200 en application/x-ndjson retournera les blocs exec stdout et stderr conservés avec seq et data en base64, puis un événement exit. Le stdout décodé contiendra du NDJSON task_event, task_status ou task_error. Les événements de plus de 16 Kio deviendront des avis. Limites prévues : 512 Kio de sortie par tâche. Les lecteurs se renouvelleront après 110 secondes. Reprenez avec le dernier numéro de séquence. La déconnexion n’annulera pas le travail. Un task_id qui ne correspond pas à la tâche actuelle retournera 409 sandbox_agent_session_changed.
Refus et disponibilité
Tant que la fonction sera désactivée, steer, pause et resume retourneront 503 sandbox_agent_unavailable. Un appelant sans ai_chat:use recevra 403 permission_required. Un task_id qui ne correspondra pas à la tâche actuelle retournera 409 sandbox_agent_session_changed pour output ou DELETE. Les autres réponses seront 400, 401, 404, 409, 429 sandbox_model_limit et 503 sandboxes_unavailable. Consultez GET /agent pour la capacité des tâches. Les lectures et sorties serveur conservées resteront accessibles après la désactivation. Aucune réponse unique de désactivation ne couvrira toutes les lectures OpenHands.