Интегрируйте SERP API Bright Data в AI Agent в IBM watsonx

В этом учебном пособии вы узнаете:

• Как IBM watsonx поддерживает разработку ИИ-агентов.
• Почему интеграция SERP API от Bright Data улучшает агенты IBM watsonx Orchestrate.
• Точные шаги по созданию ИИ-агента на базе SERP API от Bright Data в IBM watsonx Orchestrate.

Приступим!

Что такое функция создания ИИ-агентов в IBM watsonx?

IBM Watsonx Orchestrate, готовая к использованию в предприятии система генеративного ИИ и автоматизации, предоставляет возможности по созданию ИИ-агентов. Это решение дает вам все необходимое для проектирования, развертывания и управления автономными ИИ-агентами, которые выполняют задачи, принимают решения и взаимодействуют с критически важными для бизнеса системами.

Создание агентов в IBM watsonx доступно как через веб-интерфейс с низким уровнем кодирования, так и через подход на основе кода с помощью библиотеки Python Agent Development Kit (ADK). В этой статье мы сосредоточимся на интеграции рабочего процесса с низким уровнем кодирования с использованием веб-приложения.

Агенты в службе Orchestrate могут сотрудничать посредством многоагентной оркестрации, подключаться к различным внешним инструментам, использовать RAG (Retrieval-Augmented Generation) для ответов, основанных на знаниях, и многое другое.

Платформа также включает функции управления и наблюдаемости для обеспечения соответствия, прозрачности и мониторинга производительности. После создания агенты могут быть развернуты по нескольким каналам, таким как веб-чат, Slack, Microsoft Teams и другие.

Почему агентам IBM watsonx нужен доступ к SERP API Bright Data

Крупные языковые модели, в том числе доступные в IBM watsonx, ограничены данными, на которых они были обучены. Проще говоря, их знания останавливаются на определенном моменте времени.

Вот почему LLM, как правило, дают устаревшие или неточные ответы. Эта проблема становится еще более серьезной для агентов ИИ, которым поручено принимать решения или составлять отчеты для поддержки принятия решений…

Решением является оснащение вашего агента инструментами, которые позволяют ему получать и обрабатывать надежные данные. Например, агент может запрашивать поисковые системы для сбора проверенной, актуальной информации, а затем учиться на этих данных, чтобы уменьшить количество галлюцинаций. Результатом будут более точные решения и большая уверенность в том, что ответы агента основаны на реальных знаниях.

Самый простой способ достичь этого — использовать SERP API или инструмент веб-поиска, такой как SERP API от Bright Data. Этот API корпоративного уровня для извлечения данных из поисковых систем обрабатывает прокси, разблокировку и форматирование данных за вас. Другими словами, вам не нужно беспокоиться о типичных проблемах сбора данных из поисковых систем при работе с ИИ-агентами.

SERP API от Bright Data напрямую интегрируется с IBM watsonx Orchestrate (а также со многими другими платформами для создания агентов ИИ), позволяя вашим агентам ИИ получать доступ к результатам поиска и генерировать более контекстуальные, достоверные и проверяемые результаты.

Разработка ИИ-агента с интеграцией SERP API в IBM watsonx.ai: пошаговое руководство

В этом разделе вы узнаете, как интегрировать Bright Data SERP API в качестве инструмента в ИИ-агента в IBM watsonx Orchestrate.

Среди множества возможных вариантов использования, в этом руководстве основное внимание уделяется созданию агента по рекомендациям контента. Его цель — предлагать идеи контента на основе последних тенденций, связанных с данной темой (например, находить последние горячие новости, о которых стоит написать или снять видео на YouTube для маркетинга).

Примечание: это лишь один из примеров, и вы можете адаптировать ту же интеграцию SERP API для многих других сценариев использования на базе ИИ.

Выполните следующие шаги!

Необходимые условия

Чтобы выполнить это руководство, убедитесь, что у вас есть:

• IBMid для входа в IBM watsonx Orchestrate (достаточно бесплатной пробной версии).
• Учетная запись Bright Data с активным ключом API.

Не беспокойтесь о настройке учетной записи Bright Data, так как позже вы пройдете этот процесс.

Также будет полезно иметь некоторое представление о том, как работает SERP API Bright Data, как агенты ИИ используют инструменты, а также об основах спецификаций OpenAPI для определения инструментов.

Шаг 1: Создайте нового агента IBM watsonx ИИ

Войдите в IBM watsonx Orchestrate, используя свою учетную запись IBM. Вы попадёте на эту страницу:

Здесь нажмите кнопку «Создать нового агента» слева, чтобы открыть форму для создания нового агента. Заполните форму «Создать агента» следующим образом:

• Выберите опцию «Создать с нуля».
• Дайте своему агенту имя, например «Агент по рекомендациям контента».
• Укажите описание, например: «Этот агент может получать актуальную информацию из поисковых систем через интеграцию SERP API Bright Data, чтобы рекомендовать релевантный и интересный контент на основе заданного ввода».
  
  После этого нажмите кнопку «Создать» в левом нижнем углу, чтобы продолжить. Вы перейдете на страницу управления агентами:
  
  Отлично! Вы только что инициализировали своего агента ИИ для рекомендаций контента в IBM watsonx Orchestrate. В скором времени он будет интегрирован с SERP API Bright Data для получения свежих результатов поиска.

Шаг № 2: Настройте своего агента

На странице управления агентом вы можете настроить несколько параметров, таких как голос агента, модель ИИ, стартовые подсказки, приветственное сообщение и многое другое.

Чтобы изменить модель, откройте раскрывающийся список справа от раздела «Модель ИИ»:

В пробной версии IBM Watsonx у вас есть доступ к следующим двум моделям:

1. llama-3-2-90b-vision-instruct: оптимизирована для визуального распознавания, анализа изображений, создания подписей и ответов на вопросы об изображениях. Это модель по умолчанию.
2. llama-3-405b-instruct: усовершенствованная LLM для генерации синтетических данных, дистилляции и вывода для чат-ботов, кодирования и задач в конкретных областях. Разработана Meta.

Выберите модель, которая лучше всего подходит для целей вашего агента.

Затем подумайте об обновлении приветственного сообщения, чтобы оно лучше соответствовало функциям вашего агента. Например, напишите что-то вроде «Какие советы по контенту вы хотите получить?».

Также обновите подсказки быстрого запуска, чтобы предоставить пользователям примеры взаимодействия:

• «Порекомендуйте несколько последних фильмов, которые я обязательно должен посмотреть».
• «Покажите мне самые свежие новости о IBM watsonx».
• «Найдите популярные темы блогов об ИИ в 2025 году и предложите пять идей для контента, о которых я мог бы написать».

Теперь, поскольку этот агент будет в основном полагаться на инструменты (в частности, на Bright Data SERP API), имеет смысл определить его как агент ReAct. Если вы не знакомы с этой архитектурой, агент ReAct работает по следующему принципу:

• Мысль: LLM планирует следующий шаг.
• Действие: выполняет действия с помощью инструментов.
• Наблюдение: наблюдает за результатами и уточняет подход.

Этот непрерывный цикл позволяет агенту обрабатывать сложные запросы, сверять информацию и проверять промежуточные результаты, прежде чем давать окончательный ответ.

После завершения всех настроек перейдите в раздел «Предварительный просмотр» справа и нажмите кнопку «Сбросить чат», чтобы перезагрузить предварительный просмотр вашего агента:

Теперь вы увидите обновленного агента со всеми вашими настройками:

Шаг № 3: Начните работу с SERP API от Bright Data

Прежде чем продолжить определение агента ИИ, вам необходимо подготовить свою учетную запись Bright Data и настроить службу SERP API. Для этого следуйте официальной документации Bright Data или инструкциям ниже.

Если у вас еще нет учетной записи, создайте учетную запись Bright Data. В противном случае просто войдите в систему. После входа в систему перейдите на страницу «Прокси и скрапинг». В разделе «Мои зоны» найдите в таблице строку с надписью «SERP API»:

Если вы не видите строку с надписью «SERP API», это означает, что зона еще не настроена. Прокрутите вниз до раздела «SERP API» и нажмите «Создать зону», чтобы добавить ее:

Создайте зону SERP API и присвойте ей имя, например serp_api (или любое другое имя по вашему усмотрению). Запомните название зоны, так как оно понадобится вам для доступа к сервису в IBM watsonx.

На странице продукта SERP API переключите переключатель «Активировать», чтобы включить зону:

Наконец, следуйте официальному руководству, чтобы сгенерировать ключ API Bright Data. Храните его в надежном месте, так как он вам скоро понадобится.

Мы также рекомендуем ознакомиться с документацией Bright Data SERP API, чтобы узнать, как вызывать API, какие опции доступны и другие детали.

Отлично! Теперь у вас есть все необходимое для использования SERP API Bright Data в вашем IBM watsonx ИИ-агенте.

Шаг 4: Добавьте инструмент SERP API

В рамках настроек вы также можете добавлять инструменты в свой агент. Так вы можете подключить ИИ-агента к SERP API Bright Data. Давайте рассмотрим определение и интеграцию этого настраиваемого инструмента (что займет следующие три шага).

Чтобы добавить новый инструмент в свой агент, перейдите в раздел «Инструменты» и нажмите кнопку «Добавить инструмент»:

Обычно вы могли бы выбрать опцию«Создать рабочий процесс агента»и написать код Python для подключения к Bright Data SERP API. Однако на момент написания этой статьи доступные модули Python, которые можноимпортировать и использовать в пользовательских узлах кода Python, являются фиксированными и не могут быть расширены. Поскольку HTTP-клиенты Python не включены, подход с использованием пользовательского кода не будет работать. Вместо этого вы можете интегрировать SERP API в инструмент через спецификацию OpenAPI.

В частности, вам нужно добавить инструмент Bright Data SERP API с помощью определения OpenAPI. Для этого создайте на своем локальном компьютере файл с именем bright-data-serp-api.yml со следующими характеристиками:

openapi: 3.0.3
info:
  title: Bright Data SERP API
  version: 1.0.0
  description: >
    Bright Data SERP API предоставляет реальные результаты пользователей в больших объемах для всех
    основных поисковых систем. Поддерживает форматы вывода raw и Markdown.
servers:
  - url: https://api.brightdata.com
paths:
  /request:
    post:
      summary: Отправить запрос SERP
      description: >
        Отправить запрос на скрапинг SERP, используя зону Bright Data SERP API.
      tags:
        - SERP
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - zone
                - url
              properties:
                zone:
                  type: string
                  description: Название вашої зони SERP API.
                  default: <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME>
                url:
                  type: string
                  description: URL поисковой системы для запроса (например, https://www.google.com/search?q=<search_query>)
                  example: https://www.google.com/search?q=pizza&hl=en&gl=us
                format:
                  type: string
                  description: Формат ответа
                  default: raw
                data_format:
                  type: string
                  description: Формат выходных данных
                  по умолчанию: markdown
      ответы:
        "200":
          описание: Успешный ответ с результатами поиска
          содержимое:
            text/plain:
              схема:
                тип: строка
        "400":
          описание: Недопустимый запрос
        "401":
          описание: Неавторизованный — недействительный ключ API
        "500":
          описание: Внутренняя ошибка сервера
      безопасность:
        - bearerAuth: []
компоненты:
  схемы безопасности:
    bearerAuth:
      тип: http
      схема: bearer
      формат bearer: API_KEY

Важно: Замените <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME> на фактическое название вашей зоны SERP API, созданной ранее (например, serp_api).

Вышеуказанный код YAML определяет спецификацию OpenAPI v3.0.3 для интеграции Bright Data SERP API. Ключевые моменты, на которые следует обратить внимание:

• Тело API определяет следующие параметры:
  • zone: название вашей зоны SERP API.
  • url: URL-адрес страницы поисковой системы для запроса.
  • format: определяет, как API должен генерировать выходные данные. «``raw» означает, что API вернет полученные данные непосредственно в теле ответа, не вкладывая их в структурированный объект.
  • data_format: определяет формат ответа, например HTML, проанализированный JSON или Markdown. В данном случае по умолчанию установлено значение «markdown», так как это идеальный формат данных для обработки ИИ.
• Раздел bearerAuth в securitySchemes указывает, что подключение API аутентифицируется с помощью ключа API, предоставленного пользователем в заголовке Authorization, через механизм Bearer (так вы аутентифицируете запросы к SERP API с помощью ключа API Bright Data).

Здесь важно понимать, что вышеуказанная спецификация OpenAPI определяет вызов Bright Data SERP API, который возвращает данные в формате Markdown. Все вышеуказанные детали, включая значение каждого параметра и опции, можно найти в официальной документации.

Чтобы передать этот файл YAML в IBM watsonx, в модальном окне «Добавить новый инструмент» выберите «Добавить из файла или сервера MCP»:

Затем выберите «Импортировать из файла»:

Совет: чтобы упростить доступ к продуктам Bright Data, готовым к использованию с ИИ, вы также можете выбрать опцию «Импортировать с сервера MCP» и настроить Web MCP Bright Data через его удаленный экземпляр.

В модальном окне «Импортировать инструмент» перетащите файл bright-data-SERP API.yml или нажмите, чтобы загрузить его:

После завершения проверки вы должны увидеть следующее подтверждающее сообщение:

Успех! Ваша спецификация OpenAPI для интеграции Bright Data SERP API была принята. Нажмите «Далее» и продолжите интеграцию инструмента в вашем агенте.

Шаг 5: Завершите аутентификацию инструмента SERP API

После нажатия кнопки «Далее» в таблице «Операции» вы увидите строку «Отправить запрос SERP»:

Отметьте его и нажмите кнопку «Далее». Затем вы перейдете в раздел «Соединения», где необходимо определить соединение, необходимое для аутентификации запросов SERP API с использованием вашего ключа API Bright Data. Начните с нажатия кнопки «Добавить новый элемент»:

В разделе «Добавить новое соединение» присвойте соединению идентификатор, например bright-data-api-key:

Нажмите «Сохранить и продолжить» и настройте соединение, выбрав:

• Тип аутентификации: «Bearer Token»
• Тип учетных данных: «Учетные данные команды»

В поле ввода «Bearer token», которое появляется после выбора опции «Учетные данные команды», вставьте свой ключ API Bright Data. Затем нажмите «Подключиться»:

После проверки подключения вы должны увидеть подтверждение, подобное этому:

Затем нажмите «Готово» и выберите bright-data-api-key в таблице «Подключения»:

Наконец, завершите настройку аутентификации, нажав «Готово».

Поздравляем! Вы успешно провели аутентификацию своего настраиваемого инструмента «Отправить запрос SERP» для интеграции с Bright Data SERP API.

Шаг 6: Завершите настройку инструмента SERP API

На странице управления агентом вы теперь увидите инструмент «Отправить запрос SERP» в разделе «Набор инструментов»:

Чтобы дополнительно настроить инструмент, нажмите кнопку «⋮» и выберите опцию «Edit Details» (Редактировать детали). На странице настройки проверьте все параметры, чтобы убедиться, что все правильно и настроено по необходимости:

Вы увидите описание API и параметры тела запроса, а также их значения по умолчанию, как определено в спецификации YAML, загруженной ранее.

Вот и все! Вы наконец-то завершили интеграцию SERP API Bright Data в ваш агент IBM watsonx с помощью настраиваемого инструмента, определенного через спецификацию OpenAPI.

Шаг № 7: Тестирование агента

Ваш агент IBM watsonx ИИ теперь настроен с доступом к инструменту для извлечения SERP. Протестируйте его с помощью запроса, который требует данных поисковой системы в реальном времени, например:

Найдите самые свежие новости об искусственном ИИ-роботах-гуманоидах и предложите пять идей для контента, о которых я мог бы написать, чтобы изучить эту тему.

(Примечание: это всего лишь пример, вы можете протестировать любой запрос, требующий результатов веб-поиска).

Это идеальная подсказка, поскольку она запрашивает актуальную информацию, которую базовая модель сама по себе может не знать, поскольку «роботы-гуманоиды с ИИ» — это актуальная тема, по которой постоянно появляются новые новости.

Запустите этот запрос в разделе «Предварительный просмотр» вашего агента, и вы должны увидеть результат, похожий на этот:

Агент на основе ReAct вызовет инструмент «Отправить запрос SERP», получит результаты и обработает информацию SERP, чтобы сгенерировать связный ответ.

Если вы когда-нибудь пробовали собирать результаты поиска Google, вы знаете, насколько это сложно из-за обнаружения ботов, блокировки IP-адресов, рендеринга JavaScript (что даже привело к кризису данных SERP) и других проблем. API Bright Data SERP решает все эти проблемы за вас, возвращая собранные SERP в формате Markdown (или HTML, JSON и т. д.), оптимизированном для ИИ.

Чтобы убедиться, что SERP API был вызван агентом, разверните раздел «Reasoning» (Рассуждения) в ответе. Обратите внимание на «Step 1» (Шаг 1):

Обратите внимание, как первый шаг соответствует вызову инструмента Bright Data SERP API для запроса «последние новости об искусственных интеллектуальных роботах-гуманоидах» (который был выведен из подсказки). Затем инструмент отвечает версией страницы SERP в формате Markdown для этого поискового запроса.

В данном случае ниже приведен ответ, сгенерированный агентом ИИ:

На основе результатов поиска, вот пять идей для контента, чтобы исследовать тему человекоподобных роботов с ИИ:
1. «Будущее работы: как человекоподобные роботы с ИИ революционизируют отрасли» — в этой статье можно исследовать различные способы использования человекоподобных роботов с ИИ в разных отраслях, таких как производство, здравоохранение и обслуживание клиентов.
2. «Этика человекоподобных роботов с ИИ: следует ли им предоставлять права человека?» — в этой статье можно было бы углубиться в этические последствия создания роботов, которые все больше похожи на людей, и в вопрос о том, следует ли предоставлять им права человека.
3. «Последние достижения в области роботов-гуманоидов с ИИ: что нужно знать» — в этой статье можно было бы дать обзор последних разработок в области роботов-гуманоидов с ИИ, включая новые технологии и инновации, которые используются для создания более совершенных роботов.
4. «Потенциальные риски и преимущества роботов-гуманоидов с ИИ в домашних условиях» — в этой статье можно было бы рассмотреть потенциальные риски и преимущества использования роботов-гуманоидов с ИИ в домашних условиях, включая их потенциал в помощи по дому и обеспечении компании.
5. «Влияние роботов-гуманоидов с ИИ на общество: взгляд в будущее» — в этой статье можно рассмотреть потенциальное влияние роботов-гуманоидов с ИИ на общество, включая их потенциал изменить наш образ жизни и работу, а также потенциальные последствия создания роботов, которые все больше похожи на людей.

Это отличный ответ с ценными идеями для создания контента!

Теперь пришло время продвинуть вашего агента еще дальше. Попробуйте протестировать подсказки, связанные с проверкой фактов, мониторингом бренда, анализом рыночных тенденций или другими сценариями, чтобы оценить, как он работает в различных случаях использования RAG и агентов.

Et voilà! Вы только что создали ИИ-агента в IBM watsonx, интегрированного с SERP API от Bright Data. Теперь ваш агент может по запросу получать актуальные, надежные и контекстные данные веб-поиска для создания интеллектуальных рекомендаций по контенту.

Заключение

В этом блоге вы узнали, как интегрировать SERP API от Bright Data в ИИ-агента IBM watsonx с помощью низкокодового рабочего процесса.

Этот подход идеально подходит для бизнес-пользователей, которые хотят создавать контекстно-зависимых ИИ-агентов на IBM, используя масштабируемые и готовые к использованию в предприятии функции SERP API от Bright Data. Чтобы еще больше усовершенствовать свои ИИ-рабочие процессы, изучите инфраструктуру Bright Data для ИИ.

Зарегистрируйтесь в Bright Data сегодня и начните тестировать наши готовые к использованию в ИИ решения для веб-данных бесплатно!