世界を動かす技術を、日本語で。

Dockerエージェント

2026年10月8日原文(github.com)

概要

docker-agent は、YAML設定でAIエージェントを構築・実行・共有できるCLIプラグイン。 マルチエージェント 構成や豊富なツール連携、AIプロバイダー非依存性が特徴。 Docker Desktop やHomebrew、バイナリで簡単インストールが可能。 APIキー やローカルモデルで柔軟にAIモデルを設定可能。 公式ドキュメント やコミュニティも充実。

docker-agentとは

  • docker-agent は、YAMLファイルで記述された AIエージェント を構築・実行・共有できる Docker CLIプラグイン
  • ノーコード でAIエージェントを作成・管理できる利便性
  • 複数エージェント による協調作業や自動タスク分担が可能な マルチエージェントアーキテクチャ
  • ツールエコシステム の活用
    • 内蔵ツールや任意の MCPサーバー (ローカル・リモート・Dockerベース)に対応
  • AIプロバイダー非依存
    • OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、xAI、Docker Model Runnerなど幅広く対応
  • 宣言的なYAML設定 によるバージョン管理・共有性の高さ
  • 高度な推論機能
    • think、todo、memoryツールの標準搭載
  • RAG(Retrieval-Augmented Generation)
    • BM25、埋め込み、ハイブリッド検索、リランキングなど拡張可能な情報検索
  • OCIレジストリ へのエージェントの パッケージ化・共有
    • 任意の環境でpull・runが可能

インストール方法

  • Docker Desktop(4.63以降)
    • docker-agent CLIプラグインが プリインストール
    • docker agent コマンドで即利用可能
  • Homebrew
    • brew install docker-agent でインストール
    • バイナリを ~/.docker/cli-plugins/docker-agent にシンボリックリンク
  • バイナリリリース
    • GitHub Releasesからダウンロード
    • ~/.docker/cli-plugins/docker-agent にバイナリを配置または直接実行

初期設定

  • APIキーの設定
    • export OPENAI_API_KEY=sk-...
    • ANTHROPIC_API_KEYやGOOGLE_API_KEYなども利用可能
    • Docker Model Runner でローカルモデルも選択可能
  • モデル設定ガイド
    • クラウドAPIキーまたはローカルモデルのセットアップ手順を公式ドキュメントで提供

クイックスタート

  • デフォルトエージェントの実行
    • docker agent run
  • OCIレジストリからの実行
    • docker agent run myorg/agent:tag
  • 新規エージェントのインタラクティブ生成
    • docker agent new
  • 独自設定ファイルからの実行
    • docker agent run agent.yaml
  • 追加サンプルはexamples/ディレクトリに収録

公式ドキュメントとコミュニティ

  • 公式ドキュメント
    • インストール、モデル設定、クイックスタート、エージェント・モデル・ツール・マルチエージェント構成リファレンス
    • TUI・CLI・MCPモード・RAG・モデルプロバイダー・Docker Model Runnerの詳細解説
  • コントリビューション
    • Contributingガイドで参加方法を案内
  • コミュニティ
    • Docker Community Slackの#docker-agentチャンネルで交流可能

テレメトリー

  • 匿名利用データ の収集によるツール改善
  • 詳細は公式ドキュメント「Telemetry」参照

docker-agentのYAML設定例

  • エージェント定義例
    agents:
      root:
        model: openai/gpt-5-mini
        description: A helpful AI assistant
        instruction: |
          You are a knowledgeable assistant that helps users with various tasks. Be helpful, accurate, and concise in your responses.
        toolsets:
          - type: mcp
            ref: docker:duckduckgo
    
  • YAMLでエージェント構成・役割・ツールを簡潔に記述

まとめ

  • docker-agent は、YAMLベースで AIエージェント を構築・運用・共有できる 先進的なCLIプラグイン
  • マルチエージェント協調、 豊富なAIプロバイダー対応、 ツール連携、 ローカル・クラウド両対応 の柔軟性
  • 簡単インストール と 直感的なコマンド操作 で、AIエージェント活用の新たな選択肢

Hackerたちの意見

新しいオープンソースの開発(特にGoで!)が大好きなんだけど、エージェントハーネスが昔のJSフレームワークみたいになってきてるね。みんな持ってるし、カッコいいよね!

└

それを管理するためのVSCodeのフォークも一緒に使ってるよ。

└

Goにはハーネス開発者がユーザーに提供するための良いモジュールやプラグインの仕組みがないんだ。俺もGoでカスタムハーネスを書いてるゴファーとして言うけど、TSのセットアップに比べると本当に大変だよ。でも、TSプラグインもセキュリティの問題があるしね。

└

どれも https://wingman.actor には敵わないよ!冗談だけど、クソみたいなもんだね。

└

どれが勝つかはもう分かってるよ。最悪の体験を持ってるやつがね。VueやSvelteは使いやすくて学びやすいけど、結局勝ったのはReact.jsだし。だから、ユーザーが多いAIエージェントが勝つのは間違いない。--- ちょっと危険な話だけど、JSフレームワークの例えを出したから、つい乗っちゃった。

└

「ほら、LLMはフレームワークの圧政から解放してくれる!」 「え、じゃあこれをどうやって動かすの?ドキュメントはどこ?」 「まずはそのユニークなフレームワークをインストールするんだ…」

https://docker.github.io/docker-agent/configuration/sandbox/ もし、俺みたいにリンク先でセキュリティ関連の情報が見つからなかったら。

└

Dockerサンドボックスのドキュメントを全部読んだことがあるけど、攻撃ベクターについては一切触れられてなかった。修正されたのかな?

└

Dockerエージェントはハーネスみたいなもんだよ。サンドボックスモードがあって、これを使うとDockerサンドボックス(VMね、コンテナじゃない)で動かせる。サンドボックスモードを使わないなら、コンテナで動いてるってことだと思う。もし彼らのハーネスを使いたくないなら、Dockerエージェントは使わずに、好きなハーネス(ClaudeとかCodex、Piとか)を動かすためにsbx CLIを使うことになるね。Dockerが安全なVMの使い方を広めてくれたらいいなと思ってる。俺も似たようなプロジェクトを開発中(まだ進行中だけど)だよ: https://github.com/gregwebs/agent-vm

Docker Agentは研究に役立つかもしれない。例えば、エージェントについてのML論文を書くとき、実験を再実行する必要があるんだ。 - 他の人が俺の結果を再現できるように - LLMからの変動が結果に過信をもたらしていないか確認するために。でも今のところ、uvは隔離された再現可能な環境を作るには十分だよ。標準のDockerみたいにLinuxに限定されてないしね。だから、ローカルPCのGPU(WindowsやMac)で小さいサンプルをテストしたいときは、簡単にできるんだ。

└

もしそれを大規模にやるつもりなら、あなたがそうするわけじゃないけど、https://github.com/kvcache-ai/AgentENVみたいなものの方が研究目的にはずっと適してるよ。

2週間前にこれを使おうと頑張ったけど、今まで使った中で一番脆弱なハーネスだったよ。もっと成熟したらまた戻ってくるつもり。

Hacker Newsで議論の続きを見る