シンプルなチャットボットからマルチエージェントシステムまで、生成AIエージェントの手法を学べる実行可能なJupyter notebookチュートリアルを50本以上収録しています。
cuga-project/cuga-agent
業務上の依頼を、ポリシー制御とプライベート環境へのデプロイに対応しながら、アプリ、API、文書を横断するアクションに変換するエンタープライズ向けエージェント基盤。
- スター
- 1,137
- フォーク
- 208
- 未解決の Issue
- 244
- 最終コミット
- 一昨日
これは何?
CUGAは、エンタープライズの自動化を目的としたオープンソースの汎用エージェント基盤です。Webインターフェース、API、文書を横断する複数ステップのタスクを実行し、MCPサーバー、OpenAPIサービス、Python関数を通じてツールを接続します。チームはブラウザベースの管理UIでエージェントやスーパーバイザーを設定し、ドラフトをテストしてバージョンを公開できます。
CUGAは制御性を重視しています。実行ポリシーで許可されていない意図をブロックしたり、指定したツールの実行に人間の承認を必須にしたり、プレイブックでワークフローをガイドしたり、ツールの呼び出し前にツール単位のガードを適用したりできます。OpenAI互換のプライベート推論エンドポイント、Helm chartを使ったKubernetesへのデプロイ、補助モデルを事前に読み込んだエアギャップ環境向けイメージに対応しています。オプションコンポーネントを追加すると、スケジュール実行やWebhookをトリガーとする実行に対応した独立のイベントサービスや、タスクのガイダンスを再利用するEvolveベースのメモリも利用できます。
開発者はCLIからCUGAを使うことも、CugaAgentクラスやCugaSupervisorクラスを通じてPython SDKとして使うこともできます。Python 3.12とLangGraphを基盤に構築されています。
主な機能
- 01MCPサーバー、OpenAPIサービス、Python関数を通じてツールを接続
- 02Intent Guard、Playbook、Tool Approval、Tool Guide、Output Formatterの5種類のポリシー
- 03ToolGuardが実行前にツール呼び出しを検査し、違反をブロック
- 04OpenAI互換のプライベート推論エンドポイントとエアギャップ環境へのデプロイに対応
- 05CugaSupervisorによるマルチエージェント連携
- 06実行記録でトークン使用量、モデル呼び出し、ツール呼び出し、経過時間を確認
ユースケース
- アカウント更新に承認プロセスを設けたCRMや収益業務の自動化
- 出典を引用しながら社内文書について質問に回答
- 複数のアプリにまたがるワークフローで専門エージェントを連携
- プライベートクラウドやエアギャップ環境のKubernetes上でエージェントを実行
クイックスタート
- 1
リポジトリをクローンする
git clone https://github.com/cuga-project/cuga-agent.git - 2
プロジェクトディレクトリに移動する
cd cuga-agent - 3
Python 3.12でuvを使って依存関係をインストールする
uv sync --python 3.12 - 4
CRMツールを使ってマネージャーを起動する
uv run cuga start manager --crm
使う前に知っておきたいこと
- エージェントを実行する前に、.envでモデルプロバイダーと認証情報を設定する必要があります。
- ポリシー、メモリ、イベントの全機能を利用するには、オプションのサービスと追加設定が必要です。
収録されている特集
トピック
よくある質問
- cuga-agent とは?
- 業務上の依頼を、ポリシー制御とプライベート環境へのデプロイに対応しながら、アプリ、API、文書を横断するアクションに変換するエンタープライズ向けエージェント基盤。 CUGAは、エンタープライズの自動化を目的としたオープンソースの汎用エージェント基盤です。Webインターフェース、API、文書を横断する複数ステップのタスクを実行し、MCPサーバー、OpenAPIサービス、Python関数を通じてツールを接続します。チームはブラウザベースの管理UIでエージェントやスーパーバイザーを設定し、ドラフトをテストしてバージョンを公開できます。
- cuga-agent は無料で使えますか?ライセンスは?
- cuga-agent は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- cuga-agent は今もメンテナンスされていますか?
- 活発にメンテナンス中。cuga-agent の最終コミットは 2026年11月5日 です。
- cuga-agent は何に使えますか?
- アカウント更新に承認プロセスを設けたCRMや収益業務の自動化 出典を引用しながら社内文書について質問に回答 複数のアプリにまたがるワークフローで専門エージェントを連携 プライベートクラウドやエアギャップ環境のKubernetes上でエージェントを実行
- cuga-agent のインストール方法は?
- リポジトリをクローンする: git clone https://github.com/cuga-project/cuga-agent.git プロジェクトディレクトリに移動する: cd cuga-agent Python 3.12でuvを使って依存関係をインストールする: uv sync --python 3.12 CRMツールを使ってマネージャーを起動する: uv run cuga start manager --crm
- cuga-agent はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/cuga-project/cuga-agent
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
LangGraph上で35種類のエージェント型AIアーキテクチャを実装したPythonライブラリ兼Jupyter教材。
CodexやClaude Codeなどのコーディングエージェントを、任意の監督役・レビュアー・敵対役・ローカルログ要約器で拡張するPython製CLI。各役割で別々のモデルを使えます。
異なるマシンやツール上のAIコーディングエージェントが、スレッド、ファイル、ブラウザーを1か所で共有できるワークスペース。
専門分野に応じてエージェント間で制御を引き継ぐ、LangGraph上のスウォーム型マルチエージェントシステムを構築するPythonライブラリです。