Google Custom Search Tool

El Google Custom Search Tool permite a los usuarios de Nappai buscar información en la web de forma rápida y sencilla. Con una sola configuración, puedes obtener los fragmentos más relevantes de los resultados de Google y utilizarlos directamente en tus flujos de trabajo o en la interacción con modelos de IA.

¿Cómo funciona?

El componente se conecta a la API de Google Custom Search (CSE). Cuando lo activas, Nappai envía una solicitud a Google con tu clave de API y el ID del motor de búsqueda que hayas configurado. Google devuelve una lista de resultados que el componente transforma en objetos Data con el texto del fragmento (snippet). Además, el componente expone un Tool que puede ser usado por los modelos de lenguaje para realizar búsquedas dinámicas durante la conversación.

Entradas

Antes de usar el componente, asegúrate de haber configurado una credencial Google Search API en la sección de credenciales de Nappai y seleccionarla en el campo Credential del componente.

Campos de Entrada

• Input: Escribe la consulta que quieres enviar a Google. Puedes usar texto libre o variables de flujo.
• Number of Results: Indica cuántos resultados quieres recibir (por defecto 10). Un número mayor puede tardar más tiempo y consumir más cuota de la API.
• Start Index: Define el índice inicial de los resultados (por defecto 1). Útil si quieres paginar los resultados.

Salidas

• Data: Una lista de objetos Data que contienen el fragmento de cada resultado. Puedes usar estos datos en tablas, gráficos o como entrada para otros componentes.
• Tool: Un objeto Tool que permite a los modelos de IA ejecutar búsquedas en tiempo real dentro de la conversación.

Ejemplo de Uso

1. Configura la credencial: Ve a Credenciales → Agregar credencial → Google Search API y añade tu API Key y Engine ID.
2. Añade el componente al flujo y selecciona la credencial creada.
3. Define la entrada:
   • Input: Nappai automation best practices
   • Number of Results: 5
   • Start Index: 1
4. Ejecuta el flujo. El componente devolverá los 5 fragmentos más relevantes de Google, que puedes mostrar en un panel de resultados o pasar a otro componente para análisis adicional.

Componentes Relacionados

• Google Custom Search Tool – El mismo componente, útil para búsquedas básicas.
• Google Custom Search Tool (Tool) – Versión que se integra directamente con modelos de lenguaje.

Consejos y Mejores Prácticas

• Limita el número de resultados para evitar exceder la cuota de la API y mantener tiempos de respuesta rápidos.
• Usa consultas claras y específicas; cuanto más precisa sea la búsqueda, más relevantes serán los fragmentos.
• Revisa la política de uso de la API de Google para asegurarte de cumplir con los límites de llamadas y los términos de servicio.
• Almacena la credencial de forma segura: Nappai protege las claves, pero evita compartirlas en el flujo de trabajo.

Consideraciones de Seguridad

• La clave de API y el ID del motor de búsqueda se guardan como credenciales en Nappai; no se exponen en el flujo de trabajo.
• Evita exponer los resultados de búsqueda en logs públicos o en interfaces accesibles a usuarios no autorizados.
• Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial o crea una credencial compartida con los permisos adecuados.