Akira

Posted on Apr 17 • Originally published at apidog.com

Google Agent Smith コードの25%を作成: APIチームが知っておくべきこと

#agents #ai #api #automation

要約

Googleの社内AIコーディングエージェント「Agent Smith」は、同社の新しい本番コードの25%以上を自動生成しています。このAIはCopilotのような補完型ツールとは異なり、バックグラウンドで非同期にコード作成・テスト・反復を自律的に行います。APIチームは、機械生成コードが増加する中で、契約の安定性、テストカバレッジ、ドキュメント同期、レビュー体制の強化が不可欠となります。

Apidogを今すぐ試してみよう

💡 Apidogの統合APIライフサイクルプラットフォームは、人間またはAIエージェントが変更を行うかどうかにかかわらず、デザイン、テスト、モック、ドキュメントを同期させます。エージェント対策済みのAPIワークフローを構築するために、Apidogを無料で試してみてください。

この記事では、Agent Smithの技術的な特徴と、APIチームが直面する課題、その実践的な対策方法を解説します。

Agent Smithの機能

非同期自律型コーディング

Agent SmithはIDEでの手動操作を不要とし、以下のワークフローでバックグラウンド動作します。

エンジニアがタスクを自然言語で記述
Agent Smithがタスクをサブタスクに分割
複数ファイルに渡りコードを自律生成
テストを自動実行し、失敗時は反復
エンジニアが最終成果物をレビュー

Copilotなどのインライン補完型とは異なり、「タスク委任→数時間後にPRで結果報告」という、ジュニア開発者のような振る舞いです。社内チャット経由でタスク管理・進捗確認も可能です。

GeminiとAntigravityを基盤とする

Agent SmithはGoogle Geminiモデル＋社内コード・ドキュメント検索基盤（Antigravity）で動作します。コード生成時に社内の既存実装やコーディング規約を参照し、コンテキスト認識にも優れています。これが本番品質の大量自動生成を可能にしています。

「新しいコードの25%」が意味するもの

この25%は「AIが自律生成し、人間のレビューを経て本番出荷された新規コード」です。コードベース全体の25%ではなく、毎日新たにコミットされるコードの25%が該当します。今後さらに割合は増加する見通しです。

Agent Smithが他のAIコーディングツールと異なる点

AIコーディングツールの分類

ツール	モード	インタラクション	スコープ	本番コード?
GitHub Copilot	リアルタイム自動補完	IDE内インライン	行/関数レベル	人間が受け入れた後
Claude Code	インタラクティブ	会話型	複数ファイル変更	人間がレビューした後
Cursor Agent	バックグラウンド+対話	IDE組み込み	プロジェクトレベル	人間がレビューした後
Agent Smith	非同期自律型	タスク委任	フル機能実装	人間がレビューした後
KAIROS (未リリース)	常時稼働デーモン	バックグラウンド監視	リポジトリ全体	未定

Agent Smithは自律型寄りで、タスクを受けて人間の介入なく動作します。完全自律デプロイは現状ありません。

APIチームにとって非同期が重要な理由

リアルタイム型AIツールは開発者の文脈内で動きますが、Agent Smithのような非同期エージェントでは、開発とレビューの時間的・文脈的な断絶が発生します。これにより、以下の課題が顕在化します。

エージェントの設計意図が不明瞭
API契約変更が見逃されるリスク
テスト・ドキュメント・モックの同期漏れ
破壊的変更の見落とし

AIがAPIコードを書く際の主な問題

API契約のずれ

API契約（OpenAPI等）はサービスと消費者間の合意です。自律エージェントが契約を更新せずにエンドポイントやスキーマを変更すると、下流システムで予期しない障害が発生します。

例:

GET /api/users/{id} のレスポンスに preferences フィールドを追加
既存テストはフィールド追加を検知しない
フロントやモバイルが型エラーやパースエラーを起こす

テストカバレッジのギャップ

AIエージェントは自身が生成した動作のテストのみ書く傾向があり、回帰テストや旧仕様維持の確認は手薄です。結果として、応答スキーマ、レート制限、エラー構造、認証、ページネーション等で従来仕様との乖離が生じやすくなります。

ドキュメントのずれ

仕様が唯一の情報源でなければ、エージェントの変更がドキュメントに反映されず、利用者に最新情報が伝わらないリスクが高まります。AIは「なぜ」や利用上の注意まで自動で記述できません。

レビュー疲労

AI生成コードは一見正しく見えるため、レビュアーがアーキテクチャ的・慣習的な問題を見逃しやすくなります。これが「形だけの承認（rubber-stamping）」を加速させます。

エージェントに強いAPIワークフローの構築方法

1. API契約を唯一の真実の情報源にする

デザインファーストでOpenAPI仕様を先に定義し、全ての実装・テスト・ドキュメントはこの仕様に従うようにします。

デザインファーストでない例:

コード変更 → テストパス → 出荷 → 契約破損

デザインファースト例:

仕様が契約を定義 → コードは仕様と一致 → 検証でずれを検出

ApidogのビジュアルAPIデザイナーを使えば、エージェント生成コードも仕様基準で自動検証可能です。

2. ユニットテストではなく契約テストを使用する

ユニットテストは内部動作のみ、契約テストは外部合意（API応答）を検証します。

契約テスト例（Jest + Schema検証）:

describe("GET /api/users/:id contract", () => {
  it("returns expected schema", async () => {
    const response = await request(app).get("/api/users/123");

    expect(response.body).toMatchSchema({
      type: "object",
      required: ["id", "name", "email", "created_at"],
      properties: {
        id: { type: "string" },
        name: { type: "string" },
        email: { type: "string", format: "email" },
        created_at: { type: "string", format: "date-time" }
      },
      additionalProperties: false  // 予期しないフィールドを検知
    });
  });
});

additionalProperties: false を必ず指定しましょう。Apidogならスキーマからの契約テストを自動化できます。

3. 仕様検証によるデプロイ制御

CI/CDパイプラインに契約検証ステップを追加し、仕様違反があれば本番反映を停止します。

# CI/CD pipeline step
- name: Validate API contract
  run: |
    apidog run --test-scenario-id CONTRACT_TESTS
    if [ $? -ne 0 ]; then
      echo "API contract violation detected. Review changes."
      exit 1
    fi

4. API変更には仕様更新を義務付ける

APIの動作を変更するPRは必ずOpenAPI仕様の更新を含めるルールを徹底しましょう。Apidogを使えば、仕様変更がドキュメント・モック・テスト・SDK型に自動伝播します。

5. 本番API動作の監視

本番環境で以下を継続監視します。

応答スキーマ違反
新規フィールド出現
エラー率やレイテンシの異常
トラフィックパターン変化

6. APIレビューとコードレビューの分離

API変更には以下のチェックリストで専用レビューを設けます。

既存消費者を壊していないか
OpenAPI仕様が更新されているか
後方互換性のない変更のバージョン管理
エラー応答の一貫性
ドキュメント・例の追加
ダウンストリームへの通知

軌跡：自律型コーディングの未来

今日のAgent Smithと明日のAgent Smith

「25%」は始まりに過ぎません。今後、他社でも同様のエージェント型コーディングツール（KAIROS, Copilot Agent Mode, CodeWhisperer等）が拡大します。APIコードの主要部分がAI生成となる時代に備え、APIワークフローの堅牢化が急務です。

APIチームが今準備すべきこと

デザインファースト：OpenAPI等の仕様を唯一の情報源とする
契約テストの導入：ユニットテストだけでなく契約テストをCI/CDに組み込む
成果物同期ツールの選定：Apidogのような統合プラットフォームで仕様・テスト・ドキュメント・モックの同期自動化
AI生成コード専用のレビュープロセス構築：API契約違反専用の自動検証・レビューチェックリストを整備

Apidogを使えば、人間・Agent Smith・次世代AIいずれのコード変更にも一貫したAPIワークフローを維持できます。

よくある質問

Google Agent Smithとは何ですか？

Agent SmithはGeminiモデル＋Antigravity基盤によるGoogle社内AIコーディングエージェントです。エンジニアがタスクを割り当てると、バックグラウンド非同期でコード生成・テスト・反復を自動実行。2026年3月時点で新規本番コードの25%以上を生成しています。

Agent SmithはGoogle以外でも利用できますか？

いいえ。Agent SmithはGoogle社員限定の社内ツールです。一般公開予定はなく、技術はCopilot Agent ModeやClaude Codeに類似しつつも、深くGoogle社内基盤に統合されています。

AI生成コードはAPI契約を破る可能性がありますか？

あります。AIエージェントは指定テストをパスするコードを生成しますが、テストが契約の全てをカバーしているとは限りません。スキーマ変更や新規フィールド、エラー仕様変更が下流を壊すリスクがあります。契約テストとデザインファースト開発で防ぐことが必須です。

APIチームはAgent Smithについて心配すべきですか？

Agent Smith自体はGoogle専用なので直接心配不要ですが、同様の自律エージェント導入は今後加速します。今からデザインファースト、契約テスト、統合ツールによるAPIワークフローを用意しておくべきです。

AIエージェントが私のAPIを壊すのをどう防げますか？

OpenAPI仕様を唯一の情報源にし、デザインファースト開発を徹底。additionalProperties: false を使った契約テスト、仕様検証によるデプロイ制御、Apidogのような自動同期プラットフォームの活用が有効です。

AI支援コードとAI生成コードの違いは？

AI支援コード（Copilot等）は人間の監督下でリアルタイム生成されます。AI生成コード（Agent Smith等）は人間の関与なしに非同期生成され、レビューは事後になります。この違いが契約違反のリスクを高めます。

AIエージェントはAPI開発者を置き換えますか？

置き換えません。Agent Smithでも人間によるタスク定義・レビュー・デプロイ承認が必要です。AIは生産性を向上させますが、判断・コンテキスト・設計は人間の役割です。

重要なポイント

GoogleのAgent Smithは非同期自律型エージェントで、新本番コードの25%を生成
AI支援からAI生成への移行でAPIレビュー体制も変化
主なリスクはAPI契約のずれ、テストカバレッジ・ドキュメント同期漏れ
デザインファースト開発と厳格な契約テストが必須
Apidogのような統合プラットフォームで成果物同期を自動化
自律型コーディングエージェントの普及は加速中。今すぐAPIワークフロー強化を

25%のAgent Smithは始まりに過ぎません。エージェントに強いAPIワークフローを今構築する企業こそが、明日、自律型コーディング時代をリードできます。

DEV Community