Documentación de Oracle Cloud Infrastructure

Herramientas de API de respuestas

OCI Generative AI soporta herramientas con la API Responses, lo que permite a los modelos soportados utilizar herramientas integradas durante la generación de respuestas. Agregue definiciones de herramientas en la propiedad tools de una solicitud de API de respuestas para que el modelo pueda recuperar contenido relevante de los datos, ejecutar código Python, llamar a funciones definidas por la aplicación o utilizar herramientas expuestas por un servidor MCP remoto.

El soporte de herramientas solo está disponible a través de la API. Según la solicitud, el modelo puede decidir si desea utilizar una de las herramientas configuradas. Cuando sea necesario, también puede guiar el comportamiento de la herramienta con la propiedad tool_choice.
Por ejemplo, la siguiente solicitud agrega una herramienta en la propiedad 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."
)
  • Búsqueda de Archivo

    Utilice la búsqueda de archivos para permitir que el modelo recupere contenido relevante de un almacén de vectores durante la generación de respuestas. Esto resulta útil cuando desea que el modelo responda mediante los documentos en lugar de depender solo de los conocimientos incorporados.

  • Intérprete de código

    Utilice Code Interpreter para permitir que el modelo escriba y ejecute código Python en un sandbox gestionado por OCI. Esto es útil para cálculos, análisis de datos, procesamiento de archivos y otras tareas de cálculo pesado.

  • Llamada de función

    Utilice Llamadas de función cuando la aplicación defina y ejecute la lógica de la herramienta. El modelo devuelve el nombre y los argumentos de la función, la aplicación ejecuta la función y, a continuación, la aplicación vuelve a enviar la salida de la función para que el flujo de trabajo pueda continuar.

  • Llamadas de MCP

    Utiliza MCP Calling para permitir que las herramientas de llamadas de OCI Generative AI alojadas en un servidor MCP remoto directamente durante la solicitud. Esto reduce la orquestación del cliente, ya que la plataforma se comunica con el servidor MCP sin necesidad de realizar un recorrido adicional de ida y vuelta por la aplicación.