Codex avec Azure OpenAI dans les modèles de Microsoft Foundry

L’interface CLI du Codex d’OpenAI est le même agent de codage que celui qui alimente le Codex de ChatGPT. Vous pouvez exécuter entièrement cet agent de codage sur Azure infrastructure, tout en conservant vos données à l’intérieur de votre limite de conformité avec les avantages supplémentaires de la sécurité de niveau entreprise, de la mise en réseau privée, du contrôle d’accès en fonction du rôle et de la gestion prévisible des coûts. Le Codex est plus qu'une conversation avec votre agent de code : il s'agit d'un agent de codage asynchrone qui peut être déclenché à partir de votre terminal, VS Code ou d'un exécuteur de GitHub Actions. Codex vous permet d’ouvrir automatiquement des pull requests, de refactoriser des fichiers et d’écrire des tests avec les informations d’identification de votre projet Foundry et des déploiements Azure OpenAI.

Conditions préalables

• Un abonnement Azure - Create one gratuitement
• Autorisations de contributeur dans Microsoft Foundry.
• homebrew (macOS) ou Node.js avec npm pour installer l’interface CLI du Codex. Consultez Téléchargement et installation de Node.js et npm.
• Pour Windows, installez et configurez WSL2. Consultez Installer WSL.

Déployer un modèle dans Foundry

1. Accédez à Foundry et créez un projet.
2. Dans le catalogue de modèles, sélectionnez un modèle de raisonnement tel que gpt-5.3-codex, , gpt-5.2-codexgpt-5.1-codex-maxgpt-5.1-codex, gpt-5.1-codex-mini, gpt-5-codex, , gpt-5gpt-5-miniou .gpt-5-nano
3. Pour déployer le modèle à partir du catalogue de modèles, sélectionnez Utilisez ce modèle ou si vous utilisez le volet Azure OpenAI Deployments sélectionnez déployer le modèle.
4. Copiez l’URL du point de terminaison et la clé API.

Installer l’interface CLI du Codex

À partir du terminal, exécutez les commandes suivantes pour installer l’interface CLI du Codex

npm install -g @openai/codex
codex --version # verify installation

brew install --cask codex
codex --version # verify installation

Créer et configurer config.toml

1. Pour utiliser l’interface CLI du Codex avec Azure, vous devez créer et configurer un fichier config.toml.

   Le fichier config.toml doit être stocké dans le ~/.codex répertoire. Créez un config.toml fichier dans ce répertoire ou modifiez le fichier existant s’il existe déjà :

   cd ~/.codex
   nano config.toml
   

2. Copiez le texte ci-dessous pour utiliser l’API Réponses v1. Avec l’API v1 , vous n’avez plus besoin de passer api-version, mais vous devez inclure /v1 dans le chemin d’accès base_url . Vous ne pouvez pas passer votre clé API en tant que chaîne directement à env_key. env_key doit pointer vers une variable d’environnement. Mettez à jour le nom de votre ressource base_url :

   model = "gpt-5-codex"  # Replace with your actual Azure model deployment name
   model_provider = "azure"
   model_reasoning_effort = "medium"
   
   [model_providers.azure]
   name = "Azure OpenAI"
   base_url = "https://YOUR_RESOURCE_NAME.openai.azure.com/openai/v1"
   env_key = "AZURE_OPENAI_API_KEY"
   wire_api = "responses"
   

3. Une fois que vous avez enregistré les mises à jour de votre config.toml fichier, revenez au terminal et créez une instance de la variable d’environnement référencée dans votre fichier de configuration.

   # Linux, macOS, or WSL 
   export AZURE_OPENAI_API_KEY="<your-api-key>"
   

4. Exécutez maintenant l’une des commandes suivantes dans le terminal pour tester si la configuration de l’interface CLI de Codex a réussi :

   Commande	Objectif
   Codex	Lancer l’interface utilisateur de terminal interactif (TUI)
   Codex « Invite de démarrage »	Lancer TUI avec une invite initiale
   codex exec « Invite initiale »	Lancer TUI en mode « automation » non interactif

Utiliser le codex dans Visual Studio Code

Vous pouvez également utiliser le Codex directement à l’intérieur Visual Studio Code lors de l’utilisation de l’extension OpenAI Codex

1. Si vous n'avez pas encore Visual Studio Code, vous pouvez l'installer pour macOS et Linux.

2. Installez l’extension OpenAI Codex. L’extension s’appuie sur votre config.toml fichier configuré pour l’interface CLI du Codex.

3. Si vous êtes dans une nouvelle session de terminal, configurez la variable d’environnement pour AZURE_OPENAI_API_KEY:

   export OPENAI_API_KEY="<your-azure-api-key-here>"
   

   Note

   Si vous utilisez WSL, définissez également la même variable d’environnement sur l’hôte Windows afin que l’extension puisse la lire si nécessaire.

4. Lancez VS Code à partir de la même session terminale. (Le lancement à partir d’un lanceur d’applications peut entraîner que votre variable d’environnement de clé API n’est pas disponible pour l’extension Codex.)

   code .
   

5. Vous serez maintenant en mesure d'utiliser Le Codex dans Visual Studio Code pour discuter, modifier et afficher un aperçu des modifications tout en basculant entre trois modes d'approbation.

Modes d’approbation

Les modes d’approbation déterminent la quantité d’autonomie et d’interaction que vous souhaitez avoir avec le Codex.

Conseils persistants avec AGENTS.md

Vous pouvez donner des instructions et des conseils supplémentaires au Codex à l’aide de AGENTS.md fichiers. Codex recherche AGENTS.md des fichiers dans les emplacements suivants et les fusionne de haut en bas, en lui fournissant un contexte sur vos préférences personnelles, les détails spécifiques au projet et la tâche actuelle :

• ~/.codex/AGENTS.md– conseils globaux personnels.
• AGENTS.md à la racine de votre référentiel : notes de projet partagées.
• AGENTS.md dans le répertoire de travail actuel : sous-dossier/caractéristiques spécifiques.

Par exemple, pour aider Codex à comprendre comment écrire du code pour les agents Foundry, vous pouvez créer un AGENTS.md dans la racine de votre projet avec le contenu suivant, dérivé de la documentation du SDK Azure AI Agents :

# Instructions for working with Foundry Agents

You are an expert in the Azure AI Agents client library for Python.

## Key Concepts

- **Client Initialization**: Always start by creating an `AIProjectClient` or `AgentsClient`. The recommended way is via `AIProjectClient`.
- **Authentication**: Use `DefaultAzureCredential` from `azure.identity`.
- **Agent Creation**: Use `agents_client.create_agent()`. Key parameters are `model`, `name`, and `instructions`.
- **Tools**: Agents use tools to perform actions like file search, code interpretation, or function calls.
  - To use tools, they must be passed to `create_agent` via the `tools` and `tool_resources` parameters or a `toolset`.
  - Example: `file_search_tool = FileSearchTool(vector_store_ids=[...])`
  - Example: `code_interpreter = CodeInterpreterTool(file_ids=[...])`
  - Example: `functions = FunctionTool(user_functions)`

## Example: Creating a basic agent

\`\`\`python
import os
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# 1. Create Project Client
project_client = AIProjectClient(
    endpoint=os.environ["PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

# 2. Get Agents Client
with project_client:
    agents_client = project_client.agents

    # 3. Create Agent
    agent = agents_client.create_agent(
        model=os.environ["MODEL_DEPLOYMENT_NAME"],
        name="my-helpful-agent",
        instructions="You are a helpful agent that can answer questions.",
    )
    print(f"Created agent with ID: {agent.id}")
\`\`\`

Dans l’exemple précédent, les backticks du bloc de code Python sont échappés pour un rendu approprié. Les \'s peuvent être supprimés.

Expérience avec l’interface CLI du Codex

Lancez le codex avec l’invite initiale suivante :

codex "write a python script to create an Azure AI Agent with file search capabilities"

Autres tests suggérés :

# generate a unit test for src/utils/date.ts

# refactor this agent to use the Code Interpreter tool instead

Codex en GitHub Actions

Le Codex peut s’exécuter dans le cadre de votre pipeline d’intégration continue (CI). Stockez votre clé API dans le magasin de secrets du référentiel et AZURE_OPENAI_KEY, ajoutez une tâche similaire à celle-ci pour mettre à jour automatiquement votre journal des modifications avant une publication :

jobs:
  update_changelog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Update changelog via Codex
        run: |
          npm install -g @openai/codex
          export AZURE_OPENAI_API_KEY="${{ secrets.AZURE_OPENAI_KEY }}" 
          codex -p azure exec --full-auto "update CHANGELOG for next release"

Dépannage