決定論的ツールによる信頼性の確保

AIエージェントは非決定論的な挙動をしますが、それらがアクセスする外部ツールは「決定論的」で予測可能でなければなりません。初期のプロトタイプ開発では、エージェントに生のAPI呼び出しを直接構築させることが一般的ですが、これには重大な落とし穴があります。

「Shippy」の開発プロセスでは、エージェントが生のAPIを直接構築した結果、ページネーションのバグやジオメトリのエンコーディングエラーが頻発し、不正確な結果が返される事態に直面しました。そこで、API通信を直接行わせるのではなく、自己ドキュメント化された専用の「CLI（Command Line Interface）」を仲介させるレイヤリング構造を採用しました。

エージェントは「skylight events search」のような型定義されたフラグを持つ単一コマンドを呼び出し、CLIが裏側で認証やエラー処理を完璧にこなします。さらに、出力結果はシェルパイプではなく、ローカルのJSONファイルに書き出すことで、データ制限によるクラッシュを防ぎ、複数ステップにわたる分析を安全に継続させます。

---