29 сентября 2026 г.

OpenAI Codex быстро стал одним из самых широко используемых агентов для написания кода, и легко понять почему: он пишет реальный код, запускает его и продолжает итерации до тех пор, пока тесты не будут пройдены. Чего Codex не знает сам по себе, так это того, действительно ли API, к которому вы обращаетесь, ведет себя так, как вы ожидаете. У него также нет способа узнать, существует ли заглушка (mock) для конечной точки, которую вы еще не создали, или решила ли ваша команда эту конкретную задачу где-то в рабочем пространстве Postman.

Вот почему мы рады представить сегодня плагин Postman для Codex. Он переносит навыки агента Postman прямо в ваши сессии Codex. Попросите его о чем-то вроде @Postman преврати эту спецификацию OpenAPI в рабочий сервер-заглушку, и он запустит реальный Postman CLI в фоновом режиме, вместо того чтобы Codex угадывал команды curl по памяти. В этой статье я расскажу о двух способах установки, а затем покажу два навыка в действии: поиск уже существующего API и создание заглушки для того, которого еще нет.

Что вам понадобится

OpenAI Codex (CLI, расширение для IDE или приложение Codex)
Node.js 18 или более поздней версии, если вы устанавливаете через Postman CLI
Учетная запись Postman (бесплатного плана достаточно, он требуется только при отправке заглушки или поиске в рабочем пространстве)

Два способа установки плагина

Файлы навыков находятся в одном репозитории, postman-skills, и каждый путь установки указывает на одну и ту же директорию skills/. Это означает, что навыки, которые вы получаете через Postman CLI, и навыки, полученные из магазина плагинов Codex, идентичны. Выбирайте то, что лучше подходит к вашему рабочему процессу.

Вариант 1: Установка с помощью Postman CLI

Если вы предпочитаете развертывать навыки на уровне репозитория, чтобы и вы, и любой автономный агент, работающий в этом репозитории, могли их использовать, установите Postman CLI:

Затем, в новом или существующем проекте:

Команда postman init извлекает текущие навыки из репозитория навыков Postman и записывает их в ваш проект вместе с файлами SKILL.md, которые сообщают Codex, как и когда их использовать. Она также связывает репозиторий с рабочим пространством Postman, что необходимо для поиска и работы графа контекста, чтобы в дальнейшем находить существующие коллекции вашей команды. Навыки со временем устаревают, поэтому проверяйте их с помощью:

Запускайте postman skills update, когда эта команда сообщает, что вы отстали от актуальной версии. Добавьте --strict в CI, если хотите, чтобы устаревший набор навыков приводил к сбою сборки, а не просто тихо устаревал.

Вариант 2: Установка из магазина плагинов Codex

Если вы работаете в рамках одной сессии Codex и вам не нужно фиксировать навыки в репозитории, установите плагин напрямую:

Или пропустите терминал: откройте Codex, перейдите в Plugins, найдите «Postman» и выберите Add.

Список плагинов показывает, что он умеет, еще до установки: создание коллекции и запуск тестов, создание заглушки по спецификации или оценка API на готовность к работе с ИИ.

Этот путь также подключает MCP-сервер по адресу mcp.postman.com, поэтому вызовы инструментов, которые Codex делает к Postman, аутентифицируются и отслеживаются плагином, а не просто файлами навыков, лежащими на диске.

Поздоровайтесь с @Postman

Независимо от того, как вы его установили, Codex теперь распознает @postman как упоминание, так же как он распознает путь к файлу или задачу:

Ввод @postman в Codex вызывает плагин так же, как он вызывает файлы, задачи и другие плагины.

Опишите, что вы создаете, и плагин порекомендует, что для этого нужно. Вам не обязательно знать базовые команды Postman CLI. Файлы навыков переводят ваш запрос в нужные команды и выполняют их за вас.

Узнайте, существует ли нужный вам API

Прежде чем Codex напишет интеграцию по памяти, стоит проверить, существует ли API уже — либо как нечто, созданное вашей командой, либо как публичный API, поддерживаемый кем-то другим. Это навык api-discovery. Он объединяет три вещи: поиск Postman по всему, что уже есть в ваших рабочих пространствах Postman, граф контекста для понимания зависимостей сервисов друг от друга и Orbit для публичных сторонних API, для поиска которых не требуется регистрация или ключ API.

Если внутри ничего не найдено, навык делает запрос к Orbit вместо того, чтобы гадать. Конечная точка поиска Orbit возвращает подходящие публичные API, включая информацию о том, чего каждый из них не умеет, а не только о том, что умеет. Его конечная точка интеграции превращает выбранный вами вариант в техническое задание с требованиями к аутентификации и известными подводными камнями, используя примерно в 27 раз меньше контекста, чем загрузка полной спецификации OpenAPI поставщика. Это важнее, чем кажется: загрузка спецификации поставщика, чтобы ответить на вопрос «поддерживает ли этот API вложения», — это слишком много контекста для ответа «да» или «нет».

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

context-graph ask сопоставляет коллекции и спецификации Postman с репозиториями GitHub и развертываниями, подключенными через Agent Context, поэтому ответ не ограничивается тем, что загружено локально. Относитесь к полученному результату как к подсказке, которую стоит проверить по исходному коду, а не как к доказательству; граф обновляется каждую ночь, поэтому сервис, добавленный вчера, еще не появится.

Создайте заглушку API до того, как он появится

Второй навык, который стоит попробовать первым, — это api-mocking. Он поднимает фиктивный бэкенд из коллекции или спецификации OpenAPI, работая локально как обычный процесс Node, с переопределениями для каждого запроса для тестирования путей сбоя без обращения к реальному серверу.

Вот реальный промпт и то, что Codex сделал с ним:

Один промпт, три сценария заглушки, git-ориентированная тестовая коллекция и успешный запуск — все это благодаря навыку api-mocking.

Это привело к созданию трех сценариев: default, empty-catalog и catalog-unavailable. Он также добавил git-ориентированную коллекцию с повторно используемыми утверждениями, переменную окружения для перенаправления работающего приложения на заглушку вместо продакшена и команду npm run mock:test, встроенную в существующий набор тестов. Запуск прошел успешно: 6 запросов к заглушке, 16 утверждений, 0 ошибок.

Как только заглушка запущена, вы можете переключать сценарии или отправить ее коллеге, не написав ни одной команды Postman CLI самостоятельно. Просто скажите Codex, что вам нужно, например, @Postman переключи заглушку checkout на сценарий empty-catalog или @Postman отправь эту заглушку, чтобы QA мог ее протестировать, и навык сделает все остальное.

Попробуйте сами

Установите плагин, а затем попросите его о чем-то конкретном, а не о чем-то общем:

@Postman существует ли уже API для [того, что вы собираетесь создать] в нашем рабочем пространстве?
@Postman преврати эту спецификацию OpenAPI в сервер-заглушку со сценарием для ошибки 500
@Postman готов ли этот API к работе с агентами?

Последний запрос запускает навык ai-readiness, который оценивает коллекцию или спецификацию именно по тому критерию, ради которого стоит использовать этот плагин: может ли агент, вызывающий ваш API, восстановиться, когда что-то идет не так, а не только когда все работает идеально.