tRPC-Agent-Go: エージェントシステムを構築するためのGoフレームワーク

READMEが述べるフレームワークの位置づけ

READMEは冒頭で、tRPC-Agent-Goを本番向けエージェントシステムを構築するためのGoフレームワークと呼び、提供内容としてLLMエージェント、グラフワークフロー、ツール呼び出し、セッションとメモリ状態、ナレッジ検索、エージェントの自己進化、評価、OpenTelemetryによる可観測性を、単一のGoネイティブスタックとして列挙しています。想定される適合は、Goサービスに合うエージェントアプリケーション、つまり並行、可観測、デプロイ容易、そしてA2A、AG-UI、MCPとの統合に備えたものです。READMEはまた、カスタマーサポートボット、データ分析アシスタント、DevOps自動化、ヒューマン・イン・ザ・ループを伴う業務プロセス自動化、RAGによるリサーチとナレッジ管理といった用途を挙げています。README自体には、これらの用途に関するベンチマークや本番環境の証拠は含まれていません。

パッケージ構成と実行フロー

READMEのアーキテクチャ節は、実行フローを7つのステップで説明しています。Runnerがセッション管理を伴うパイプライン全体を調整し、Agentが複数の専門コンポーネントを使ってリクエストを処理し、Plannerが戦略とツール選択を決定し、Toolsが具体的なタスクを実行し、Memoryがコンテキストを維持し、KnowledgeがRAG機能を提供し、Evolutionが完了したセッションをレビューして再利用可能な手順を管理スキルに変換します。パッケージ表は、agent、runner、model、tool、session、memory、knowledge、planner、artifact、skill、evolution、event、evaluation、server、telemetryの責務を割り当てています。この表はREADME自身の要約であり、リポジトリの実際のコード配置は、examplesディレクトリとこれらのパッケージ名以外には説明されていません。

組み込みエージェントとその組み合わせ

READMEは、ほとんどのアプリケーションでagent.Agentインターフェースを実装する必要はないと述べています。チャット補完モデルをラップするLLMAgent、サブエージェントを順次実行するChainAgent、サブエージェントを並行実行して出力をマージするParallelAgent、停止シグナルまでプランナーと実行器をループするCycleAgentが同梱されています。READMEは、LLMAgentと翻訳用LLMAgentをチェーンにする例を含め、これらをブロックのように組み合わせることを示しています。グラフワークフローについては、GraphAgentが多条件ルーティングを備えた型安全なグラフワークフローで、機能的にはGo版LangGraphに相当すると説明されています。コード例では、routerが複数の分岐キーを返し、グラフが並行してターゲットを実行する多条件ファンアウトルーティングを示しています。

Runner、ストリーミング、キャンセル

Runnerは、セッションとメモリサービスを管理する実行器です。READMEのクイックスタートは、OpenAI互換モデルと電卓関数ツールを使ったストリーミング実行を示しています。実行を停止する方法も記載されています。Runner.Runに渡したcontextをキャンセルし、イベントチャネルが閉じるまで排出し続けます。READMEは、イベントループから単に抜け出さないよう警告しています。エージェントのgoroutineが動き続け、チャネル書き込みでブロックする可能性があるためです。キャンセル方法は3つ示されています。Ctrl+Cをcontextキャンセルにマップする方法、アプリケーションコードからキャンセルする方法、サーバーとバックグラウンド実行向けにrequestIDでキャンセルする方法です。別のファクトリNewRunnerWithAgentFactoryは、プロンプト、モデル、ツール、サンドボックスが異なる場合に、リクエストごとに新しいエージェントを構築します。

Agentスキルと自己進化

スキルは、SKILL.md仕様を含むフォルダで、オプションでドキュメントとスクリプトを伴います。READMEは、ローカルフォルダ、複数のルート、または.zipや.tar.gzアーカイブを指すHTTP(S) URLからスキルをロードできるNewFSRepositoryを説明しています。アーカイブはダウンロードされてローカルにキャッシュされ、SKILLS_CACHE_DIRでキャッシュ場所を上書きできます。長時間稼働するプロセスでは、スキルのインストール、削除、名前変更後にrepo.Refresh()を呼び出すべきです。組み込みツールにはskill_load、skill_list_docs、skill_select_docs、skill_runがあり、実行器がインタラクティブセッションをサポートする場合はskill_exec、skill_write_stdin、skill_poll_session、skill_kill_sessionも含まれます。READMEは、skill_runは選択したスキルドキュメントで必要なコマンドにのみ使うよう助言し、LLMAgentがskill_runをサポートするためだけにWithCodeExecutorを使う場合は、llmagent.WithEnableCodeExecutionResponseProcessor(false)でレスポンスコード実行プロセッサを無効にするよう提案しています。進化サービスはバックグラウンドで完了済みセッションをレビューし、再利用可能なSKILL.mdワークフローを抽出し、リビジョン保存、品質ゲート、人間の承認、ウォームスタート動作をサポートします。Runner統合は単一のオプションrunner.WithEvolutionServiceです。

ツール、メモリ、プロトコル統合

READMEのツール例は、関数ツール、trpc-mcp-goをラップしたMCPツール、DuckDuckGoによるウェブ検索、ファイル操作ツール、ファイル入力をカバーしています。メモリサービスには、CRUD、検索、ツール統合を備えたインメモリ版とRedis版があり、runnerレベルで管理されます。ナレッジの例は、ソースをロードし、ベクターストアに埋め込み、検索する基本的なRAGフローを示しています。Artifactはツールが生成したバージョン付きファイルを保存し、インメモリ、S3、COSのバックエンドをサポートします。プロトコル面では、READMEはAG-UIデモを説明しています。これはAgent-User Interactionプロトコルを通じてRunnerを公開し、組み込みSSEサーバーとCopilotKitおよびTDesign Chat向けのクライアントサンプルを備えます。また、ADK Python A2Aサーバーと通信し、ランタイム間のストリーミング、ツール呼び出し、コード実行を示すA2A相互運用の例もあります。openclawという名前のゲートウェイサーバー例は、安定したセッションID、セッションごとの直列化、そして許可リストとメンションゲーティングという基本的安全制御を備えた、最小限のOpenClaw風実装と説明されています。

評価、可観測性、ライセンス

evaluationパッケージは、反復可能な評価セットとプラグイン可能なメトリクスでエージェントを評価し、結果を保存します。READMEは、WithNumRunsを指定したNew evaluatorとOverallStatus結果を示しています。可観測性は、モデル、ツール、runner層にわたるOpenTelemetryフックを通じて提供され、トレースをOTLPエンドポイントにエクスポートする例と、Langfuse統合の例があります。READMEはまた、自動プロンプトキャッシュがキャッシュコンテンツで90%の節約になると主張していますが、そのパーセンテージの測定方法は定義していません。リポジトリはApache 2.0ライセンスです。ライセンス抜粋は、永続的、世界的、非独占的、無償、ロイヤリティフリー、取消不能の著作権ライセンスと、WorkまたはContributionが侵害するという特許訴訟をライセンシーが提起した場合に終了する特許ライセンスを付与します。抜粋は再配布条項の冒頭も含みます。提供された抜粋は、保証、サポート、セキュリティ態勢については何も述べていません。

編集部の結論

tRPC-Agent-GoはApache-2.0ライセンスのGoフレームワークで、READMEにはrunnerベースの実行フロー、組み込みエージェント、グラフワークフロー、メモリとナレッジサービス、スキルと自己進化、プロトコル統合、評価ツールが記載されています。リポジトリメタデータによると、執筆時点で1,637スター、287フォーク、179の未解決issueがあります。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes