OpenAI Built-in tools
El componente OpenAI Built-in tools permite a los usuarios de Nappai aprovechar las capacidades de búsqueda web y generación de imágenes de OpenAI directamente desde el dashboard. No requiere configuración complicada y se conecta automáticamente a la API de OpenAI usando la clave que tengas configurada en tu entorno.
¿Cómo funciona?
Cuando envías una solicitud a este componente, Nappai construye una llamada a la API de OpenAI. Dependiendo de los valores que ingreses, el componente puede:
- Realizar una búsqueda web con el web_search_preview, devolviendo un resumen breve de los resultados.
- Generar una imagen a partir de una descripción textual con image_generation.
El componente no ejecuta código localmente; todo el procesamiento se delega a los modelos de OpenAI. Solo necesitas proporcionar los parámetros correctos y la clave de API que ya esté disponible en tu entorno.
Entradas
- File for Code Interpreter: El archivo que será analizado por la herramienta de interpretación de código. Se requiere únicamente cuando seleccionas la opción code_interpreter.
- OpenAI Language Model: El modelo de lenguaje de OpenAI que se usará para la cadena de procesamiento. Debe ser un modelo compatible con OpenAI.
- Assistant Instructions: Instrucciones para el asistente de interpretación de código. Se usan solo cuando se activa code_interpreter.
Ejemplo de valor por defecto:You are an expert data analyst. Write and run Python code to answer user questions based on the provided file. Return only the final answer to the user. - Input: El texto que deseas buscar en la web o usar como prompt para la generación de imágenes.
- Built-in tool: Selección de las herramientas integradas que quieres usar (por ejemplo, web_search_preview o image_generation).
- Tool Name: El nombre de la herramienta. Se requiere solo cuando el componente se usa como una herramienta externa.
Salidas
- Data: Resultado de la búsqueda web o la imagen generada, entregado como un objeto de datos que puede ser usado en otros componentes.
- Tool: Si el componente se invoca como una herramienta, devuelve un objeto que representa la herramienta para que pueda ser llamada por otros flujos.
Ejemplo de Uso
-
Búsqueda web
- Selecciona web_search_preview en Built-in tool.
- En Input escribe:
últimas noticias sobre inteligencia artificial
. - Ejecuta el componente.
- La salida Data contendrá un resumen breve de los resultados de búsqueda.
-
Generación de imagen
- Selecciona image_generation en Built-in tool.
- En Input escribe:
un paisaje futurista con luces de neón
. - Ejecuta el componente.
- La salida Data incluirá la imagen generada que puedes insertar en tu dashboard.
Consejos y Mejores Prácticas
- Usa consultas específicas para la búsqueda web y evita términos genéricos que generen muchos resultados irrelevantes.
- Si necesitas analizar datos de un archivo, activa la opción code_interpreter y provee instrucciones claras al asistente.
- Revisa los límites de tu plan de OpenAI antes de hacer múltiples llamadas en un corto período.
- Al generar imágenes, prueba con descripciones breves y precisas para obtener resultados más coherentes.
- Guarda las salidas de búsqueda e imágenes en variables de flujo para reutilizarlas en pasos posteriores.
Consideraciones de Seguridad
- Clave de API: Mantén la clave de OpenAI en variables de entorno seguras y evita incluirla en archivos de configuración que puedan ser versionados.
- Políticas de contenido: La generación de imágenes y la búsqueda web están sujetas a las políticas de uso de OpenAI. Asegúrate de que tus solicitudes cumplan con dichas políticas para evitar bloqueos o contenido inapropiado.
- Uso responsable: Evita solicitar contenido que pueda infringir derechos de autor o que sea sensible, y verifica siempre los resultados antes de mostrarlos a usuarios finales.