Aller au contenu principal

Agent Builder : créer sans code

Agent Builder : créer un agent sans code

Avant de plonger dans le SDK, découvrons l’Agent Builder, l’interface no-code d’OpenAI sur platform.openai.com. C’est l’outil idéal pour prototyper un agent rapidement, tester des instructions, et valider un concept avant d’écrire du code.

Accéder à l’Agent Builder

Rendez-vous sur platform.openai.com et naviguez vers la section Agents. L’interface vous permet de configurer un agent complet visuellement :

  • Nom et instructions : définissez le comportement de votre agent
  • Modèle : choisissez entre GPT-5.3, GPT-5.4, o3-pro, o4-mini
  • Tools : activez web search, file search, code interpreter, ou ajoutez des fonctions
  • Guardrails : configurez des règles de sécurité

Configurer les instructions

Les instructions sont le coeur de votre agent. Elles définissent son rôle, ses limites, et son ton. Voici un exemple d’instructions pour un agent de support technique :

Vous êtes un agent de support technique pour une entreprise SaaS.

Règles :
- Répondez toujours en français
- Commencez par identifier le problème avant de proposer des solutions
- Si le problème nécessite une escalade, indiquez-le clairement
- Ne partagez jamais d'informations confidentielles sur l'infrastructure

Outils disponibles :
- Recherche web : pour trouver de la documentation technique
- Code interpreter : pour analyser des logs ou des fichiers de configuration
- File search : pour chercher dans la base de connaissances interne

Ajouter des tools natifs

L’Agent Builder vous permet d’activer les tools intégrés d’OpenAI en un clic :

Active la recherche en temps réel sur internet. L’agent peut vérifier des faits, trouver de la documentation, ou récupérer des informations à jour.

Vous uploadez des fichiers (PDF, CSV, DOCX) et l’agent peut chercher dedans. Idéal pour une base de connaissances ou des manuels techniques.

Code Interpreter

L’agent peut écrire et exécuter du code Python dans un sandbox sécurisé. Parfait pour l’analyse de données, la génération de graphiques, ou le traitement de fichiers.

Ajouter des fonctions personnalisées

Au-delà des tools natifs, vous pouvez déclarer des fonctions que votre agent pourra appeler. Vous définissez le schéma JSON de la fonction dans l’interface :

{
  "name": "creer_ticket_support",
  "description": "Crée un ticket de support dans le système interne",
  "parameters": {
    "type": "object",
    "properties": {
      "titre": {
        "type": "string",
        "description": "Titre court du problème"
      },
      "priorite": {
        "type": "string",
        "enum": ["basse", "moyenne", "haute", "critique"],
        "description": "Niveau de priorité"
      },
      "description": {
        "type": "string",
        "description": "Description détaillée du problème"
      }
    },
    "required": ["titre", "priorite", "description"]
  }
}

Quand l’agent décide d’appeler cette fonction, il retourne les arguments structurés. C’est ensuite à votre backend de traiter l’appel.

Tester dans le playground

L’Agent Builder inclut un playground intégré. Vous pouvez tester votre agent en temps réel, observer les appels d’outils, et ajuster les instructions jusqu’à obtenir le comportement souhaité.

Voici un workflow de test efficace :

  1. Écrivez vos instructions initiales
  2. Testez avec 5 scénarios représentatifs
  3. Identifiez les cas où l’agent se trompe
  4. Affinez les instructions
  5. Retestez jusqu’à satisfaction

De l’Agent Builder au SDK

Une fois votre prototype validé dans l’Agent Builder, vous pouvez le transposer en code SDK. L’agent configuré visuellement se traduit directement :

from agents import Agent, WebSearchTool, FileSearchTool, CodeInterpreterTool

# Ce que vous avez configuré dans l'Agent Builder
# se traduit exactement en ce code :
agent = Agent(
    name="Support technique",
    instructions="""Vous êtes un agent de support technique pour une entreprise SaaS.
    Répondez en français. Identifiez le problème avant de proposer des solutions.""",
    model="gpt-5.3",
    tools=[
        WebSearchTool(),
        FileSearchTool(vector_store_ids=["vs_abc123"]),
        CodeInterpreterTool(),
    ],
)

L’Agent Builder est votre terrain de jeu. Le SDK est votre outil de production. Les deux sont complémentaires.

Points clés à retenir

  • L’Agent Builder est accessible sur platform.openai.com sans écrire de code
  • Vous pouvez configurer les instructions, le modèle, les tools et les guardrails visuellement
  • Les tools natifs (web search, file search, code interpreter) s’activent en un clic
  • Les fonctions personnalisées se déclarent avec un schéma JSON
  • Le playground permet de tester et itérer rapidement
  • Tout ce que vous configurez dans l’Agent Builder se transpose en code SDK