Documentation sur Oracle Cloud Infrastructure

Outils d'API de réponses

OCI Generative AI prend en charge les outils avec l'API Responses, ce qui permet aux modèles pris en charge d'utiliser des outils intégrés lors de la génération de réponse. Ajoutez des définitions d'outil dans la propriété tools d'une demande d'API Responses 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 les outils exposés par un serveur MCP distant.

La prise en charge des outils est disponible uniquement au moyen de l'API. Selon la demande, le modèle peut décider d'utiliser ou non 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'un magasin de vecteurs lors de la génération de la réponse. Cela est utile lorsque vous souhaitez que le modèle réponde en utilisant vos documents au lieu de vous fier uniquement aux 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 bac à sable géré par OCI. Ceci est utile pour les calculs, l'analyse de données, le traitement de fichiers et d'autres tâches de calcul.

  • Appel de fonction

    Utilisez l'appel de fonction lorsque votre application définit et exécute la logique de l'outil. Le modèle retourne 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 flux de travail puisse continuer.

  • Appel MCP

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