OpenAI Built-in tools
OpenAI Built-in tools te da acceso a las herramientas que OpenAI trae incorporadas: buscar en internet, generar imágenes y analizar un archivo de datos. Escribes una petición, el modelo de OpenAI usa la herramienta elegida y te devuelve el resultado: una respuesta redactada con sus fuentes, una imagen o el análisis del archivo.
Puedes usarlo como paso de un flujo, con la petición en Input, o como herramienta de un agente: conectas su salida Tool al conector Tools del agente y el agente lo usa cuando necesita buscar, crear una imagen o analizar el archivo.
Cuándo usarlo
- Un agente necesita información actual de internet y quieres limitarla a ciertas webs.
- Quieres que los resultados de búsqueda tengan en cuenta un país o una ciudad concretos.
- Un flujo de marketing tiene que generar imágenes a partir de una descripción.
- Necesitas que la IA responda preguntas sobre una hoja de cálculo o un PDF, por ejemplo totales o tendencias.
Configuración
Necesitas una credencial OpenAI API con la clave de tu cuenta de OpenAI. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Built-in tool | Las herramientas que se usan: web_search (buscar en internet), web_search_preview (legacy) (la búsqueda anterior de OpenAI, sin opciones), image_generation (generar una imagen) y code_interpreter (analizar un archivo). Por defecto, web_search. Al marcar una opción aparecen sus campos propios. |
| Input | La petición, por ejemplo Últimas novedades sobre ayudas a la digitalización de pymes. Se oculta cuando conectas la salida Tool, porque entonces la petición la escribe el agente. |
| OpenAI API Key | La clave de tu cuenta de OpenAI. |
| Model | El modelo de OpenAI que responde. Por defecto, gpt-5-mini. La lista muestra los modelos de tu cuenta. |
Búsqueda web
Aparecen al marcar web_search.
| Campo | Qué hace |
|---|---|
| Search Context Size | Cuánta información de las páginas encontradas usa el modelo: low, medium o high. Más información da respuestas más completas y consume más. Por defecto, medium. |
| User Location (Country) | País para adaptar los resultados, con su código de dos letras, por ejemplo ES o MX. |
| User Location (City) | Ciudad para adaptar los resultados, por ejemplo Madrid. |
| User Location (Timezone) | Zona horaria, por ejemplo Europe/Madrid. |
| Allowed Domains | Webs a las que se limita la búsqueda, separadas por comas, por ejemplo boe.es,icac.gob.es. Vacío, se busca en todas. |
Generación de imágenes
Aparecen al marcar image_generation.
| Campo | Qué hace |
|---|---|
| Image Quality | Calidad de la imagen: auto, low, medium o high. Por defecto, auto. |
| Image Size | Tamaño: auto, 1024x1024 (cuadrada), 1024x1536 (vertical) o 1536x1024 (horizontal). Por defecto, auto. |
| Output Format | Formato del archivo: png, webp o jpeg. Por defecto, png. |
| Background | Fondo: auto, transparent o opaque. Por defecto, auto. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| File for Code Interpreter | Solo con code_interpreter. El archivo que se analiza: CSV, Excel, JSON, texto o PDF. |
| Assistant Instructions | Solo con code_interpreter. Instrucciones para el análisis. Vienen rellenas con unas que piden responder solo con la respuesta final. |
| Tool Name | El nombre con el que el agente ve la herramienta. Por defecto, openai_built_in_tool. |
Resultado
- Data: según la herramienta usada:
- Búsqueda web: la respuesta redactada, con sus citas y las fuentes consultadas.
- Generación de imágenes: el nombre y el enlace de la imagen creada, que queda guardada en los archivos de la conversación.
- Análisis de archivo: la respuesta sobre el contenido del archivo.
- Tool: las herramientas listas para un agente, una por cada opción marcada. Conéctala al conector Tools del agente.
Ejemplo
Una agencia de comunicación quiere un asistente que prepare publicaciones con imagen.
- Añade OpenAI Built-in tools y marca solo
image_generation. - En Image Size, elige
1024x1024, y en Output Format,png. - Conecta la salida Tool al conector Tools del agente.
- Cuando alguien pide “Una imagen de una taza de café sobre una mesa de madera para el post del lunes”, el agente genera la imagen y devuelve su enlace.
Buenas prácticas
- Al conectarlo a un agente, marca una sola herramienta en cada componente. Si necesitas varias, añade un componente para cada una y dales nombres distintos en Tool Name.
code_interpreterno se puede combinar con otras herramientas en el mismo componente cuando lo usas como paso del flujo.- Las imágenes y búsquedas consumen saldo de tu cuenta de OpenAI. Revisa allí el consumo.
Componentes relacionados
- Gemini Built-in tools: las herramientas integradas de Google Gemini.
- Agent: el agente al que puedes darle estas herramientas.