🐙

Postman Agent Mode (2) Skills

に公開

今日は前回に引き続きPostman Agent Modeを触っていきます。今日はSkillsという機能を触ってみます。
https://zenn.dev/kameoncloud/articles/deed082e772112

Postman Agent Mode Skills

Postman Agent Mode はAI AgentがAPIの設計、テストの作成と実行、API設計書のレビューなどを行ってくれる開発を促進させるのに役立つツールです。Skillsは、複数のステップにまたがる作業を自動化するためのテンプレートのようなもので、Agent Mode がユーザーの意図を理解して一連の処理を実行できるように設計されています。

Skillsを使わなくても対話型でAgent Modeを使うことはできますが、Skillsを使うことでよく行われる可能性のある機能がまとまっているものを一度に利用することができるため便利です。

Skills 一覧

テンプレートは以下が用意されています。

Share With Your Team
指定したコレクションを新しいプライベートワークスペースにフォークし、新しいモックサーバーを作成します。

Create Test Coverage Report
コレクションのテストカバレッジ(テスト網羅率)に関するレポートを作成します。

Run Health Check
コレクションの正常性チェック(ヘルスチェック)を実行します。

Scan For Conflicts
API仕様書、コレクション、リクエスト例、テスト間の不整合を検出し、差分レポートを生成します。

Validate Collection Quality
Postmanの品質ベストプラクティスに基づき、コレクションを自動的に検証します。

Clone Workspace
新しいワークスペースを作成し、現在のワークスペース内のリソースをクローン(複製)します。

Publish Collection
ソースコレクションを宛先コレクションにコピーします。宛先が存在しない場合は自動的に作成されます。

Create Prototype
AIが生成したコレクションを作成し、モックサーバーを構築します。手動設定なしでアイデアのプロトタイピングを開始できます。

Export Documentation
コレクションのドキュメントをMarkdown形式でエクスポート(出力)します。

Score Spec for AI Readiness
API仕様を自動スキャンして「AIスコア」を算出します。あなたのAPIはAI活用に対応できているかを評価します。

さっそくやってみる

Skillsの利用はとてもシンプルです。Agent Modeでプロンプトを入力する際に/と入力すればテンプレートが出てきますのでそちらを選択するだけです。

以下の様に入力して実行してみます。

以下の様なレスポンスが戻りAPI群が作成されています。

写真投稿サイトのひな型APIコレクションを作成し、写真やユーザーのCRUD操作を含めたエンドポイントを用意しました。また、PostmanのMockサーバーと接続し、baseUrlもMockサーバー用に自動で更新しています。

これにより、実際のバックエンド実装がなくても、APIのテストやフロントエンドとの連携をすぐにPostman上で試すことができます。

次のステップとしてできること:

作成されたコレクションやMockサーバーのエンドポイントを確認・編集
モックAPIを使ってフロントエンド開発やAPIテストを実施
必要に応じてエンドポイントやレスポンス例を追加・修正
他にも、APIドキュメントの自動生成やテストスクリプトの追加などもサポートできます。ご希望があればお知らせください!

次にexport documentスキルを実行すると以下の様にAPIドキュメントが出力されます。

APIドキュメント
ドキュメントをMarkdownとしてエクスポートしました。以下がコレクション「写真投稿サイト API」のドキュメントです。対象のエンドポイント「ユーザー詳細取得」も含まれています。

写真投稿サイト API ドキュメント
このAPIは、写真投稿サイトのクライアントアプリケーションで「写真」と「ユーザー」に関する操作を行うためのエンドポイントを提供します。基本URLは {{baseUrl}} です。

写真関連エンドポイント

写真一覧取得
メソッド: GET
パス: /photos
説明: すべての写真の一覧を取得します。
例 200:
[ { "id": 1, "title": "夕焼け", "url": "
https://example.com/photo1.jpg
", "userId": 1 }, { "id": 2, "title": "桜", "url": "https://example.com/photo2.jpg", "userId": 2 } ]

写真投稿
メソッド: POST
パス: /photos
説明: 新しい写真を投稿します。
リクエスト例:
{ "title": "海辺", "url": "
https://example.com/photo3.jpg
", "userId": 1 }

例 201:
{ "id": 3, "title": "海辺", "url": "
https://example.com/photo3.jpg
", "userId": 1 }

写真取得
メソッド: GET
パス: /photos/{photoId}
説明: 指定した ID の写真データを取得します。
例 200:
{ "id": 1, "title": "夕焼け", "url": "
https://example.com/photo1.jpg
", "userId": 1 }

写真更新
メソッド: PUT
パス: /photos/{photoId}
説明: 指定した写真の情報を更新します。
リクエスト例:
{ "title": "更新された夕焼け", "url": "
https://example.com/photo1_new.jpg
" }

例 200:
{ "id": 1, "title": "更新された夕焼け", "url": "
https://example.com/photo1_new.jpg
", "userId": 1 }

写真削除
メソッド: DELETE
パス: /photos/{photoId}
説明: 指定した ID の写真を削除します。
例 204: 空レスポンス
ユーザー関連エンドポイント

ユーザー一覧取得
メソッド: GET
パス: /users
説明: 全ユーザー情報を一覧取得します。
例 200:
[ { "id": 1, "name": "山田太郎" }, { "id": 2, "name": "佐藤花子" } ]

ユーザー作成
メソッド: POST
パス: /users
説明: 新規ユーザーを作成します。
リクエスト例:
{ "name": "鈴木一郎" }

例 201:
{ "id": 3, "name": "鈴木一郎" }

ユーザー詳細取得
メソッド: GET
パス: /users/{userId}
説明: 指定した ID のユーザー情報を取得します。
例 200:
{ "id": 1, "name": "山田太郎" }

ユーザー更新
メソッド: PUT
パス: /users/{userId}
説明: 指定IDのユーザー情報を更新します。
リクエスト例:
{ "name": "山田太郎(更新)" }

例 200:
{ "id": 1, "name": "山田太郎(更新)" }

ユーザー削除
メソッド: DELETE
パス: /users/{userId}
説明: 指定IDのユーザーを削除します。
例 204: 空レスポンス
備考

{photoId} と {userId} は各リソースのユニークIDです。
すべてのリクエスト・レスポンスは JSON 形式です。
関連リンク

コレクション: 
写真投稿サイト API
リクエスト(ユーザー詳細取得): 
ユーザー詳細取得
他に、エクスポートしたMarkdownをファイルに保存する、公開用に整形する、またはコレクションの公開ドキュメントとして配信することも可能です。希望の形式(ファイル出力、公開リンク作成など)を教えてください。

Run Health Check

Run Health Checkというコレクションに対してヘルスチェックを自動で作成し実行してくれるSkillsも備わっているようですが、記事執筆時点(2025年11月4日)では正しく動作していませんでした。これはテストを革命的にスムーズにしてくれる機能と期待しており動いたらまた報告したいと思います!

Discussion