Outils

Les agents peuvent utiliser des outils pour interagir avec le monde extérieur. Il peut s'agir d'API, de bases de données ou d'autres services, ce qui augmente les capacités de votre agent et étend ses fonctionnalités au-delà de sa propre base de connaissances et de son environnement fixe.

Types d'outils

Nous proposons différents types d'outils que les agents peuvent utiliser.

Type	Description
Web Search	Intégré. Rechercher sur le web des informations à jour qui ne sont pas dans la base de connaissances de l'agent.
Code Interpreter	Intégré. Exécuter du code et générer des graphiques, utile pour l'analyse de données, la visualisation ou l'exécution en environnement isolé.
Image Generation	Intégré. Générer des images à partir d'un prompt ou d'une description.
Document Library	Intégré. Rechercher dans les documents téléchargés dans vos Libraries, ce qui active le RAG pour répondre aux questions en se basant sur des informations spécifiques.
Function Calling	Outils locaux personnalisés : fonctions définies dans votre environnement qui peuvent être appelées par l'agent. L'exécution se fait localement.
Connectors	Enregistrer des serveurs MCP en tant que Connectors gérés. Les outils sont découverts automatiquement et exécutés côté serveur.

Outils intégrés

Les outils intégrés sont prêts à l'emploi. Ils peuvent être appelés à tout moment, et toute l'exécution se fait dans notre environnement interne. Ils sont également disponibles pour les utilisateurs via Conversations sans avoir à créer d'agent au préalable.

Utilisation générale

La prise en charge des outils intégrés dépend de l'API utilisée.

Avertissement

web_search, web_search_premium et code_interpreter fonctionnent avec l'API Conversations (/v1/conversations) et l'API Agents. Ils ne sont pas pris en charge dans l'API Chat Completions (/v1/chat/completions). Les outils intégrés comme image_generation sont aussi pris en charge dans l'API Chat Completions.

Pour les utiliser, spécifiez l'outil dans le paramètre tools lors de la création d'un agent ou de l'appel à l'API Conversations.

Astuce

Vous pouvez utiliser plusieurs outils en même temps !

agent = client.beta.agents.create(
    model="<model>",
    name="<name_of_the_agent>",
    description="<description>",
    instructions="<instructions_or_system_prompt>",
    tools=[<list_of_tools>]
)

agent = client.beta.agents.create(
    model="<model>",
    name="<name_of_the_agent>",
    description="<description>",
    instructions="<instructions_or_system_prompt>",
    tools=[<list_of_tools>]
)