Интеграция API и набор инструментов Code Assist с использованием MCP

Получайте контекстную информацию о Merchant API от помощника по кодированию по вашему выбору. В вашей интегрированной среде разработки (IDE) теперь вы можете получить доступ к интеграции документации разработчика с помощью сервиса Model Context Protocol (MCP). Этот сервис ускоряет разработку для интеграции и миграции, предоставляя вашему помощнику по кодированию авторитетный контекст из официальной документации Google API.

Более подробную информацию о самом протоколе см. в стандарте Model Context Protocol .

Обзор

При переходе с Content API for Shopping на Merchant API или создании новой интеграции вам необходимо понимать структуру новых сервисов, названия ресурсов и методы. Сервис MCP упрощает этот процесс, предоставляя вашему помощнику по программированию официальную документацию и примеры кода.

Сервис использует узкоспециализированную платформу RAG (Retrieval-Augmented Generation). Когда вы задаёте помощнику по программированию в IDE с поддержкой MCP вопрос о Merchant API, сервис извлекает наиболее релевантные фрагменты текста и кода из официальных ресурсов Google и возвращает их вашему помощнику по программированию в качестве контекста. Это позволяет помощнику предоставлять точные и актуальные ответы, не покидая среду разработки.

Как это работает

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

  1. Вы задаёте вопрос в своём помощнике по кодированию или агенте, совместимом с MCP. Это может быть вопрос на естественном языке, запрос примера кода Merchant API или даже запрос на прямой перевод вашего кода в Merchant API.
  2. Ваш помощник по кодированию отправляет запрос контекста в конечную точку MCP.
  3. Служба MCP осуществляет поиск в своей индексированной коллекции официальной документации, руководств и примеров кода Merchant API, чтобы найти наиболее релевантную информацию.
  4. Служба возвращает эти авторитетные фрагменты в качестве контекста вашему помощнику по кодированию.
  5. Ваш помощник по кодированию использует этот высококачественный контекст для генерации точного и полезного ответа на ваш исходный вопрос или для выполнения задачи по переводу кода.

Начиная

Чтобы использовать MCP, выполните следующие действия:

1. Используйте совместимый инструмент.

Откройте IDE или помощника по кодированию, поддерживающего протокол контекста модели с потоковым HTTP-транспортом.

2. Конфигурация конечной точки

Чтобы подключить вашу IDE или помощника по кодированию к MCP, используйте предоставленные данные удаленной конечной точки, для чего может потребоваться ввести либо прямой URL-адрес службы, либо определение MCP (в зависимости от конфигурации вашего инструмента).

URL-адрес сервиса:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

3. Добавьте инструкции агента (необязательно)

Чтобы ваш агент мог напрямую транслировать код с помощью MCP, предоставьте ему системные инструкции: MerchantIntegrator Agent Protocol . Эти инструкции помогут агенту правильно использовать MCP для трансляции кода. В зависимости от используемого инструмента, эти инструкции можно предоставить либо в конфигурации системных инструкций, либо в виде дополнительного файла контекста для агента.

Примеры сценариев использования

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

Сценарий 1: Перенос кода products.insert

Вы можете попросить агента напрямую перенести API контента для products.insert Shopping.Вставьте код интеграции в API Merchant.

Запрос пользователя:

«Перенос products.insert Вставка кода в API продавца»

Предоставив своему агенту системные инструкции: MerchantIntegrator Agent Protocol и доступ к MCP, ваш агент сможет транслировать код Content API for Shopping в код Merchant API непосредственно в вашей IDE. В этом случае он определит productInputs.insert как эквивалентный вызов и сопоставит атрибуты продукта из старого формата с новым, требуемым Merchant API. Он также может обновить требуемые файлы импорта и управления зависимостями (например, requirements.txt , pom.xml или package.json ). Вы можете поручить агенту внести изменения на месте или создать новую папку.

Сценарий 2: Найти эквивалентную функциональность

У вас есть существующее приложение, использующее Content API for Shopping, и вам необходимо его обновить. Вы можете запросить информацию о конкретном устаревшем методе, чтобы получить подробную информацию о новой реализации и соответствующий пример кода.

Запрос пользователя:

«Какой API-эквивалент метода accountstatuses.get в API контента для покупок?»

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

Сценарий 3: Поиск примера кода

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

Запрос пользователя:

«Покажите мне пример кода Python для добавления новой службы доставки с использованием API торговца».

Сервис MCP извлекает соответствующие примеры кода из официальных репозиториев Google GitHub и руководств для разработчиков. Ваш помощник может представить готовый к адаптации блок кода.

Сценарий 4: Понимание концепций API

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

Запрос пользователя:

«Как обновить инвентарь товара с помощью API продавца?»

Служба MCP возвращает контекст из документации по ресурсам продуктов и соответствующих руководств. Ваш помощник может объяснить, как использовать метод accounts.productInputs.insert , и предоставить частичный ресурс продукта, содержащий только productId и поля, связанные с инвентаризацией, которые необходимо обновить.

«Как авторизовать вызовы моего приложения с помощью Merchant API?»

Служба MCP извлекает контекст из официальных руководств по аутентификации, охватывающих различные методы авторизации. Ваш помощник может объяснить основные доступные варианты, например, использование учётной записи службы для взаимодействия между серверами или идентификатора клиента OAuth 2.0 при работе от имени пользователя.

Сценарий 5: Адаптация к изменениям API

API Merchant представляет новые шаблоны, такие как пакетные запросы, которые отличаются от Content API for Shopping. API Content for Shopping использует специальные методы custombatch , в то время как API Merchant использует встроенную функцию пакетной обработки HTTP.

Запрос пользователя:

«Какой новый способ создания products.custombatch в API Merchant?»

Служба MCP извлекает контекст из кода рефакторинга для параллельных запросов , объясняя, что в API Merchant отсутствуют специальные методы custombatch . Вместо этого она предоставляет документацию по использованию HTTP-пакетирования с Content-Type multipart . Ваш помощник может объяснить, как создать один HTTP-запрос, содержащий несколько вызовов API, отправленный на конечную точку https://merchantapi.googleapis.com/batch/{sub-api}/v1 , и предоставить пример структурирования multipart-запроса. Это превращает потенциально запутанную задачу миграции в управляемый процесс.

Сценарий 6: Перевод отчетного запроса

Вы можете попросить агента перевести отчетный запрос из Content API for Shopping в Merchant API.

Запрос пользователя:

«Перенесите этот отчетный запрос из Content API в Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'»

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

Источники базы знаний

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

Назад
Client libraries
Далее
Overview