CUGA（Configurable Generalist Agent）は、IBMが開発したオープンソースのエージェントハーネスであり、エージェントアプリケーションの構築に伴う面倒な配管作業を処理します。ほとんどのエージェントプロジェクトでは、モデルクライアントの設定、ツールアダプターの作成、状態のストリーミングなどに多くの時間を費やしますが、CUGAはこれらの部分を抽象化し、開発者はツールリストとプロンプトの定義に集中できます。
CUGAの実用性を示すために、IBMはcuga-appsを構築しました。これは24の単一ファイルアプリケーションのコレクションで、各アプリはCugaAgentインスタンスをラップした独立したFastAPIファイルです。これらのアプリは、映画レコメンダーからIBM Cloudアーキテクチャアドバイザーまで多岐にわたり、読み取り可能でコピー可能なスターターポイントとして機能します。
本記事では、そのうちの1つであるIBM Cloudアドバイザーアプリについて詳しく説明します。このエージェントのコアコードは非常にシンプルです。ファクトリー関数がCugaAgentインスタンスを作成し、モデル、ツールリスト、特別な指示を渡します。モデルは動的に作成され、OpenAI、Anthropic、watsonxなど複数のプロバイダーをサポートしており、アプリコードは使用するモデルを意識する必要はありません。ツールは2つのカテゴリに分けられます。ローカルで定義されたPython関数（例：IBM Cloudカタログの検索）と、MCPサーバー経由で取得される汎用ツール（例：Web検索）です。プロンプトは順序だった手順として設計され、存在しないサービス名を作り出さないように明示的に禁止しています。
CUGAの計画メカニズムは重要な利点の1つです。行動前に計画を立て、ツール呼び出しと生成コード（CodeAct）を組み合わせて実行します。長時間のタスクでは、中間結果を追跡し、リフレクションステップを実行してエラーが発生した場合に再計画を行います。これにより、AppWorldやWebArenaなどのベンチマークでトップの成績を収めています。また、Fast、Balanced、Accurateの3つの推論モードと、コード実行用のサンドボックス（ローカル、Docker/Podman、E2Bクラウド）をサポートしています。
さらに、CUGAはエージェントの動作を制御するポリシーシステムを提供します。例えば、Intent Guardで特定のリクエストをブロックしたり、Tool Approvalでリスクのあるツール呼び出し前に人間の承認を待ったり、Playbookで既知の良い手順を固定したりできます。これらのポリシーは実行時に適用され、エージェントが本番環境で安全に動作することを保証します。
cuga-appsは単なるデモではなく、再利用可能なライブラリです。アプリは研究、日常生産性、ドキュメント・メディア、運用、エンタープライズなどのカテゴリに分類されています。例えば、Ouroborosは7つのエージェントからなるリード獲得システムで、マルチエージェントの協調を示しています。Meetup FinderはPlaywrightを介してヘッドレスChromiumを操作し、イベント情報を抽出することで、ブラウザ自動化の能力を実証しています。
要約すると、CUGAはこれらの複雑なコンポーネントを事前に組み立てることで、エージェントアプリケーションの開発を大幅に簡素化します。単純な知識検索からマルチエージェント連携システムまで、開発者はcuga-appsから適切なスターターポイントを見つけ、必要に応じて調整できます。