Saltearse al contenido

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

  1. 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.
  2. 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.