Documentation Oracle Cloud Infrastructure

Outils d'API de réponses

OCI Generative AI prend en charge les outils avec l'API Responses, permettant aux modèles pris en charge d'utiliser des outils intégrés lors de la génération de réponses. Ajoutez des définitions d'outil dans la propriété tools d'une demande d'API de réponses afin que le modèle puisse extraire le contenu pertinent des données, exécuter du code Python, appeler des fonctions définies par l'application ou utiliser des outils exposés par un serveur MCP distant.

La prise en charge des outils n'est disponible que via l'API. En fonction de la demande, le modèle peut décider d'utiliser l'un des outils configurés. Si nécessaire, vous pouvez également guider le comportement de l'outil avec la propriété tool_choice.
Par exemple, la demande suivante ajoute un outil dans la propriété tools :
response = client.responses.create(
    model="openai.gpt-oss-120b",
    tools=[
        {
            "type": "file_search",
            "vector_store_ids": ["<vector_store_id>"]
        }
    ],
    input="Summarize the main ideas in these documents."
)
  • Recherche de fichier

    Utilisez la recherche de fichier pour permettre au modèle d'extraire le contenu pertinent d'une banque de vecteurs lors de la génération de la réponse. Cela est utile lorsque vous voulez que le modèle réponde en utilisant vos documents au lieu de s'appuyer uniquement sur les connaissances intégrées.

  • Interpréteur de code

    Utilisez l'interpréteur de code pour laisser le modèle écrire et exécuter du code Python dans un modèle d'environnement restreint géré par OCI. Cela est utile pour les calculs, l'analyse des données, le traitement des fichiers et d'autres tâches volumineuses.

  • Appel de fonction

    Utilisez l'appel de fonction lorsque votre application définit et exécute la logique de l'outil. Le modèle renvoie le nom et les arguments de la fonction, l'application exécute la fonction, puis l'application renvoie la sortie de la fonction afin que le workflow puisse continuer.

  • Appel MCP

    Utilisez l'appel MCP pour autoriser les outils d'appel OCI Generative AI hébergés sur un serveur MCP distant directement pendant la demande. Cela réduit l'orchestration côté client car la plate-forme communique avec le serveur MCP sans nécessiter d'aller-retour d'application supplémentaire.