Gemini Built‑in tools

Gemini Built‑in tools is a component that lets you tap into Google’s Gemini AI model to perform quick web searches or execute code snippets directly from your dashboard. It’s a handy way to get up‑to‑date information or run small scripts without leaving the Nappai interface.

¿Cómo funciona?

El componente se conecta al modelo Gemini de Google, que ya incluye herramientas pre‑configuradas. Cuando lo configuras, el modelo puede usar dos funciones especiales:

1. google_search – realiza una búsqueda en la web y devuelve los resultados relevantes.
2. code_execution – ejecuta fragmentos de código en un entorno seguro y devuelve la salida.

Para que el componente funcione, necesitas una clave válida de la API de Google Generative AI y debes asegurarte de que el modelo Gemini que elijas tenga habilitadas las herramientas incorporadas. Una vez configurado, simplemente introduces la pregunta o el código, seleccionas la herramienta y el componente devuelve los datos o la salida del código.

Entradas

• GenAI Language Model: El modelo de IA que se usará para las herramientas incorporadas. Debe ser un modelo GenAI compatible con Gemini.
• Input or instruction: El texto que quieres que el modelo procese, ya sea una pregunta para buscar en Google o un fragmento de código para ejecutar.
• Built‑in tool: La herramienta que deseas usar. Puedes elegir entre google_search y code_execution.

Salidas

• Data: Resultado de la búsqueda o cualquier dato devuelto por el modelo. Se obtiene mediante el método run_model.
• Tool: Información sobre la herramienta que se ejecutó, incluida la salida del código. Se genera con el método build_tool.

Ejemplo de Uso

Búsqueda en Google

1. GenAI Language Model: Gemini Pro
2. Input or instruction: “What are the new features in Python 3.10?”
3. Built‑in tool: google_search

El componente devuelve una lista de resultados relevantes en el campo Data.

Ejecución de Código

1. GenAI Language Model: Gemini Pro
2. Input or instruction: print("Hello, Nappai!")
3. Built‑in tool: code_execution

El componente devuelve la salida del código en el campo Tool.

Consejos y Mejores Prácticas

• Usa preguntas claras y específicas cuando busques en Google.
• Revisa siempre el código antes de enviarlo a la herramienta de ejecución.
• Mantén tu clave de API segura y no la compartas públicamente.
• Prueba el componente en un entorno de desarrollo antes de usarlo en producción.
• Si notas comportamientos inesperados, reporta el problema al equipo de soporte.

Consideraciones de Seguridad

El uso de la herramienta code_execution implica riesgos inherentes. Solo ejecuta código que provenga de fuentes confiables y revisa la salida antes de confiar en ella. Además, protege tu clave de API y limita el acceso a usuarios autorizados para evitar abusos.