AI時代のAPIファースト開発

by 草薙昭彦

Embed

Start on current slide

Slide 1

Slide 1 text

Slide 2

Slide 2 text

テクノロジーエバンジェリスト Postman 株式会社草薙昭彦 @postman_japan @nagix

Slide 3

Slide 3 text

本日のトピック ● ソフトウェアの価値が転換する ● AI-Ready な API：仕様とテストの両輪 ● コンセプトを振り返る：なぜ今「API ファースト」なのか ● Postman：AI 時代の資産を構築するプラットフォーム ● 結びに代えて @postman_japan

Slide 4

Slide 4 text

ソフトウェアの価値が転換する @postman_japan

Slide 5

Slide 5 text

2026年、私たちが目撃している「 UI の死」 @postman_japan ヘッドレス SaaS の時代？ SaaS の価値は「使い勝手」から「接続性」へユーザーは画面を操作せず AI エージェントに目的を伝える

Slide 6

Slide 6 text

ソフトウェア市場の主役が人間から AI へ 2030年にはソフトウェア市場の利益の 60% 以上を AI エージェントが占める @postman_japan 参考: 大手金融機関によるソフトウェア市場予測（ 2024） “ “ 大規模言語モデル（ LLM）は、AI エージェントを介してワークフローや API と接続する

Slide 7

Slide 7 text

実装は安価になり、使い捨てられる ● AI によってコード生成が極限まで高速化した結果、苦労して書いた実装コードそのものの希少価値は低下した @postman_japan

Slide 8

Slide 8 text

仕様はガードレールにならない @postman_japan 仕様を形にすることも重要だが、それはエージェントに対するガードレール（強制力）にはならない

Slide 9

Slide 9 text

テストコードの価値が「跳ね上がる」 @postman_japan 実装に価値はなくなるが、テストコードさえあれば理論上その仕様を再現できるテストこそが唯一の資産になる時代

Slide 10

Slide 10 text

AI-Ready な API：仕様とテストの両輪 @postman_japan

Slide 11

Slide 11 text

AI エージェントを制御する二つの鍵 ● 仕様（Spec）： AI に「何をすべきか」を正しく伝える地図 ● テスト（Test）： AI が「正しく動いているか」を保証するガードレール @postman_japan

Slide 12

Slide 12 text

AI エージェントの行動モデルと統計的な制約 ● ReAct (Reasoning and Acting) 行動モデル ○ 目標とコンテキストから出発し、推論と行動を繰り返して達成に向かう ● 動作は統計的・確率的。コンテキストウィンドウという記憶の限界 LLM（頭脳） - 推論 - 計画立案 AI エージェント - LLM に問い合わせ - 外部ツール実行 - コンテキスト管理インプットアウトプット @postman_japan

Slide 13

Slide 13 text

API は AI 時代の最適な抽象化レイヤー ● API は、中身の複雑さを隠蔽し、AI が理解しやすいサイズにパッケージングされた「知能のための手足」である ● AI は API を部品として扱うことで、コンテキストウィンドウの制約を回避し、より複雑なシステムの構築が可能になる ● 開発者の仕事は低レイヤーの実装から高レイヤーの境界設計へシフトする @postman_japan 境界としての API 複雑なサービス実装 AI の意図 AI エージェント or AI 生成実装

Slide 14

Slide 14 text

AI-Ready な API 設計の考慮ポイント ● 機械可読な標準仕様の採用 ● 型情報やスキーマ構造の明確化 ● 一貫性のある設計 ● セマンティックな命名 ● 説明やメタデータの充実 @postman_japan API コントラクト API 提供者 API 利用者 API リクエスト参照参照 API レスポンス OpenAPI 型意味 OpenAPI 仕様の例：上の要素を備えた API 仕様は AI に明確なコンテキストを提供する MCP (Model Context Protocol) はさらに AI に最適化したプロトコル

Slide 15

Slide 15 text

非決定的な AI を、決定的な仕様とテストで制御する ● 曖昧な仕様をテストケースで縛ることで、AI エージェントおよび AI が生成した実装の誤操作を論理的に遮断する @postman_japan API クライアント側自動テストのロジック（コード）を用意し、AI の出力が期待通りかを常に検証するガードレールを作る。 API サーバー側仕様に基づいた厳格なバリデーションを行う。仕様にない値が来たら、即座にエラーと詳細な修正ヒントを返す。

Slide 16

Slide 16 text

資産としてのテストシナリオ ● 複雑なビジネスロジックをテストシナリオとして記述し、AIに「これを通せ」と命じる開発スタイル @postman_japan

Slide 17

Slide 17 text

AI-Ready API の再定義 ● 「型（厳密性）」「意味（セマンティクス）」「テスト（信頼性）」が揃って初めて、AI は API を使える @postman_japan 型（厳密性）意味（セマンティクス）テスト（信頼性） AI-Ready

Slide 18

Slide 18 text

コンセプトを振り返る：なぜ今「APIファースト」なのか @postman_japan

Slide 19

Slide 19 text

API ファーストの二つの側面 @postman_japan 開発アプローチ実装より先に設計し、 API を「真実のソース」とするビジネス戦略 API を機能の提供手段ではなく、価値を生むプロダクトとして扱う

Slide 20

Slide 20 text

API 仕様作成モック作成テスト作成ドキュメント作成 API 実装コーディングテスト API 統合フィードバック仮説検証 API 設計 API ファースト開発アプローチ ● 実装の前にフィードバックループを回して仕様を洗練させる ● 合意された仕様をもとに、実装、テストを独立・並行に進める @postman_japan

Slide 21

Slide 21 text

API-as-a-Product（製品としての API） ● UI が消える世界では、外部（AI エージェント）があなたの会社を評価する唯一の接点は API ○ API が使いにくい＝プロダクトが存在しないのと同じ ○ API を製品として磨くことが、AI 時代のマーケティングであり、ビジネス戦略になる @postman_japan

Slide 22

Slide 22 text

実装（How）から設計（ What）へ ● 実装（コード）は AI が生成できる。人間が担うべきは「何を提供するか」というプロダクトとしての定義（仕様とテスト） @postman_japan

Slide 23

Slide 23 text

Postman：AI 時代の資産を構築するプラットフォーム @postman_japan

Slide 24

Slide 24 text

Postman - AI 時代の資産「テストと仕様」の管理基盤 @postman_japan 標準化 ↑ （API 再利用の向上、ドキュメントの標準化、テスト自動化） API 機能障害 ↓ （ドキュメントの標準化、テスト自動化、ワークフロー効率化）開発生産性 ↑ （仕様の再利用、環境の標準化、API コレクションの共有）統合 API 管理プラットフォーム仕様設計テストガバナンス CI/CD 標準化された API ライフサイクルと変更管理

Slide 25

Slide 25 text

【設計】AI が理解可能な高精細な API 仕様の作成 ● 機械にも人間にも伝わる、最適な説明（description）やサンプル（example）を含む仕様の編集と管理 @postman_japan SpecHub：ビジュアルな API 仕様編集・管理ツール

Slide 26

Slide 26 text

【検証】AI のガードレールとしてのガバナンス ● セキュリティや一貫性が保たれているかを Linting で常に自動検証 @postman_japan 豊富なビルトインガバナンスルールカスタムルールの定義も可能開発者が自律的にガバナンス状況を意識する

Slide 27

Slide 27 text

【テスト】資産としてのテストコレクション ● 仕様からテストスクリプトを自動生成 ● AI エージェントの動作の不確実さを許さない強固な API を作る @postman_japan テストシナリオの管理 AI がテストを生成

Slide 28

Slide 28 text

【共有】AI エージェントへの接続 ● Postman に蓄積された「テスト済みの API 知見」を AI エージェントに直接受け渡す @postman_japan Agent Mode：Postman に組み込まれたエージェントによる作業の自律実行 Postman プラットフォーム AI エージェント MCP 外部の AI エージェントによる Postman API 資産の活用ファイル & ディレクトリファイルアクセス API 資産の同期

Slide 29

Slide 29 text

デモ：AI-Ready な API 開発フロー @postman_japan

Slide 30

Slide 30 text

結びに代えて @postman_japan

Slide 31

Slide 31 text

実装者から「境界の設計者」へ ● コードを書く苦労から解放され、より本質的な価値の定義（仕様とテスト）に集中する ● 私たちの役割は、AI という巨大な力を、API という契約（仕様とテスト）で導くこと @postman_japan

Slide 32

Slide 32 text

まとめ ● UI が消える世界で、API は製品そのものになる ● AI 時代、実装の価値は下がっても「仕様とテスト」は資産として残り続ける ● Postman で、AI を制御し、価値を創出する API 開発を @postman_japan

Slide 33

Slide 33 text

本を書きました @postman_japan

Slide 34

Slide 34 text

API ファースト開発アプローチについて学べる書籍 https://amzn.asia/d/0SdTMlO @postman_japan

Slide 35

Slide 35 text

ありがとうございました @postman_japan