Integre la API SERP de Bright Data en un agente de IA en Microsoft Copilot Studio.

En este artículo aprenderás

• Qué es Microsoft Copilot Studio y qué lo hace especial.
• Por qué debería considerar integrar la API SERP de Bright Data en un agente de IA construido dentro de ella.
• Cómo implementar un agente de IA conectado a la API SERP dentro de Copilot Studio en un escenario real.

¡Entremos en materia!

¿Qué es Microsoft Copilot Studio?

Copilot Studio es una plataforma de código reducido desarrollada por Microsoft que permite crear, probar y publicar agentes de IA personalizados. También se puede utilizar para personalizar Microsoft 365 Copilot, el chatbot de IA generativa diseñado para aumentar la productividad.

Copilot Studio forma parte de Microsoft Power Platform y está diseñado para que usuarios con distintos niveles de conocimientos técnicos puedan acceder a él. En particular, le proporciona las herramientas para crear visualmente agentes de IA para automatizar tareas, proporcionar información y conectarse a otros sistemas empresariales y canales de comunicación.

Nota: Si desea crear un agente de IA en Azure, consulte nuestra guía dedicada a la integración de la API SERP de Bright Data en Azure IA Foundry.

Por qué integrar la API SERP de Bright Data en un agente de IA de Microsoft Copilot Studio

Copilot Studio es compatible con varios modelos de lenguaje de gran tamaño, que actúan como el motor/cerebro detrás de cualquier agente de IA. Sin embargo, independientemente del LLM que acabe eligiendo, sus conocimientos permanecen estáticos. Por ejemplo, un LLM no conoce los acontecimientos recientes, como los titulares de hoy o los resultados deportivos de anoche. Eso da lugar a respuestas desfasadas o incluso “alucinadas”.

Para hacer frente a esta limitación, es necesario basar el LLM en datos en tiempo real procedentes de la web. Esta técnica se utiliza ampliamente en los flujos de trabajo RAG(Retrieval-Augmented Generation), en los que se recupera información externa y se proporciona al LLM antes de que genere una respuesta, lo que garantiza que las respuestas sean precisas y estén actualizadas.

Copilot Studio lo hace posible al permitir la integración con fuentes de datos de terceros para la búsqueda web en directo, como la API SERP de Bright Data.

La API SERP le permite realizar consultas de búsqueda mediante programación en motores de búsqueda y recuperar SERP (páginas de resultados de motores de búsqueda) completas. Esto proporciona a sus agentes de IA un flujo constante de datos actualizados, verificables y ricos en contexto procedentes de los motores de búsqueda.

Cómo crear un agente de IA en Microsoft Copilot Studio con acceso a una herramienta API SERP

En esta sección paso a paso, aprenderá a integrar una herramienta API SERP de Bright Data en un agente de IA en Copilot Studio.

Entre los muchos casos de uso posibles, este capítulo le guiará a través de la creación de un agente de análisis de asociación de contenidos. Un agente de este tipo está concebido para descubrir asociaciones semánticas y temas contextuales que las páginas mejor clasificadas conectan con una palabra clave determinada.

La información producida por el agente es inestimable para comprender un tema con mayor profundidad, optimizar el contenido para SEO y mejorar su estrategia general de contenidos.

Nota: Esto es sólo un ejemplo, ya que puede lograr muchos otros casos de uso con la integración de la API SERP.

Siga los pasos que se indican a continuación.

Requisitos previos

Para seguir este tutorial, debe tener:

• Una cuenta de Microsoft Copilot Studio.
• Una cuenta de Microsoft Power Apps.
• Una cuenta de Bright Data con una clave API preparada.

Para crear una cuenta de Microsoft Copilot Studio, debe cumplir algunos requisitos previos adicionales.
Si aparece el error “Microsoft Copilot Studio no está disponible actualmente para su cuenta de trabajo o escuela” al registrarse, intente activar una prueba gratuita de Microsoft 365 Business Standard. Esto le proporcionará una cuenta con el formato <nombredeusuario>@<empresa>.onmicrosoft.com, que podrá utilizar para suscribirse a Copilot Studio.

También puede seguir las instrucciones del foro oficial de Microsoft para obtener más información sobre la configuración.

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

Paso 1: Crear un nuevo agente de IA en Copilot Studio

Para crear un agente de IA en Copilot Studio, inicie sesión. Accederá al panel principal:

En el menú de la izquierda, haga clic en el botón “Crear” y, a continuación, seleccione el botón “Nuevo agente”:

Llegará al formulario de creación de agente IA. Dado que el objetivo es crear un agente para el análisis de asociación de contenidos, rellene el formulario de la siguiente manera:

• Nombre: “Agente Analizador de Asociación de Contenidos”
• Descripción: “Este agente descubre temas y conceptos estrechamente asociados con una palabra clave/frase clave objetivo. Mediante el análisis de las páginas mejor clasificadas para las palabras clave seleccionadas, identifica temas contextuales, entidades y subtemas relacionados. El objetivo es ayudar a los usuarios a enriquecer sus páginas web con información semánticamente relevante y construir una autoridad temática más fuerte.”
• Instrucciones: “El agente utiliza la API SERP de Bright Data para recuperar los principales resultados de búsqueda para una palabra clave determinada. Analiza los títulos de las páginas, las meta descripciones y cualquier dato adicional disponible para detectar conceptos recurrentes y temas relacionados que aparezcan junto a la palabra clave objetivo, pero que no sean idénticos a ella. A continuación, debe resumir estas asociaciones en información procesable, como “Considera cubrir temas relacionados X, Y y Z”.

Esta información debe ser lo suficientemente detallada como para ayudar al LLM detrás del agente a lograr su objetivo previsto.

Una vez completado el formulario, haz clic en el botón “Crear” en la esquina superior derecha:

La configuración del agente IA tardará unos minutos. Una vez creado el agente, recibirá una notificación por correo electrónico en la dirección utilizada para su suscripción.

Cuando el agente IA esté listo, aparecerá en la página “Agentes”, accesible desde el menú de la izquierda:

¡Listo! Ya tiene un agente IA configurado en Copilot Studio.

Paso 2: Personalizar y configurar el agente

En la página “Agentes”, haga clic en la fila de su agente para acceder a su página dedicada:

En esta interfaz, puede personalizar y refinar el comportamiento de su agente y completar su implementación. También puede probarlo mediante una experiencia de chat en la columna de la derecha.

Por defecto, Copilot Studio asigna a su agente un modelo de IA preseleccionado y optimizado para la mayoría de los escenarios. En este caso, el modelo seleccionado fue GPT-4o. Para cambiar el modelo de IA, haz clic en el menú “…” de la fila “Modelo del agente” y selecciona la opción “Editar”:

Además, haga clic en el botón “Configuración” situado en la esquina superior derecha para acceder a una página de personalización:

En la página “Configuración”, tienes acceso a opciones para ajustar el tono de tu agente, el formato de respuesta y otros aspectos avanzados.

Dado que esto es sólo un ejemplo, mantenga la configuración predeterminada tal y como está. En un escenario de producción, no dude en personalizar el comportamiento y la configuración de su agente de IA según sus necesidades específicas para obtener los mejores resultados.

Paso 3: Configure su cuenta de Bright Data

Antes de definir una herramienta en el agente de IA para la integración de la API SERP de Bright Data en Copilot Studio, primero debe configurar su cuenta de Bright Data y configurar el servicio API SERP. Tenga en cuenta que puede seguir la documentación oficial de Bright Data o los pasos que se indican a continuación.

Si aún no lo ha hecho, regístrese en Bright Data. De lo contrario, inicie sesión en su cuenta existente. Una vez conectado, vaya a la sección “Mis Zonas” en la página “Proxies & Scraping” y busque una fila “API SERP” en la tabla:

En este caso, la cuenta de Bright Data ya dispone de una zona API SERP (llamada serp_api).

Si no tiene una fila para API SERP, significa que aún no ha configurado ese producto. En este caso, debe crear una nueva zona API SERP manualmente. Para ello, desplácese hacia abajo y haga clic en “Crear zona” en la sección “API SERP”:

Cree una zona API SERP, dándole un nombre como serp_api (o el nombre que prefiera). No pierda de vista el nombre de la Zona, ya que lo necesitará cuando defina la herramienta del agente IA de Copilot Studio para la integración de Bright Data.

En la página del producto, recuerde activar el interruptor “Activar” para habilitar la Zona:

Por último, siga la guía oficial para generar su clave API de Bright Data. Guárdela en un lugar seguro, ya que la necesitará en breve.

Perfecto. Ya tiene todo lo que necesita para utilizar la API SERP de Bright Data en Copilot Studio.

Paso 4: Iniciar la creación de la herramienta API SERP

Su agente de IA en Copilot Studio necesita acceso a la API SERP de Bright Data. En otras palabras, debe poder autenticarse y realizar llamadas API a su zona API SERP. Para conseguirlo, debe crear y configurar una herramienta de agente de IA personalizada.

Para definir una nueva herramienta, empieza por navegar hasta la pestaña “Herramientas”. A continuación, haga clic en el botón “Añadir una herramienta”:

Esto abrirá un modal en el que deberá hacer clic en el botón “Nueva herramienta”:

En el siguiente paso del asistente, seleccione la tarjeta “Conector personalizado”:

Los conectores personal izados son ideales para integrarse con servicios de terceros que requieren una lógica de autenticación especializada, como la API de Bright Data. Si desea simplificar el acceso a Bright Data preparado para IA, considere la posibilidad de seleccionar la tarjeta “Protocolo de contexto de modelo” y configurar el MCP web de Bright Data a través de su instancia remota.

Tras hacer clic en la tarjeta “Conector personalizado”, se le redirigirá a la página “Conectores personalizados” del servicio Microsoft Power Apps:

Aquí es donde definirá la conexión a la API SERP de Bright Data, que su agente utilizará como herramienta. La primera parte del proceso de definición de la herramienta API SERP está completa.

Paso 5: Definir la conexión a la API SERP

En la página “Conectores personalizados” del servicio Microsoft Power Apps, haga clic en el menú desplegable “Nuevo conector personalizado” y seleccione “Crear a partir de un espacio en blanco”:

En el modal que aparece, dale un nombre a tu conector (por ejemplo, “API SERP de Bright Data”) y luego haz clic en el botón “Continuar”.

Accederá al asistente del editor de conectores. Para simplificar la definición, utilizaremos una especificación Swagger. Para ello, active la opción “Editor Swagger”:

En el área de texto del editor Swagger, pega la siguiente definición OpenAPI 2.0:

swagger: '2.0'
info:
  title: API SERP de Bright Data
  descripción: >
    La API SERP de Bright Data proporciona resultados de usuarios reales en grandes volúmenes para todos los
    los principales motores de búsqueda.
  versión: '1.0
host: api.brightdata.com
basePath: /
esquemas:
  - https
consume:
  - application/json
rutas:
  /request:
    post:
      resumen: Enviar una solicitud SERP
      descripción: >
        Envíe una solicitud de SERP scraping utilizando su Zona API SERP de Bright Data.
        Requiere una clave API a través de la cabecera `Authorization`.
      tags:
        - SERP
      parámetros:
        - in: body
          nombre: cuerpo
          descripción: Carga útil de la solicitud para la API SERP.
          requerido: true
          esquema:
            tipo: object
            obligatorio:
              - Zona
              - url
            propiedades:
              Zona:
                tipo: cadena
              url:
                tipo: cadena      
              formato:
                tipo: cadena
                por defecto: raw
              formato_datos:
                tipo: string
                por defecto: markdown
      respuestas:
        '200':
          descripción: Respuesta correcta
        '400':
          descripción: Solicitud no válida
        '401':
          descripción: No autorizado - clave API no válida
        '500':
          descripción: Error interno del servidor
      operationId: serp-api-call
securityDefinitions:
  api_key:
    type: apiKey
    en: header
    nombre: Authorization
seguridad:
  - api_key: []

El código anterior en YAML es una especificación OpenAPI 2.0 para definir un conector API SERP de Bright Data. Lo que importa aquí son estos dos aspectos:

1. La definición, en el cuerpo de la API, de los parámetros zone (que representa el nombre de su zona API SERP), url (que representa la URL de la página del motor de búsqueda), format (que define cómo debe producir la API los datos de salida) y data_format (que determina cómo responderá la API, si con el HTML de la página, una versión JSON analizada, una versión Markdown, etc.).
2. La sección api_key de securityDefinitions especifica que la conexión a la API se autentica mediante una clave proporcionada por el usuario que se añade al encabezado Authorization ( así es como se autentica la API SERP utilizando su clave de API de Bright Data).

Para conocer todos los detalles anteriores, incluido el significado de cada parámetro y argumento, consulte la documentación oficial. Lo que necesita saber es que la configuración Swagger anterior especifica una llamada a la API SERP de Bright Data que devuelve datos en formato Markdown(un formato optimizado para la ingestión de IA).

En la página de definición del conector, verá:

Pulse “Crear conector” para guardar su conexión:

A continuación, pasa al paso “5. Probar” del asistente. En la sección “Operación de prueba”, pulse el botón “Crear conexión” en la tarjeta “Conexiones”:

Se le pedirá su clave API de Bright Data. Introdúzcala en este formato

Portador <YOUR_BRIGHT_DATA_API_KEY>

A continuación, pulse el botón “Crear” para continuar.

Importante: El prefijo “Portador” es necesario para rellenar correctamente el encabezado de autorización.

Ahora, en la página “5. Prueba”, rellene la sección “serp-api-call” con el nombre de su zona (por ejemplo, serp_api) y una URL de prueba (por ejemplo, https://www.google.com/search?q=pizza). Haz clic en “Probar operación” para probar la integración con la API SERP. Si todo va según lo esperado, deberías recibir una respuesta HTTP 200 OK:

La respuesta 200 confirma que el conector puede llamar correctamente a la API SERP. En el cuerpo de la respuesta, verás la versión Markdown de la SERP de Google para la consulta de búsqueda “pizza” (que se especificó en el campo “url” del formulario “serp-api-call”).

¡Sorprendente! Ya dispone de un conector API SERP de Bright Data listo para ser utilizado como herramienta en su agente de IA dentro de Copilot Studio.

Paso 6: Integrar la herramienta API SERP en su agente de IA

Ahora que el conector API SERP está listo, vuelva a su panel de control del agente de IA de Copilot Studio. Vaya a la sección “Añadir herramienta” como se explica en el paso 4.

Selecciona la etiqueta “Conector” y filtra los resultados buscando “serp api”. Debería ver el conector “Enviar una solicitud SERP – API SERP de Bright Data” que creó anteriormente:

Haga clic en la ficha del conector y pulse “Añadir y configurar”:

La adición de la herramienta puede tardar unos instantes, así que ten paciencia. Una vez listo, en la página de configuración del conector, configure las entradas de la siguiente manera

• Zona: Especifique el nombre de su zona de la API SERP de Bright Data tal y como se definió en el paso nº 3 (en este ejemplo, serp_api) utilizando un valor personalizado.
• url: Añada una descripción como “URL de la página de resultados del motor de búsqueda a consultar (por ejemplo, https://www.google.com/search?q=)”. Esto es importante porque indica a la IA cómo rellenar este campo (que luego se pasará a la API SERP para recuperar nuevos resultados de búsqueda).

Pulse “Guardar” en la esquina superior derecha, y debería ver un conector “Enviar una solicitud SERP” habilitado en su agente:

Ahora ha conectado su agente al conector “Bright Data API SERP” definido anteriormente. Para finalizar esta integración, haga clic en el botón “Configuración” de la pestaña “Visión general” y acceda a la página “Configuración de la conexión”. En la fila “Bright Data API SERP”, pulse el enlace “Conectar”:

Confirme pulsando “Enviar”, y ahora verá la API SERP de Bright Data marcada como conectada:

¡Ya está! La API SERP está finalmente integrada y disponible como herramienta en su agente de IA de Copilot Studio.

Paso 7: Pruebe su agente de IA

Para comprobar que su agente de IA funciona correctamente, debe probarlo con la consulta adecuada, como la que se muestra a continuación:

Analice la consulta de búsqueda "aprendizaje automático" e identifique los principales temas y conceptos relacionados que aparecen en los principales resultados de búsqueda. Sugiera temas asociados que podría tratar para reforzar la autoridad temática.

Esto debería bastar para activar la herramienta API SERP y dejar que el agente procese y analice los resultados para llevar a cabo la tarea de análisis de asociación de contenidos.

Ejecútelo en la sección “Pruebe su agente” de su panel de control y debería ver un comportamiento similar a este:

Esto es lo que hace el agente

1. Define un plan para llevar a cabo la tarea descrita en el prompt.
2. Realiza una petición a la API SERP para la consulta de búsqueda “machine learning”.
3. Recibe los datos SERP en formato Markdown y los procesa utilizando razonamiento profundo.
4. Devuelve recomendaciones procesables para la optimización de contenidos.

Al final de la ejecución, el panel del agente de IA en Copilot Studio debería tener este aspecto:

Como puedes ver, el panel de la izquierda muestra el flujo visual que representa cada paso dado por el agente para alcanzar el objetivo final.

Para confirmar que la solicitud a la API SERP se ha ejecutado correctamente, haz clic en el nodo “Enviar una solicitud a la API SERP”. Verás que la solicitud se realizó correctamente y que la API devolvió la versión Markdown de la SERP de Google para “machine learning”:

En concreto, a continuación se muestra el resultado final producido por el agente:

Este resultado contiene información valiosa sobre el contenido para la optimización SEO. Obtener esta información no sería posible sin los datos de búsqueda recuperados a través de la API SERP de Bright Data.

Si alguna vez ha intentado extraer los resultados de Google, sabrá lo difícil que puede resultar debido a la renderización de JavaScript (que incluso provocó una crisis de datos SEO) y a las protecciones anti-bot avanzadas. Incluso después de realizar el scraping con éxito, es necesario limpiar y optimizar el contenido para la ingestión de IA. La API SERP de Bright Data gestiona todo esto de forma automática a la vez que proporciona una escalabilidad infinita, permitiéndole publicar su agente de IA y escalarlo indefinidamente.

Ahora, experimente con diferentes descripciones e indicaciones de agentes para explorar otros escenarios, como flujos de trabajo RAG agénticos, comprobación de hechos, resumen de noticias o cualquier caso de uso que requiera datos de búsqueda web frescos.

¡Et voilà! Acaba de comprender cómo integrar la API SERP de Bright Data en un agente de IA en Microsoft Copilot Studio.

Conclusión

En esta entrada de blog, ha visto cómo utilizar la API SERP de Bright Data para un flujo de trabajo de análisis de asociación de contenidos.

Gracias a ello, ha podido crear un agente de IA en Copilot Studio que puede obtener datos SERP de Google y analizarlos para descubrir temas semánticamente precisos relacionados con una palabra clave de entrada. Esto es extremadamente útil para la optimización SEO y muchos otros casos de uso.

Para crear agentes y flujos de trabajo de IA aún más ricos y complejos, explore toda la gama de servicios que ofrece la infraestructura de Bright Data para IA.

Cree una cuenta de Bright Data de forma gratuita y acceda a nuestras soluciones de datos web preparadas para IA.