Saltearse al contenido
Nappai Documentation

Bing Search API

The Bing Search API component lets you send a search query to Microsoft Bing and receive a list of relevant results. It’s useful when you need up‑to‑date information from the web, such as news headlines, product details, or general knowledge, directly inside your Nappai dashboard.

¿Cómo funciona?

Internally, the component uses the BingSearchAPIWrapper from LangChain to talk to the Bing Search service.

  1. Credential – You must first create a Bing Search API credential in Nappai’s credentials section and then select it in the component’s Credential field.
  2. Query – The text you enter in the Input field is sent as a search query.
  3. Results – The wrapper calls the Bing API, retrieves the requested number of results (k), and returns each result as a Data object containing the full result and a short snippet.
  4. Tool – The component also builds a LangChain Tool that can be used by other parts of your workflow to perform the same search operation programmatically.

Entradas

Este componente necesita una credencial de Bing Search API. Configúrala en la sección de credenciales y selecciónala en el campo Credential del componente.

  • Bing Search URL: La URL del endpoint de Bing. Si la dejas vacía, se usará la URL por defecto.
  • Input: El texto que quieres buscar en Bing.
  • Number of results: La cantidad de resultados que deseas recibir (por defecto 4).

Salidas

  • Data: Una lista de objetos Data que contienen cada resultado de búsqueda y su fragmento de texto.
  • Tool: Un objeto Tool que permite usar la búsqueda de Bing dentro de flujos de LangChain.

Ejemplo de Uso

  1. Configura la credencial

    • Ve a Credenciales → Agregar → Bing Search API.
    • Introduce tu Bing Search API Key (ejemplo: <API_KEY>).
    • Guarda y cierra.

  2. Añade el componente

    • Arrastra el componente Bing Search API al canvas.
    • Selecciona la credencial que acabas de crear en el campo Credential.
    • En Input escribe: Nappai automation features.
    • En Number of results escribe 5.

  3. Ejecuta

    • Haz clic en Ejecutar y verás una lista de 5 resultados de Bing con sus títulos y fragmentos.
    • Puedes usar la salida Data para mostrar los resultados en una tabla o pasarla a otro componente que necesite esa información.

Componentes Relacionados

  • BingSearchResults – Un componente similar que devuelve los resultados como un Tool sin procesar los datos.
  • OpenAI – Puedes combinar los resultados de Bing con un modelo de IA para generar resúmenes o respuestas automáticas.
  • DataTable – Muestra los resultados de búsqueda en una tabla interactiva dentro del dashboard.

Consejos y Mejores Prácticas

  • Limita el número de resultados: Pedir demasiados resultados puede consumir tu cuota de API y ralentizar el flujo.
  • Usa la URL personalizada solo si es necesario: La URL por defecto funciona para la mayoría de los casos.
  • Maneja errores: Si la búsqueda falla, revisa tu clave API y la cuota disponible en el portal de Azure.
  • Combina con filtros: Puedes añadir filtros de idioma o región en la URL personalizada para obtener resultados más relevantes.

Consideraciones de Seguridad

  • Protege tu clave API: La credencial se almacena de forma segura en Nappai; no la expongas en el código ni en los flujos.
  • Control de acceso: Limita quién puede ver o editar la credencial en la configuración de Nappai para evitar usos no autorizados.