Architecture

OpenAI exécute le harnais de l’agent. Votre application lui envoie des tâches et reçoit les résultats. Ajoutez un environnement lorsque l’agent a besoin de ressources de calcul ou de fichiers.

Les composants

• Harnais : L’instance de Codex hébergée par OpenAI qui exécute la boucle d’appels au modèle et aux outils et maintient la session de l’agent.
• Environnement : L’endroit où l’agent lance des commandes, exécute du code et manipule des fichiers. Un environnement peut être un bac à sable distant, votre ordinateur portable, un conteneur Docker ou une fonction AWS Lambda.
• Serveur d’application : Votre code qui relie l’agent à votre produit. Il soumet des tâches, reçoit des événements et gère les outils de fonction. Lorsque vous fournissez l’environnement, votre code gère également son cycle de vie.

Commencez par les composants nécessaires à votre tâche. Le harnais peut fonctionner sans environnement, et votre application peut recevoir des informations sur la progression par diffusion en continu ou par webhooks.

Commencez sans environnement

Un agent qui répond à des questions ou utilise des outils pour accéder à des services externes n’a pas nécessairement besoin de ses propres ressources de calcul ou fichiers. Définissez environment.type sur none. Cet extrait présente le paramètre d’environnement. La création d’une session nécessite également un agent et des données d’entrée initiales :

12345{
  "environment": {
    "type": "none"
  }
}

Votre application envoie des données d’entrée à une session. Le harnais appelle le modèle, utilise les outils configurés et renvoie les résultats. OpenAI conserve la session pour les tâches ultérieures.

Le harnais peut appeler directement des outils MCP distants. Pour les outils de fonction, votre code reçoit chaque appel, exécute la fonction et renvoie son résultat.

Sans environnement, les outils intégrés Bash et apply-patch, les fichiers de l’espace de travail et les MCP de l’exécuteur ne sont pas disponibles.

L’environnement d’exécution virtuel facultatif illustré ici fournit des fichiers et des commandes shell par l’intermédiaire des outils de fonction de votre application.

Ajoutez un environnement hébergé par OpenAI

Lorsque l’agent doit exécuter des scripts, modifier des fichiers ou créer des artefacts, définissez environment.type sur openai_hosted. OpenAI crée et gère un bac à sable pour la session.

Vous configurez les paquets, les fichiers et l’accès réseau dont l’agent a besoin. Le harnais exécute les commandes directement dans le bac à sable. Votre application continue d’envoyer des tâches, de recevoir des événements et de gérer les éventuels outils de fonction.

La flèche en pointillés ne s’applique que lorsque vous gérez vous-même l’environnement, comme décrit ci-dessous.

Consultez Environnements hébergés par OpenAI pour connaître les options de configuration.

Connectez votre propre environnement

Utilisez environment.type: "self_hosted" lorsque l’agent a besoin de votre infrastructure, de votre réseau privé ou de logiciels personnalisés.

Votre code démarre l’environnement et connecte un exécuteur à la session. L’exécuteur lance les commandes et les outils demandés par le harnais. Votre application gère la connexion et le cycle de vie sans relayer chaque commande.

Vous êtes responsable du provisionnement, de la reconnexion, de l’arrêt et des fichiers à conserver. Votre serveur d’application ou un gestionnaire de webhooks peut prendre en charge ces opérations.

Avant d’arrêter les ressources de calcul, coordonnez les tâches entrantes et confirmez qu’aucune exécution n’est en attente.

Consultez Connectez un bac à sable et Cycle de vie du bac à sable pour connaître les exigences de configuration et d’arrêt.

Recevez les informations de progression et les résultats

Quel que soit votre choix d’environnement, vous pouvez utiliser l’un de ces deux mécanismes ou les deux :

• Diffusion en continu : Recevez des événements détaillés à mesure que l’agent travaille, par exemple des données de sortie à afficher dans votre produit.
• Webhooks : Recevez les changements d’état de la session sans maintenir un flux ouvert. Votre gestionnaire peut récupérer les résultats, exécuter des outils de fonction ou gérer un environnement autohébergé.

Les outils de fonction nécessitent un gestionnaire qui reçoit les appels et renvoie les résultats. Si ce gestionnaire est indisponible, l’agent peut rester en attente d’un résultat. Des défaillances dans vos gestionnaires d’événements ou de cycle de vie peuvent également interrompre les mises à jour de progression ou la gestion de l’environnement.

Consultez Événements de session et Webhooks pour en savoir plus sur l’intégration.