Oracle Cloud Infrastructure (OCI)

Ce guide reprend l’exemple Python fourni par Oracle pour la version bêta et utilise le provisionnement géré par l’application. Votre application crée et supprime à la fois la session de l’API Agents et le bac à sable OCI.

Consultez l’exemple de provisionnement géré par l’application dans l’OpenAI Cookbook.

Consultez la page Cycle de vie du bac à sable pour comprendre les modes de provisionnement et le fonctionnement de la connexion.

Avant de commencer

Créez un projet OCI Generative AI dans lequel les bacs à sable sont activés. Autorisez votre identité OCI à gérer les projets et les bacs à sable dans le compartiment du projet. Remplacez les valeurs entre chevrons dans les stratégies IAM suivantes :

allow group <group-name> to manage generative-ai-sandbox in compartment <compartment-name>
allow group <group-name> to manage generative-ai-project in compartment <compartment-name>

Utilisez un environnement d’exécution de bac à sable qui inclut Node.js et npm. L’exemple d’Oracle demande python-3.11 par défaut. Si cet environnement n’inclut pas npm, choisissez un environnement d’exécution personnalisé compatible.

Si votre projet restreint le trafic sortant, autorisez les connexions HTTPS à registry.npmjs.org pour installer Codex, les connexions HTTPS à api.openai.com et les connexions WebSocket sécurisées à codex-cloud-environments.chatgpt.com. Consultez la section sur l’accès réseau de l’exécuteur.

1. Installez la CLI OCI et la version bêta du SDK

Créez un environnement virtuel et installez la CLI OCI :

123uv venv --python 3.14
source .venv/bin/activate
uv pip install --upgrade oci-cli

Installez ensuite la version bêta du SDK Python fournie par Oracle lors de votre intégration :

uv pip install "/path/to/oci-<beta-version>-py3-none-any.whl"

Installez la version bêta du SDK après la CLI. Si vous installez ou mettez à jour oci-cli par la suite, le paquet oci de PyPI risque de remplacer la version bêta du SDK. Dans ce cas, réinstallez le fichier wheel de la version bêta. Cette version du SDK doit inclure oci.generative_ai_sandbox.

2. Configurez l’environnement OCI

Authentifiez un profil à l’aide d’un jeton de sécurité dans la région activée pour votre compte :

oci session authenticate --profile-name Sandbox --region us-chicago-1

Définissez l’OCID du projet et les identifiants OpenAI sans les enregistrer dans le dépôt :

123export OCI_SANDBOX_PROJECT_ID="ocid1.generativeaiproject..."
export OPENAI_API_KEY="..."
export OPENAI_EXECUTOR_API_KEY="..."

Utilisez OPENAI_API_KEY pour les requêtes de l’application. Définissez OPENAI_EXECUTOR_API_KEY sur la valeur d’une clé d’environnement et transmettez uniquement cette clé au bac à sable via CODEX_API_KEY.

L’exemple d’Oracle lit le profil Sandbox et utilise la région us-chicago-1. Pour modifier ces valeurs par défaut, définissez les variables suivantes :

export OCI_SANDBOX_PROFILE="my-profile"
export OCI_SANDBOX_REGION="us-chicago-1"

L’exemple accepte également les paramètres facultatifs suivants :

Pour configurer votre propre application, utilisez le jeton de sécurité et la clé privée du profil avec oci.auth.signers.SecurityTokenSigner. Créez un client de bac à sable avec la classe GenerativeAiSandboxClient du module oci.generative_ai_sandbox, en précisant la région et le point de terminaison choisis.

3. Exécutez une session gérée par l’application

Consultez le guide de connexion à un environnement auto-hébergé pour obtenir les requêtes à envoyer à l’API Agents et la commande de démarrage de l’exécuteur. Suivez les mêmes étapes que dans l’exemple d’Oracle :

1. Créez une session auto-hébergée de l’API Agents avec /workspace comme répertoire de travail. Conservez l’identifiant de la session et celui de l’environnement.
2. Créez un bac à sable OCI GenAI et attendez qu’il passe à l’état RUNNING.
3. Installez Codex et écrivez le fichier /workspace/brief.txt dans le bac à sable.
4. Lancez codex exec-server avec l’identifiant d’environnement de la session et la clé d’environnement.
5. Ouvrez le flux d’événements de la session, puis envoyez une instruction demandant à l’agent de transformer brief.txt en plan de migration. Attendez que l’agent termine, puis lisez le fichier /workspace/plan.md qu’il a généré.
6. Arrêtez et supprimez le bac à sable OCI, puis supprimez la session de l’API Agents. Tentez de supprimer les deux ressources même si l’une des opérations échoue.

Gardez les deux ressources actives pour poursuivre les échanges avec l’agent et récupérez les fichiers avant de supprimer le bac à sable. Utilisez la version bêta du SDK indiquée par Oracle, car les noms des API de bac à sable peuvent changer d’une préversion à l’autre.

Références

• Consultez la documentation d’OCI Generative AI
• Consultez la documentation du SDK OCI pour Python
• Consultez la documentation du SDK OCI pour TypeScript
• Consultez la documentation sur l’authentification avec la CLI OCI