Integre la API SERP de Bright Data en un agente de IA en IBM watsonx.

En este tutorial, descubrirá:

• Cómo IBM Watsonx apoya el desarrollo de agentes de IA.
• Por qué la integración de la API SERP de Bright Data mejora los agentes de IBM Watsonx Orchestrate.
• Los pasos exactos para crear un agente de IA impulsado por la API SERP de Bright Data dentro de IBM Watsonx Orchestrate.

¡Empecemos!

¿Qué es la función de creación de agentes IA en IBM Watsonx?

IBM Watsonx Orchestrate, un sistema de automatización y IA generativa listo para empresas, ofrece capacidades de creación de agentes de IA. Esta solución le proporciona lo que necesita para diseñar, implementar y gestionar agentes de IA autónomos que realizan tareas, toman decisiones e interactúan con sistemas críticos para el negocio.

La creación de agentes en IBM watsonx está disponible tanto a través de una interfaz web de bajo código como de un enfoque basado en código a través de la biblioteca Python del kit de desarrollo de agentes (ADK). En este artículo, nos centraremos en la integración del flujo de trabajo de bajo código utilizando la aplicación web.

Los agentes del servicio Orchestrate pueden colaborar a través de la orquestación multiagente, conectarse a diversas herramientas externas, aprovechar RAG (Retrieval-Augmented Generation) para obtener respuestas basadas en el conocimiento y mucho más.

La plataforma también incluye funciones de gobernanza y observabilidad para garantizar el cumplimiento, la transparencia y la supervisión del rendimiento. Una vez creados, los agentes se pueden implementar en múltiples canales, como el chat web, Slack, Microsoft Teams y otros.

Por qué los agentes de IBM watsonx necesitan acceder a la API SERP de Bright Data

Los modelos de lenguaje grandes, incluidos los disponibles en IBM watsonx, están limitados por los datos con los que se han entrenado. En términos más sencillos, su conocimiento se detiene en un momento determinado.

Por eso, los LLM tienden a producir respuestas obsoletas o inexactas. Este problema se agrava aún más en el caso de los agentes de IA encargados de tomar decisiones o elaborar informes para apoyar la toma de decisiones…

La solución es dotar a su agente de herramientas que le permitan obtener y procesar datos fiables. Por ejemplo, el agente podría consultar los motores de búsqueda para recopilar información verificada y actualizada y, a continuación, aprender de esos datos para reducir las alucinaciones. El resultado sería una mayor precisión en las decisiones y una mayor confianza en que las respuestas del agente se basan en conocimientos del mundo real.

La forma más fácil de lograrlo es a través de una API SERP o una herramienta de búsqueda web, como la API SERP de Bright Data. Esta API de nivel empresarial para la recuperación de datos de motores de búsqueda se encarga de los proxies, el desbloqueo y el formateo de datos por usted. En otras palabras, no tiene que preocuparse por los retos típicos de la recopilación de datos de motores de búsqueda cuando trabaja con agentes de IA.

La API SERP de Bright Data se integra directamente con IBM watsonx Orchestrate (así como con muchas otras plataformas de creación de agentes de IA), lo que permite a sus agentes de IA acceder a los resultados de búsqueda y producir resultados más contextuales, fiables y verificables.

Desarrollo de un agente de IA con integración de la API SERP en IBM watsonx.ai: guía paso a paso

En esta sección, aprenderá a integrar la API SERP de Bright Data como herramienta dentro de un agente de IA en IBM watsonx Orchestrate.

Entre los muchos casos de uso posibles, este tutorial se centra en la creación de un agente de recomendación de contenido. Su objetivo es sugerir ideas de contenido basadas en las tendencias recientes relacionadas con un tema determinado (por ejemplo, descubrir las últimas noticias de actualidad sobre las que vale la pena escribir o hacer vídeos de YouTube con fines de marketing).

Nota: Este es solo un ejemplo, y puede adaptar la misma integración de la API SERP para impulsar muchos otros casos de uso impulsados por la IA.

Siga los pasos que se indican a continuación.

Requisitos previos

Para seguir este tutorial, asegúrese de que dispone de:

• Un IBMid para iniciar sesión en su IBM watsonx Orchestrate (una prueba gratuita es suficiente).
• Una cuenta de Bright Data con una clave API activa.

No se preocupe por configurar su cuenta de Bright Data todavía, ya que más adelante se le guiará a través de ese proceso.

También es útil estar familiarizado con el funcionamiento de la API SERP de Bright Data, cómo utilizan las herramientas los agentes de IA y los conceptos básicos de las especificaciones OpenAPI para definir herramientas.

Paso n.º 1: Crear un nuevo agente de IA de IBM watsonx

Inicie sesión en IBM watsonx Orchestrate con su cuenta de IBM. Llegará a esta página:

Aquí, pulse el botón «Crear nuevo agente» situado a la izquierda para abrir el formulario de creación de un nuevo agente. Rellene el formulario «Crear un agente» de la siguiente manera:

• Seleccione la opción «Crear desde cero».
• Asigne un nombre a su agente, por ejemplo, «Agente de recomendación de contenido».
• Proporcione una descripción como: «Este agente puede recuperar información actualizada de los motores de búsqueda a través de la integración de la API SERP de Bright Data para recomendar contenido relevante e interesante basado en una entrada determinada».
  
  Una vez hecho esto, pulse el botón «Crear» en la esquina inferior izquierda para continuar. A continuación, accederá a la página de gestión de agentes:
  
  ¡Genial! Acaba de inicializar su agente de IA de recomendación de contenido en IBM watsonx Orchestrate. Pronto se integrará con la API SERP de Bright Data para recuperar resultados de búsqueda actualizados.

Paso n.º 2: personalice su agente

En la página de gestión de agentes, puede personalizar varias opciones, como la voz del agente, el modelo de IA, las indicaciones de inicio, el mensaje de bienvenida y mucho más.

Para cambiar el modelo, abre el menú desplegable a la derecha de la sección «Modelo de IA»:

En la versión de prueba de IBM Watsonx, tienes acceso a los dos modelos siguientes:

1. llama-3-2-90b-vision-instruct: optimizado para el reconocimiento visual, el razonamiento de imágenes, la subtitulación y la respuesta a preguntas sobre imágenes. Este es el modelo predeterminado.
2. llama-3-405b-instruct: LLM avanzado para la generación de datos sintéticos, la destilación y la inferencia para chatbots, codificación y tareas específicas de dominio. Desarrollado por Meta.

Seleccione el modelo que mejor se adapte al propósito de su agente.

A continuación, considere la posibilidad de actualizar el mensaje de bienvenida para que se adapte mejor a la función de su agente. Por ejemplo, escriba algo como «¿Qué consejos de recomendación de contenido desea?».

Además, actualice las indicaciones de inicio rápido para proporcionar ejemplos de interacciones a los usuarios:

• «Recomiéndame algunas películas recientes que definitivamente debería ver».
• «Muéstrame las noticias más recientes sobre IBM Watsonx».
• «Busca temas de blog de tendencia sobre IA en 2025 y sugiere cinco ideas de contenido sobre las que podría escribir».

Ahora bien, dado que este agente se basará principalmente en herramientas (concretamente, la API SERP de Bright Data), también tiene sentido definirlo como un agente ReAct. Si no está familiarizado con esta arquitectura, un agente ReAct sigue este flujo:

• Pensamiento: el LLM planifica el siguiente paso.
• Acción: ejecuta acciones utilizando herramientas.
• Observación: Observa los resultados y perfecciona el enfoque.

Este bucle continuo permite al agente manejar consultas complejas, cruzar información y validar resultados intermedios antes de proporcionar una respuesta final.

Una vez completadas todas las configuraciones, vaya a la sección «Vista previa» a la derecha y pulse el botón «Restablecer chat» para volver a cargar la vista previa de su agente:

Ahora verá el agente actualizado con todas sus personalizaciones aplicadas:

Paso n.º 3: Empieza a utilizar la API SERP de Bright Data

Antes de continuar con la definición del agente de IA, debe preparar su cuenta de Bright Data y configurar el servicio API SERP. Para ello, siga la documentación oficial de Bright Data o las instrucciones que se indican a continuación.

Si aún no tiene una cuenta, cree una cuenta de Bright Data. De lo contrario, simplemente inicie sesión. Una vez que haya iniciado sesión, vaya a la página «Proxy y scraping». En la sección «Mis zonas», busque una fila con la etiqueta «API SERP» en la tabla:

Si no ve una fila con la etiqueta «API SERP», significa que aún no se ha configurado una zona. Desplácese hacia abajo hasta la sección «API SERP» y haga clic en «Crear zona» para añadir una:

Cree una zona API SERP y asígnele un nombre, como serp_api (o cualquier nombre que prefiera). Anote el nombre de la zona, ya que lo necesitará para acceder al servicio en IBM watsonx.

En la página del producto API SERP, activa el botón «Activar» para habilitar la zona:

Por último, siga el tutorial oficial para generar su clave API de Bright Data. Guárdela en un lugar seguro, ya que la necesitará pronto.

También te recomendamos que consultes la documentación de la API SERP de Bright Data para familiarizarte con cómo llamar a la API, sus opciones disponibles y otros detalles.

¡Perfecto! Ahora ya tiene todo configurado para utilizar la API SERP de Bright Data en su agente de IA IBM watsonx.

Paso n.º 4: Añadir la herramienta API SERP

Como parte de las opciones de personalización, también tiene la posibilidad de añadir herramientas a su agente. Así es como puede conectar un agente de IA a la API SERP de Bright Data. Repasemos la definición y la integración de esta herramienta personalizada (lo que nos llevará los tres pasos siguientes).

Para añadir una nueva herramienta a su agente, vaya a la sección «Herramientas» y haga clic en el botón «Añadir herramienta»:

Normalmente, podría considerar seleccionar la opción«Crear un flujo de trabajo de agente»y escribir el código Python para conectarse a la API SERP de Bright Data. Sin embargo, en el momento de escribir este artículo, los módulos Python disponibles (quepuede importar y utilizar en nodos de código Python personalizados) son fijos y no se pueden ampliar. Dado que no se incluyen clientes HTTP de Python, el enfoque de código personalizado no funcionará. En su lugar, puede integrar la API SERP en una herramienta a través de una especificación OpenAPI.

En concreto, lo que debe hacer es añadir la herramienta API de Bright Data utilizando una definición OpenAPI. Para ello, cree un archivo llamado bright-data-serp-api.yml en su equipo local con la siguiente especificación:

openapi: 3.0.3
info:
  title: Bright Data API SERP
  version: 1.0.0
  description: >
    Bright Data API SERP proporciona resultados reales de usuarios en grandes volúmenes para todos los principales motores de búsqueda. Admite formatos de salida sin procesar y Markdown.
servers:
  - url: https://api.brightdata.com
paths:
  /request:
    post:
      summary: Enviar una solicitud SERP
      description: >
        Enviar una solicitud de scraping SERP utilizando su zona Bright Data API SERP.
      tags:
        - SERP
      requestBody:
        required: true
        content:
          application/json:
            esquema:
              tipo: objeto
              obligatorio:
                - zona
                - url
              propiedades:
                zona:
                  tipo: cadena
                  descripción: El nombre de su zona API SERP.
                  predeterminado: <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME>
                url:
                  tipo: cadena
                  descripción: La URL del motor de búsqueda que se va a consultar (por ejemplo, https://www.google.com/search?q=<search_query>)
                  ejemplo: https://www.google.com/search?q=pizza&hl=en&gl=us
                formato:
                  tipo: cadena
                  descripción: Formato de respuesta
                  predeterminado: sin procesar
                formato_de_datos:
                  tipo: cadena
                  descripción: Formato de datos de salida
                  predeterminado: markdown
      respuestas:
        "200":
          descripción: Respuesta satisfactoria con resultados de búsqueda
          contenido:
            texto/sin formato:
              esquema:
                tipo: cadena
        "400":
          descripción: Solicitud no válida
        "401":
          descripción: No autorizado: clave API no válida
        «500»:
          descripción: Error interno del servidor
      seguridad:
        - bearerAuth: []
componentes:
  esquemas de seguridad:
    bearerAuth:
      tipo: http
      esquema: bearer
      formato bearer: API_KEY

Importante: Reemplace <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME> por el nombre real de la zona API SERP que ha creado anteriormente (por ejemplo, serp_api).

El código YAML anterior define una especificación OpenAPI v3.0.3 para integrar la API SERP de Bright Data. Los puntos clave a tener en cuenta son:

• El cuerpo de la API define los siguientes parámetros:
  • zona: El nombre de su zona API SERP.
  • url: La URL de la página del motor de búsqueda a consultar.
  • format: especifica cómo debe producir la API los datos de salida. «``raw» significa que la API devolverá los datos recuperados directamente en el cuerpo de la respuesta, sin anidarlos en un objeto estructurado.
  • data_format: Determina el formato de la respuesta, como HTML, JSON analizado o Markdown. En este caso, se establece en «markdown» de forma predeterminada, ya que es un formato de datos ideal para la ingestión de IA.
• La sección bearerAuth bajo securitySchemes indica que la conexión de la API se autentica utilizando una clave API proporcionada por el usuario en el encabezado Authorization a través del mecanismo Bearer (que es cómo se autentican las solicitudes a la API SERP utilizando su clave API de Bright Data).

Lo importante aquí es comprender que la especificación OpenAPI anterior define una llamada a la API SERP de Bright Data que devuelve datos en formato Markdown. Para obtener todos los detalles anteriores, incluido el significado de cada parámetro y opción, consulte la documentación oficial.

Para pasar ese archivo YAML a IBM watsonx, en el modal «Añadir una nueva herramienta», seleccione «Añadir desde archivo o servidor MCP»:

A continuación, elija «Importar desde archivo»:

Consejo: Para simplificar el acceso a los productos Bright Data preparados para IA, también puede seleccionar la opción «Importar desde servidor MCP» y configurar el MCP web de Bright Data a través de su instancia remota.

En la ventana modal «Importar herramienta», arrastre y suelte su archivo bright-data-API-SERP.yml o haga clic para cargarlo:

Una vez completada la validación, debería ver el siguiente mensaje de confirmación:

¡Éxito! Su especificación OpenAPI para la integración de la API SERP de Bright Data ha sido aceptada. Pulse «Siguiente» y continúe con la integración de la herramienta en su agente.

Paso n.º 5: Complete la autenticación de la herramienta API SERP

Después de pulsar el botón «Siguiente», verá la fila «Enviar una solicitud SERP» en la tabla «Operaciones»:

Marque esta casilla y pulse el botón «Siguiente». A continuación, accederá a la sección «Conexiones», donde deberá definir la conexión necesaria para autenticar las solicitudes de la API SERP utilizando su clave API de Bright Data. Empezará pulsando el botón «Añadir nuevo elemento»:

En la sección «Añadir nueva conexión», asigne un ID a la conexión, como bright-data-api-key:

Pulsa «Guardar y continuar» y configura tu conexión seleccionando:

• Tipo de autenticación: «Bearer Token»
• Tipo de credenciales: «Credenciales de equipo»

En el campo de entrada «Token de portador» que aparece después de seleccionar la opción «Credenciales de equipo», pegue su clave API de Bright Data. A continuación, pulse «Conectar»:

Una vez verificada la conexión, debería ver una confirmación como esta:

A continuación, pulse «Finalizar» y seleccione bright-data-api-key en la tabla «Conexiones»:

Por último, complete la configuración de autenticación pulsando «Hecho».

¡Enhorabuena! Ha autenticado correctamente su herramienta personalizada «Enviar una solicitud SERP» para la integración de la API SERP de Bright Data.

Paso n.º 6: Finalizar la configuración de la herramienta API SERP

En la página de administración del agente, ahora verá la herramienta «Enviar una solicitud SERP» disponible en la sección «Conjunto de herramientas»:

Para personalizar aún más la herramienta, pulse el botón «⋮» y seleccione la opción «Editar detalles». En la página de configuración, revise todos los ajustes para comprobar que todo es correcto y está configurado según sea necesario:

Verá la descripción de la API y los parámetros del cuerpo de la solicitud, junto con sus valores predeterminados, tal y como se definen en la especificación YAML cargada anteriormente.

¡Ya está! Por fin ha terminado de integrar la API SERP de Bright Data en su agente IBM watsonx utilizando una herramienta personalizada definida mediante una especificación OpenAPI.

Paso n.º 7: Prueba el agente

Su agente de IA IBM watsonx ya está configurado con acceso a una herramienta para la recuperación de SERP. Pruébelo con un comando que requiera datos en tiempo real del motor de búsqueda, como por ejemplo:

Busca las noticias más recientes sobre robots humanoides con IA y sugiere cinco ideas de contenido sobre las que podría escribir para explorar este tema.

(Nota: esto es solo un ejemplo, y puedes probar cualquier comando que requiera resultados de búsqueda web).

Es una solicitud ideal porque solicita información actual que el modelo base por sí solo puede no conocer, ya que «robots humanoides con IA» es un tema de actualidad con noticias que se actualizan constantemente.

Ejecute esta solicitud en la sección «Vista previa» de su agente y debería ver un resultado similar a este:

El agente basado en ReAct llamará a la herramienta «Enviar una solicitud SERP», recuperará los resultados y procesará la información SERP para generar una respuesta coherente.

Si alguna vez ha intentado extraer resultados de búsqueda de Google, sabrá lo difícil que es debido a la detección de bots, las prohibiciones de IP, la representación de JavaScript (que incluso provocó una crisis de datos SERP) y otros problemas. La API SERP de Bright Data se encarga de todo esto por usted, devolviendo SERP extraídos en formato Markdown (o HTML, JSON, etc.) optimizado para IA.

Para asegurarte de que el agente ha llamado a la API SERP, expande la sección «Razonamiento» de la respuesta. Céntrate en el «Paso 1»:

Observe cómo el primer paso corresponde a la llamada a la herramienta API SERP de Bright Data para la consulta «últimas noticias sobre robots humanoides con IA» (que se dedujo de la indicación). A continuación, la respuesta de la herramienta es la versión Markdown de la página SERP para esa consulta de búsqueda.

En este caso, a continuación se muestra la respuesta generada por el agente de IA:

Basándonos en los resultados de la búsqueda, aquí hay cinco ideas de contenido para explorar el tema de los robots humanoides con IA:
1. «El futuro del trabajo: cómo los robots humanoides con IA están revolucionando las industrias». Este artículo podría explorar las diversas formas en que se utilizan los robots humanoides con IA en diferentes industrias, como la fabricación, la atención sanitaria y el servicio al cliente.
2. «La ética de los robots humanoides con IA: ¿deberían tener derechos humanos?». : este artículo podría profundizar en las implicaciones éticas de la creación de robots cada vez más parecidos a los humanos y en si se les deberían conceder derechos humanos.
3. «Los últimos avances en robots humanoides con IA: lo que necesitas saber»: este artículo podría ofrecer una visión general de los últimos avances en robots humanoides con IA, incluidas las nuevas tecnologías e innovaciones que se están utilizando para crear robots más avanzados.
4. «Los riesgos y beneficios potenciales de los robots humanoides con IA en el hogar»: este artículo podría explorar los riesgos y beneficios potenciales de tener robots humanoides con IA en el hogar, incluyendo su potencial para ayudar con las tareas domésticas y proporcionar compañía.
5. «El impacto de los robots humanoides con IA en la sociedad: una mirada al futuro»: este artículo podría examinar el impacto potencial de los robots humanoides con IA en la sociedad, incluyendo su potencial para cambiar nuestra forma de vivir y trabajar, y las posibles consecuencias de crear robots cada vez más parecidos a los humanos.

¡Esta es una respuesta excelente con información valiosa para la generación de contenido!

Ahora es el momento de llevar a tu agente aún más lejos. Prueba a realizar pruebas relacionadas con la verificación de datos, la supervisión de marcas, el análisis de tendencias de mercado u otros escenarios para evaluar su rendimiento en diferentes casos de uso de RAG y agentes.

¡Et voilà! Acaba de crear un agente de IA en IBM Watsonx integrado con la API SERP de Bright Data. Ahora su agente puede recuperar datos de búsqueda web actualizados, fiables y contextuales bajo demanda para impulsar recomendaciones de contenido inteligentes.

Conclusión

En esta entrada del blog, has aprendido a integrar la API SERP de Bright Data en un agente de IA de IBM Watsonx utilizando un flujo de trabajo de bajo código.

Este enfoque es ideal para los usuarios empresariales que desean crear agentes de IA sensibles al contexto en IBM, al tiempo que aprovechan las características escalables y preparadas para la empresa de la API SERP de Bright Data. Para llevar sus flujos de trabajo de IA aún más lejos, explore la infraestructura de Bright Data para IA.

¡Regístrese hoy mismo en Bright Data y comience a probar nuestras soluciones de datos web preparadas para IA de forma gratuita!