<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>実践チュートリアル on Intellectual Guides</title><link>https://ckw19810413.github.io/ja/categories/%E5%AE%9F%E8%B7%B5%E3%83%81%E3%83%A5%E3%83%BC%E3%83%88%E3%83%AA%E3%82%A2%E3%83%AB/</link><description>Recent content in 実践チュートリアル on Intellectual Guides</description><generator>Hugo -- gohugo.io</generator><language>ja</language><lastBuildDate>Mon, 27 Jul 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://ckw19810413.github.io/ja/categories/%E5%AE%9F%E8%B7%B5%E3%83%81%E3%83%A5%E3%83%BC%E3%83%88%E3%83%AA%E3%82%A2%E3%83%AB/index.xml" rel="self" type="application/rss+xml"/><item><title>ローカルAIインフラ構築ガイド：ゼロから vLLM + ComfyUI まで</title><link>https://ckw19810413.github.io/ja/blog/local-ai-infrastructure-guide/</link><pubDate>Mon, 27 Jul 2026 00:00:00 +0000</pubDate><guid>https://ckw19810413.github.io/ja/blog/local-ai-infrastructure-guide/</guid><description>&lt;h2 id="なぜローカルaiインフラを構築するのか"&gt;なぜローカルAIインフラを構築するのか？
&lt;/h2&gt;&lt;p&gt;2026年、AIツールは開発者・クリエイター・企業にとって不可欠なインフラになりました。しかし、多くの人は依然としてクラウドAPIに依存しています——呼び出しごとに課金され、データプライバシーのリスクを負い、レート制限に突き当たっています。&lt;/p&gt;
&lt;p&gt;ローカルAIインフラは、あなたに3つのものを与えます。&lt;strong&gt;完全な制御、無制限の利用、そしてゼロの限界費用&lt;/strong&gt;です。&lt;/p&gt;
&lt;p&gt;構築すれば、次のことができます。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;LLMを制限なく使う。API料金なし&lt;/li&gt;
&lt;li&gt;機密データをマシンの外に出さずに処理する&lt;/li&gt;
&lt;li&gt;複数のサービスを同時に実行する。レート制限なし&lt;/li&gt;
&lt;li&gt;Cowork MCP のようなフレームワークと統合し、真のマルチエージェントシステムを構築する&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;このガイドは、GPU 搭載のマシン（DGX GB10、RTX 4090、あるいはそれ以上を推奨）をお持ちであることを前提とします。ゼロから完全なローカルAI環境を構築する流れを案内します。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;このガイドで学べること：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;ローカルLLMサービング（vLLM）のインストールと設定&lt;/li&gt;
&lt;li&gt;画像生成のための ComfyUI のデプロイ&lt;/li&gt;
&lt;li&gt;GPUメモリとサービスの起動順序の管理&lt;/li&gt;
&lt;li&gt;サービス管理の自動化（systemd）&lt;/li&gt;
&lt;li&gt;マルチエージェントAIチームのための Cowork MCP との統合&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;さっそく始めましょう。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="前提条件"&gt;前提条件
&lt;/h2&gt;&lt;p&gt;始める前に、次を用意してください。&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;バージョン&lt;/th&gt;
&lt;th&gt;確認コマンド&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Linux&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Ubuntu 22.04+ または Arch&lt;/td&gt;
&lt;td&gt;&lt;code&gt;uname -a&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;GPU&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;NVIDIA RTX 3090+/4090/GB10&lt;/td&gt;
&lt;td&gt;&lt;code&gt;nvidia-smi&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;CUDA&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;≥ 12.4&lt;/td&gt;
&lt;td&gt;&lt;code&gt;nvcc --version&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Docker&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;≥ 24.0&lt;/td&gt;
&lt;td&gt;&lt;code&gt;docker --version&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Node.js&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;≥ 20&lt;/td&gt;
&lt;td&gt;&lt;code&gt;node --version&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Python&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;≥ 3.10&lt;/td&gt;
&lt;td&gt;&lt;code&gt;python3 --version&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;GPUのメモリが24GB未満の場合は、開始前に不要なGUIアプリやサービスを閉じることを検討してください。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ1docker-と-nvidia-container-toolkit-のインストール"&gt;ステップ1：Docker と NVIDIA Container Toolkit のインストール
&lt;/h2&gt;&lt;p&gt;Docker はローカルAIサービスをデプロイする推奨手段です。依存関係を分離し、バージョン衝突を避け、システムの汚染を防ぐからです。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# Docker のインストール&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo apt update
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo apt install -y docker.io docker-compose-v2
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# NVIDIA Container Toolkit のインストール（Docker 内での GPU アクセスを有効化）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;distribution&lt;span style="color:#f92672"&gt;=&lt;/span&gt;&lt;span style="color:#66d9ef"&gt;$(&lt;/span&gt;. /etc/os-release;echo $ID$VERSION_ID&lt;span style="color:#66d9ef"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed &lt;span style="color:#e6db74"&gt;&amp;#39;s#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g&amp;#39;&lt;/span&gt; | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo apt update
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo apt install -y nvidia-container-toolkit
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo nvidia-ctk runtime configure --runtime&lt;span style="color:#f92672"&gt;=&lt;/span&gt;docker
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl restart docker
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;GPU が利用可能か検証します。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker run --rm --gpus all nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;GPU 情報とメモリ使用量が表示されれば、環境は正しく設定されています。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ2vllm-ローカル言語モデルのデプロイ"&gt;ステップ2：vLLM ローカル言語モデルのデプロイ
&lt;/h2&gt;&lt;p&gt;vLLM は現在、最も効率的なローカルLLM推論フレームワークで、複数のモデル形式（GGUF、GPTQ、AWQ）をサポートしています。&lt;/p&gt;
&lt;h3 id="21-docker-でデプロイ"&gt;2.1 Docker でデプロイ
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker run -d &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --name vllm-server &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --gpus all &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -p 8000:8000 &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -v ~/.cache/huggingface:/root/.cache/huggingface &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; vllm/vllm-openai:latest &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --model &lt;span style="color:#e6db74"&gt;&amp;#34;nvidia/Llama-3.1-Nemotron-70B-Instruct&amp;#34;&lt;/span&gt; &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --gpu-memory-utilization 0.9 &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --max-model-len &lt;span style="color:#ae81ff"&gt;8192&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;パラメータの説明：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;--model&lt;/code&gt;：デプロイするモデル（任意の HuggingFace モデルに置き換え可能）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;--gpu-memory-utilization&lt;/code&gt;：使用するGPUメモリの割合（0.9 は 90% を意味する）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;--max-model-len&lt;/code&gt;：最大コンテキスト長&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;注意：&lt;/strong&gt; GPUのメモリが80GB未満の場合は、より大きなモデルを試す前に、まず小さなモデル（7B や 13B）から始めてください。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id="22-api-エンドポイントのテスト"&gt;2.2 API エンドポイントのテスト
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;curl -X POST http://localhost:8000/v1/completions &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -H &lt;span style="color:#e6db74"&gt;&amp;#34;Content-Type: application/json&amp;#34;&lt;/span&gt; &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -d &lt;span style="color:#e6db74"&gt;&amp;#39;{
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;model&amp;#34;: &amp;#34;nvidia/Llama-3.1-Nemotron-70B-Instruct&amp;#34;,
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;prompt&amp;#34;: &amp;#34;Explain what a multi-agent AI system is&amp;#34;,
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;max_tokens&amp;#34;: 200
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; }&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;応答が返ってくれば、vLLM のデプロイは成功です。&lt;/p&gt;
&lt;h3 id="23-システムサービスとして設定自動起動"&gt;2.3 システムサービスとして設定（自動起動）
&lt;/h3&gt;&lt;p&gt;systemd サービスファイルを作成します。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo tee /etc/systemd/system/vllm.service &lt;span style="color:#e6db74"&gt;&amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;[Unit]
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;Description=vLLM Local LLM Server
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;After=docker.service
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;Requires=docker.service
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;[Service]
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;Type=oneshot
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;RemainAfterExit=yes
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;ExecStart=/usr/bin/docker start vllm-server
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;ExecStop=/usr/bin/docker stop vllm-server
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;[Install]
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;WantedBy=multi-user.target
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt;EOF&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;サービスを有効化して起動します。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl daemon-reload
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl enable vllm.service
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl start vllm.service
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="ステップ3comfyui-画像生成のデプロイ"&gt;ステップ3：ComfyUI 画像生成のデプロイ
&lt;/h2&gt;&lt;p&gt;ComfyUI は最も強力なローカル画像生成ツールで、Flux、Stable Diffusion、LTX、その他さまざまなモデルをサポートしています。&lt;/p&gt;
&lt;h3 id="31-docker-でデプロイ"&gt;3.1 Docker でデプロイ
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker run -d &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --name comfyui &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --gpus all &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -p 8188:8188 &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -v ~/.cache/huggingface:/root/.cache/huggingface &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -v ~/comfyui-output:/output &lt;span style="color:#ae81ff"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; ghcr.io/ai-forest/comfyui:latest
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;これで ComfyUI が &lt;code&gt;http://localhost:8188&lt;/code&gt; で起動します。&lt;/p&gt;
&lt;h3 id="32-手動インストール上級者向けの選択肢"&gt;3.2 手動インストール（上級者向けの選択肢）
&lt;/h3&gt;&lt;p&gt;より細かい制御が必要なら、手動でインストールできます。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# ComfyUI リポジトリのクローン&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;cd ~/comfyui
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;git clone https://github.com/comfyanonymous/ComfyUI.git
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;cd ComfyUI
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# 依存関係のインストール&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;pip install -r requirements.txt
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# カスタムノードのインストール（任意）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;git clone https://github.com/Fannovel16/ComfyUI-Frame-Interpolation.git custom_nodes/
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;git clone https://github.com/laksjdjoy/deforum-comfy.git custom_nodes/
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# サービスの起動&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;python main.py --listen 0.0.0.0 --port &lt;span style="color:#ae81ff"&gt;8188&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="33-よく使うモデルのダウンロード"&gt;3.3 よく使うモデルのダウンロード
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# HuggingFace CLI でモデルをダウンロード&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;pip install huggingface_hub
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;huggingface-cli download stabilityai/stable-diffusion-xl-base-1.0 --local-dir ~/models/sdxl
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;huggingface-cli download stabilityai/stable-diffusion-3.5-large --local-dir ~/models/sd3.5
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="ステップ4gpuメモリ管理の戦略"&gt;ステップ4：GPUメモリ管理の戦略
&lt;/h2&gt;&lt;p&gt;ローカルでAIサービスを実行するとき、GPUメモリが最大のボトルネックになります。実戦で鍛えられたプラクティスをいくつか紹介します。&lt;/p&gt;
&lt;h3 id="41-利用可能なメモリの確認"&gt;4.1 利用可能なメモリの確認
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;free -h
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;nvidia-smi --query-gpu&lt;span style="color:#f92672"&gt;=&lt;/span&gt;memory.used,memory.free,temperature.gpu --format&lt;span style="color:#f92672"&gt;=&lt;/span&gt;csv
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="42-推奨されるサービスの起動順序"&gt;4.2 推奨されるサービスの起動順序
&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;まず vLLM を起動する&lt;/strong&gt;（言語モデルは通常、メモリ要件が固定されている）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;次に ComfyUI を起動する&lt;/strong&gt;（画像生成はメモリ使用量を動的に調整できる）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不要なGUIアプリを閉じる&lt;/strong&gt;（ブラウザ、Discord など）&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id="43-メモリ監視スクリプト"&gt;4.3 メモリ監視スクリプト
&lt;/h3&gt;&lt;p&gt;シンプルな監視スクリプトを作成します。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;#!/bin/bash
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# monitor-gpu.sh&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;while&lt;/span&gt; true; &lt;span style="color:#66d9ef"&gt;do&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; echo &lt;span style="color:#e6db74"&gt;&amp;#34;=== &lt;/span&gt;&lt;span style="color:#66d9ef"&gt;$(&lt;/span&gt;date&lt;span style="color:#66d9ef"&gt;)&lt;/span&gt;&lt;span style="color:#e6db74"&gt; ===&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; nvidia-smi --query-gpu&lt;span style="color:#f92672"&gt;=&lt;/span&gt;memory.used,memory.free,temperature.gpu --format&lt;span style="color:#f92672"&gt;=&lt;/span&gt;csv
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; docker ps --filter &lt;span style="color:#e6db74"&gt;&amp;#34;name=vllm\|name=comfyui&amp;#34;&lt;/span&gt; --format &lt;span style="color:#e6db74"&gt;&amp;#34;table {{.Names}}\t{{.Status}}&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; sleep &lt;span style="color:#ae81ff"&gt;30&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;done&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="ステップ5cowork-mcp-マルチエージェントフレームワークの統合"&gt;ステップ5：Cowork MCP マルチエージェントフレームワークの統合
&lt;/h2&gt;&lt;p&gt;ローカルAIインフラが整ったら、それを Cowork MCP に接続してマルチエージェントシステムを構築します。&lt;/p&gt;
&lt;h3 id="51-vllm-をブレインとして登録"&gt;5.1 vLLM をブレインとして登録
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# Hermes Agent を使う場合&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;hermes register-cowork
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# または MCP エンドポイントを手動で設定&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# Agent の設定ファイルに：&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;mcpServers&amp;#34;&lt;/span&gt;: &lt;span style="color:#f92672"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;cowork&amp;#34;&lt;/span&gt;: &lt;span style="color:#f92672"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;url&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;http://localhost:6868/mcp&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;transport&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;streamable-http&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;}&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;vllm&amp;#34;&lt;/span&gt;: &lt;span style="color:#f92672"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;url&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;http://localhost:8000/v1&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;transport&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;streamable-http&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="52-実践応用ローカルaiコンテンツパイプライン"&gt;5.2 実践応用：ローカルAIコンテンツパイプライン
&lt;/h3&gt;&lt;pre tabindex="0"&gt;&lt;code&gt;ローカル vLLM（コンテンツ生成） → ComfyUI（画像生成） → ffmpeg（後処理）
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;このパイプラインの各ステップは、異なるAIエージェントによって連携できます。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;リサーチエージェント&lt;/strong&gt;：vLLM を使ってコンテンツのアウトラインを生成する&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;ライティングエージェント&lt;/strong&gt;：vLLM を使って完全な記事に展開する&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;画像エージェント&lt;/strong&gt;：ComfyUI を使って対応するイラストを生成する&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;統合エージェント&lt;/strong&gt;：コンテンツと画像を最終出力にまとめる&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id="ステップ6自動化とバックアップ"&gt;ステップ6：自動化とバックアップ
&lt;/h2&gt;&lt;h3 id="61-コンテナのバックアップ"&gt;6.1 コンテナのバックアップ
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# ComfyUI コンテナの状態をバックアップ&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker commit comfyui comfyui-backup:&lt;span style="color:#66d9ef"&gt;$(&lt;/span&gt;date +%Y%m%d&lt;span style="color:#66d9ef"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# イメージをエクスポート&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker save comfyui:latest | gzip &amp;gt; ~/backups/comfyui-&lt;span style="color:#66d9ef"&gt;$(&lt;/span&gt;date +%Y%m%d&lt;span style="color:#66d9ef"&gt;)&lt;/span&gt;.tar.gz
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="62-モデルのバックアップ"&gt;6.2 モデルのバックアップ
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# HuggingFace キャッシュを定期的にバックアップ&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;rsync -avh ~/.cache/huggingface ~/backups/huggingface-cache/
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# または rclone でクラウドにバックアップ&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;rclone sync ~/.cache/huggingface remote:backup-huggingface --progress
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="63-ヘルスチェックスクリプト"&gt;6.3 ヘルスチェックスクリプト
&lt;/h3&gt;&lt;p&gt;ヘルスチェックの cron ジョブを作成します。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# 5 分ごとにサービスの状態を確認&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;*/5 * * * * curl -f http://localhost:8000/v1/models &lt;span style="color:#f92672"&gt;||&lt;/span&gt; echo &lt;span style="color:#e6db74"&gt;&amp;#34;vLLM is down at &lt;/span&gt;&lt;span style="color:#66d9ef"&gt;$(&lt;/span&gt;date&lt;span style="color:#66d9ef"&gt;)&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;&lt;/span&gt; | mail -s &lt;span style="color:#e6db74"&gt;&amp;#34;vLLM Alert&amp;#34;&lt;/span&gt; admin@example.com
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="トラブルシューティング"&gt;トラブルシューティング
&lt;/h2&gt;&lt;h3 id="q1docker-が-gpu-を使えない"&gt;Q1：Docker が GPU を使えない
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# NVIDIA Container Toolkit がインストールされているか確認&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;nvidia-ctk runtime verify
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# Docker サービスを再起動&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl restart docker
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="q2gpuメモリが不足する"&gt;Q2：GPUメモリが不足する
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# vLLM のメモリ使用率を下げる&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# docker run コマンドに追加：&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;--gpu-memory-utilization 0.7
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# または不要なサービスを停止&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo systemctl stop bluetooth
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="q3comfyui-が起動しない"&gt;Q3：ComfyUI が起動しない
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# Docker のログを確認&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker logs comfyui
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# 再起動を試す&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker restart comfyui
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="q4モデルのダウンロードが遅い"&gt;Q4：モデルのダウンロードが遅い
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# HuggingFace ミラーを使う（中国本土のユーザー向け）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;export HF_ENDPOINT&lt;span style="color:#f92672"&gt;=&lt;/span&gt;https://hf-mirror.com
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="次に来るもの"&gt;次に来るもの
&lt;/h2&gt;&lt;p&gt;これで完全なローカルAIインフラが手に入りました。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;今日：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;vLLM と ComfyUI が稼働していることを確認する&lt;/li&gt;
&lt;li&gt;API エンドポイントをテストし、コンテンツと画像の生成が機能することを検証する&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;今週：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;起動時に自動起動するよう systemd サービスを設定する&lt;/li&gt;
&lt;li&gt;バックアップと監視の仕組みを作成する&lt;/li&gt;
&lt;li&gt;少なくとも一つのLLMバックエンドを Cowork MCP に接続する&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;今月：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;より多くのAIエージェントチームのために &lt;a class="link" href="https://github.com/slashman413/cowork" target="_blank" rel="noopener"
&gt;Cowork MCP フレームワーク&lt;/a&gt; を探索する&lt;/li&gt;
&lt;li&gt;さまざまなモデルを試し、自分のニーズに最適な構成を見つける&lt;/li&gt;
&lt;li&gt;自分だけのAIコンテンツ制作パイプラインを構築する&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id="faq"&gt;FAQ
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;Q：これらのサービスを実行するにはどの程度のGPUが必要ですか？&lt;/strong&gt;
A：少なくとも24GBのメモリを推奨します（RTX 3090/4090）。メモリがそれより小さい場合は、より小さなモデル（7B〜13B）を実行するか、Docker のメモリ制限を使えます。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：GPUのないマシンでも実行できますか？&lt;/strong&gt;
A：はい、ただし遅くなります。CPU 推論は可能ですが、大規模モデル（70B以上）には実用的ではありません。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：モデルはどう更新しますか？&lt;/strong&gt;
A：HuggingFace CLI を使います：&lt;code&gt;huggingface-cli download &amp;lt;model-name&amp;gt; --local-dir &amp;lt;path&amp;gt;&lt;/code&gt;。Docker コンテナは更新されたローカルモデルを自動的に使用します。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：vLLM と Ollama の違いは？&lt;/strong&gt;
A：vLLM は高スループット推論に最適化されており、より多くのモデル形式と高度な機能をサポートします。Ollama はより軽量で使いやすいものの、機能は少なめです。ローカルAIインフラには vLLM を推奨します。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：ComfyUI は Automatic1111 とどう違いますか？&lt;/strong&gt;
A：ComfyUI はノードベースのワークフローを採用しており、より柔軟で効率的です。Automatic1111 は初心者に優しいGUIを備えています。どちらもよく機能しますが、本番環境では ComfyUI のほうが人気です。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;読了時間：約15分 | 公開：2026-07-27&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;このガイドが役に立ちましたか？&lt;a class="link" href="https://ckw19810413.github.io/en/" &gt;Slashman Tools&lt;/a&gt; でさらに多くのガイドを見るか、すぐ使える構成は &lt;a class="link" href="https://gumroad.com/l/diwoc" target="_blank" rel="noopener"
&gt;AIツールチェーンテンプレートライブラリ&lt;/a&gt; をチェックしてください。&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;[&lt;a class="link" href="https://ckw19810413.github.io/en/" &gt;- ホームに戻る&lt;/a&gt;]&lt;/p&gt;</description></item><item><title>初めての AI エージェントチーム構築ガイド：Cowork MCP フレームワークで順に実装</title><link>https://ckw19810413.github.io/ja/blog/build-ai-agent-team/</link><pubDate>Sun, 26 Jul 2026 00:00:00 +0000</pubDate><guid>https://ckw19810413.github.io/ja/blog/build-ai-agent-team/</guid><description>&lt;h2 id="20-分で初めての-ai-エージェントチームを構築する"&gt;20 分で初めての AI エージェントチームを構築する
&lt;/h2&gt;&lt;p&gt;2026 年、AI シーンを追っていたなら、この約束を必ず耳にしたことがあるでしょう——マルチエージェント AI システムは専門家のチームのようで、各自が最も得意な仕事を処理する。しかしほとんどの教學は理論の段階で止まっています——マルチエージェント協調が何かを説明するだけで、実際にどのように構築するかは教えてくれないのです。&lt;/p&gt;
&lt;p&gt;この教學はそれを変えます。&lt;/p&gt;
&lt;p&gt;この教學を完了した後、実際に稼働するマルチエージェント AI システムを手に入れることになります——登録済みエージェント、タスクキュー、そしてリアルなダッシュボードで——コードレビュー、コンテンツ制作、市場調査など、あらゆる作業を自動化するために使えます。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;今日学ぶこと：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;機械上で Cowork MCP Server を実行する&lt;/li&gt;
&lt;li&gt;285 以上のデフォルト専門エージェントを揃える&lt;/li&gt;
&lt;li&gt;構造化されたレポートを出力するマルチエージェントタスクをディスペッチする&lt;/li&gt;
&lt;li&gt;LLM バックエンドに接続して実作業を実行する&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;では始めましょう。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="前提要件"&gt;前提要件
&lt;/h2&gt;&lt;p&gt;始める前に、以下の準備が整っていることを確認してください：&lt;/p&gt;
&lt;p&gt;|| 項目 | バージョン要件 | 確認コマンド |
||&amp;mdash;&amp;mdash;|&amp;mdash;&amp;mdash;&amp;mdash;&amp;ndash;|&amp;mdash;&amp;mdash;&amp;mdash;|
|| &lt;strong&gt;Node.js&lt;/strong&gt; | ≥ 20（v22 を推奨） | &lt;code&gt;node --version&lt;/code&gt; |
|| &lt;strong&gt;npm&lt;/strong&gt; | ≥ 10 | &lt;code&gt;npm --version&lt;/code&gt; |
|| &lt;strong&gt;Git&lt;/strong&gt; | 任意のバージョン | &lt;code&gt;git --version&lt;/code&gt; |
|| &lt;strong&gt;LLM バックエンド&lt;/strong&gt; | 少なくとも一つ（Claude、GPT、Gemini またはローカル） | — |&lt;/p&gt;
&lt;p&gt;これだけです。クラウドアカウントは不要、Docker は不要、複雑なインフラも不要。すべてはあなたのマシン上で動作します。&lt;/p&gt;
&lt;p&gt;AI エージェントが初めての方は、&lt;a class="link" href="https://ckw19810413.github.io/multi-agent-coworking-platform/" &gt;マルチエージェント AI 協調プラットフォーム完全ガイド&lt;/a&gt;を読んで基礎概念を理解することを推奨します。この教學はそれをベースに実装を行います。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ-1cowork-のインストールと起動"&gt;ステップ 1：Cowork のインストールと起動
&lt;/h2&gt;&lt;p&gt;Cowork MCP フレームワークはオープンソースで、二つのコマンドでインストールできます。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# リポジトリと全エージェント定義をコピー&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;git clone --recurse-submodules https://github.com/slashman413/cowork
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;cd cowork/server
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# 依存関係をインストール&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;npm install
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;--recurse-submodules&lt;/code&gt; オプションが極めて重要です——&lt;code&gt;agency-agents&lt;/code&gt; サブモジュールを取り込みます。ここには 285 以上の事前書かれたエージェント定義が含まれています。各エージェントは YAML フロントmatter を持つ &lt;code&gt;.md&lt;/code&gt; ファイルで、役割、スキル、実行パラメータを記述しています。&lt;/p&gt;
&lt;h3 id="サーバーの起動"&gt;サーバーの起動
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;npm run dev
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;以下のような出力が表示されるはずです：&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;🤝 Cowork MCP Server running at http://0.0.0.0:6868
MCP endpoint: http://0.0.0.0:6868/mcp
Web Dashboard: http://0.0.0.0:6868/
REST API: http://0.0.0.0:6868/api/
Roster loaded: 285 agents across 19 divisions
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;ブラウザで &lt;code&gt;http://localhost:6868/&lt;/code&gt; を開いてください。&lt;/strong&gt; Cowork ダッシュボードが表示されます——エージェント roster、タスクインボックス、システムステータスが一目で分かります。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ-2エージェント-roster-を理解する"&gt;ステップ 2：エージェント roster を理解する
&lt;/h2&gt;&lt;p&gt;Cowork には &lt;strong&gt;285 以上の専門エージェント&lt;/strong&gt;が&lt;strong&gt;19 の部門&lt;/strong&gt;に組織化されています。各部門は一つの専門領域に対応しています：&lt;/p&gt;
&lt;p&gt;|| 部門 | エージェント数 | 例示エージェント |
||&amp;mdash;&amp;mdash;|&amp;mdash;&amp;mdash;&amp;mdash;&amp;ndash;|&amp;mdash;&amp;mdash;&amp;mdash;&amp;ndash;|
|| エンジニアリング | 45+ | コードレビュアー、システムアーキテクト、DevOps エンジニア |
|| マーケティング | 30+ | SEO スペシャリスト、コンテンツストラテジスト、ソーシャルメディアマネージャー |
|| テスト | 25+ | QA エンジニア、ペネトレーションテスター、パフォーマンス監査 |
|| データサイエンス | 20+ | データアナリスト、ML エンジニア、ビジュアライゼーション専門家 |
|| デザイン | 15+ | UI デザイナー、UX リサーチャー、ブランドデザイナー |
|| 法務 | 12+ | 契約審査員、コンプライアンススペシャリスト |
|| 財務 | 18+ | 財務アナリスト、リスク評価者、税務スペシャリスト |
|| プロダクト | 10+ | プロダクトマネージャー、グロースハッカー、プロダクトマーケティング |
|| &lt;em&gt;その他 14 部門&amp;hellip;&lt;/em&gt; | | |&lt;/p&gt;
&lt;p&gt;各エージェントは明確に定義された役割を持っています。ダッシュボード上で、または &lt;code&gt;cowork/agency-agents/agents/&lt;/code&gt; パスを閲覧することで、full roster を確認できます。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ-3llm-バックエンドを接続する"&gt;ステップ 3：LLM バックエンドを接続する
&lt;/h2&gt;&lt;p&gt;Cowork はタスクコーディネーター——作業をルーティングする役割ですが、それ自体は LLM リクエストを実行しません。少なくとも一つの「脳」（LLM 能力を持つプラットフォーム）に接続してエージェントを実行する必要があります。&lt;/p&gt;
&lt;h3 id="オプション-ahermes-agent初心者推奨"&gt;オプション A：Hermes Agent（初心者推奨）
&lt;/h3&gt;&lt;p&gt;&lt;a class="link" href="https://hermes-agent.nousresearch.com" target="_blank" rel="noopener"
&gt;Hermes Agent&lt;/a&gt; を既にインストールしている場合、ネイティブに統合できます：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;hermes register-cowork
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;これにより、Hermes が Cowork の作業ノードとして登録され、39 以上のスキルと内蔵ツールセットが開放されます。&lt;/p&gt;
&lt;h3 id="オプション-bclaude-code"&gt;オプション B：Claude Code
&lt;/h3&gt;&lt;p&gt;Claude Code の MCP 設定ファイル（&lt;code&gt;~/.claude.json&lt;/code&gt; またはプロジェクトレベルの &lt;code&gt;claude.json&lt;/code&gt;）に以下の設定を追加します：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;mcpServers&amp;#34;&lt;/span&gt;: {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;cowork&amp;#34;&lt;/span&gt;: {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;url&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;http://localhost:6868/mcp&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;transport&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;streamable-http&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="オプション-c任意の-mcp-互換クライアント"&gt;オプション C：任意の MCP 互換クライアント
&lt;/h3&gt;&lt;p&gt;Model Context Protocol (MCP) をサポートするすべてのクライアント——Cursor、VS Code 拡張機能、Gemini CLI、カスタムスクリプトを含む——は、Cowork の &lt;code&gt;/mcp&lt;/code&gt; エンドポイントに接続できます。&lt;/p&gt;
&lt;p&gt;接続が完了すると、エージェントが利用可能な作業ノードとして表示されます。Cowork のコーディネーターが以降の全作業を処理します。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="ステップ-4初めてのマルチエージェントタスクをディスペッチする"&gt;ステップ 4：初めてのマルチエージェントタスクをディスペッチする
&lt;/h2&gt;&lt;p&gt;ここから見どころ——エージェントチームを通じて実際に作業を実行します。&lt;/p&gt;
&lt;h3 id="タスクマルチエージェントコード監査"&gt;タスク：マルチエージェントコード監査
&lt;/h3&gt;&lt;p&gt;GitHub リポジトリに対し、三人のエージェントで並列監査を実施しましょう。Cowork ダッシュボードまたは API 経由で：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;title&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;包括的コード監査 - agents-coworking&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;description&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;agents-coworking GitHub リポジトリの包括的監査：コード品質（テックリード）、UX/SEO（グロースハッカー）、実行可能ロードマップ（プロダクトマネージャー）を評価。&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;skill&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;engineering&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;tags&amp;#34;&lt;/span&gt;: [&lt;span style="color:#e6db74"&gt;&amp;#34;code-review&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;security&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;performance&amp;#34;&lt;/span&gt;],
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;to_agent&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;tech-lead&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;&amp;#34;priority&amp;#34;&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;high&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Cowork のコーディネーターは三つのフェーズで処理します：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;フェーズ 1 — 分類：&lt;/strong&gt; クラッファ脳がタスク説明を読み、所属部門を判断します。「コード監査」＋ engineering、code-review タグ → エンジニアリング部門。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;フェーズ 2 — エージェント選択：&lt;/strong&gt; エンジニアリング部門内で、コーディネーターはスキルマッチング、専門の深さ、現在の負荷に基づいて利用可能なエージェントを評価し、最も適したエージェントを選択します。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;フェーズ 3 — 実行：&lt;/strong&gt; 選択されたエージェントがあなたの LLM バックエンド上で実行し、完全なタスク説明をコンテキストとして受け取り、構造化された出力を生成——通常は &lt;code&gt;cowork/reports/&lt;/code&gt; 内の markdown 報告書として保存されます。&lt;/p&gt;
&lt;p&gt;ダッシュボードでリアルタイムの進捗を監視できます：&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;━━ タスク：包括的コード監査 ━━
エージェント：テックリード（Hermes Agent 経由）
ステータス：実行中…（3 分経過）
進捗：コード構造分析 → 依存関係監査実行
&lt;/code&gt;&lt;/pre&gt;&lt;h3 id="チェーンタスク複雑なワークフロー"&gt;チェーンタスク：複雑なワークフロー
&lt;/h3&gt;&lt;p&gt;本番環境では、タスクをチェーンして、あるエージェントの出力を次のエージェントの入力にできます：&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;リサーチエージェント → コンテンツライター → SEO 最適化 → ソーシャル投稿
│ │ │ │
├ 主題分析 ├ ブログ草稿 ├ メタタグ ├ プラットフォーム投稿
├ 競合情報 ├ 2000+ 文字 ├ Schema ├ スケジュール
└ キーワード研究 └ トーン一致 ├ インリンクリンク └ 分析設定
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;各エージェントがその出力を次のエージェントにコンテキストとして渡します。結果として、主題選択からコンテンツ公開まで、一度のコーディネーションで完了します。&lt;/p&gt;
&lt;p&gt;AI ドライブンなコンテンツ戦略とプロンプトについては、私の &lt;a class="link" href="https://ckw19810413.github.io/ai-prompts-guide/" &gt;AI プロンプトスキルガイド&lt;/a&gt;を参照して、すぐに使えるテンプレートをご覧ください。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="実用パターン-1自動化コードレビューパイプライン"&gt;実用パターン 1：自動化コードレビューパイプライン
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;目標&lt;/strong&gt;：GitHub にコードをプッシュするたび、Cowork が自動的にコードをレビューする。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;設定&lt;/strong&gt;：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Cowork タスクテンプレートを作成&lt;/li&gt;
&lt;li&gt;GitHub Action でプッシュのたびに Cowork の API に POST&lt;/li&gt;
&lt;li&gt;Cowork がテックリードとセキュリティエージェントにタスクをディスペッチ&lt;/li&gt;
&lt;li&gt;結果は PR コメントとしてフィードバック&lt;/li&gt;
&lt;/ol&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;# .github/workflows/cowork-review.yml&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;on&lt;/span&gt;: [&lt;span style="color:#ae81ff"&gt;pull_request]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;jobs&lt;/span&gt;:
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;ai-review&lt;/span&gt;:
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;runs-on&lt;/span&gt;: &lt;span style="color:#ae81ff"&gt;ubuntu-latest&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;steps&lt;/span&gt;:
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; - &lt;span style="color:#f92672"&gt;name&lt;/span&gt;: &lt;span style="color:#ae81ff"&gt;Dispatch Cowork Review&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#f92672"&gt;run&lt;/span&gt;: |&lt;span style="color:#e6db74"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; curl -X POST http://your-server:6868/api/tasks \
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; -H &amp;#34;Content-Type: application/json&amp;#34; \
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; -d &amp;#39;{
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;title&amp;#34;: &amp;#34;PR Review: ${{ github.event.pull_request.title }}&amp;#34;,
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;description&amp;#34;: &amp;#34;Review PR for security, performance, and code quality&amp;#34;,
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;skill&amp;#34;: &amp;#34;engineering&amp;#34;,
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; &amp;#34;tags&amp;#34;: [&amp;#34;code-review&amp;#34;, &amp;#34;ci-cd&amp;#34;]
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e6db74"&gt; }&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;
&lt;h2 id="実用パターン-2コンテンツ制作チーム"&gt;実用パターン 2：コンテンツ制作チーム
&lt;/h2&gt;&lt;p&gt;クリエイターやマーケティング担当にとって、マルチエージェントコンテンツパイラインはあらゆるボトルネックを解消します：&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;リサーチエージェント → ライターエージェント → SEO エージェント → 公開エージェント
│ │ │ │
├ 主題分析 ├ ブログ草稿 ├ メタタグ ├ プラットフォーム投稿
├ 競合情報 ├ 2000+ 文字 ├ Schema ├ スケジュール
└ キーワード研究 └ トーン一致 ├ インリンクリンク └ 分析設定
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;各エージェントがその出力を次のエージェントにコンテキストとして渡します。結果として、主題選択からコンテンツ公開まで、一度のコーディネーションで完了します。&lt;/p&gt;
&lt;p&gt;AI ドライブンなコンテンツ戦略とプロンプトについては、私の &lt;a class="link" href="https://ckw19810413.github.io/ai-prompts-guide/" &gt;AI プロンプトスキルガイド&lt;/a&gt;を参照して、すぐに使えるテンプレートをご覧ください。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="実用パターン-3プロダクトローンチ調整"&gt;実用パターン 3：プロダクトローンチ調整
&lt;/h2&gt;&lt;p&gt;デジタルプロダクトのリリースには、リサーチ、コンテンツ、技術設定、分析の調整が必要です。マルチエージェントチームがエンドツーエンドでこれをすべて処理します：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;市場リサーチエージェント&lt;/strong&gt; — 競合他社を分析し、価格ギャップを特定し、競合情報名を生成&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;コンテンツストラテジスト&lt;/strong&gt; — ランディングページコピーを執筆し、プロモーション素材を作成し、メールシークエンスを設計&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;テクニカルスペシャリスト&lt;/strong&gt; — デプロイ、支払い統合、アナリティクス設定を処理&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;プロダクトマネージャーエージェント&lt;/strong&gt; — 全出力をローンチスケジュールに統合&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;これが私が &lt;a class="link" href="https://ckw19810413.github.io/zh-tw/" &gt;Slashman Tools&lt;/a&gt; で新しいプロダクトをリリースする際に使用しているパターンです。マルチエージェントのアプローチで準備期間を数週から数時間に短縮します。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="mcp-の理解すべてを動かすプロトコル"&gt;MCP の理解：すべてを動かすプロトコル
&lt;/h2&gt;&lt;p&gt;これがすべて実現できるのは、&lt;strong&gt;Model Context Protocol (MCP)&lt;/strong&gt; のおかげです——AI エージェントがツール、サーバー、互いとどのように通信するかを定義するオープンスタンダード。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;シンプルに言うと：&lt;/strong&gt; MCP は AI エージェントの USB-C です。USB-C がデバイスを周辺機器に接続する方式来規準化するように、MCP は AI モデルをツール、データソース、他のエージェントに接続する方式来規準化します。&lt;/p&gt;
&lt;p&gt;Cowork は &lt;strong&gt;Streamable HTTP&lt;/strong&gt; 経由で MCP を実装しています——継続的な WebSocket 接続を必要としない軽量トランスポートで、あらゆる HTTP クライアントと連携できます。これにより、CI/CD パイプライン、サーバーレス関数、エッジコンピューティング環境への統合が容易になります。&lt;/p&gt;
&lt;p&gt;カスタム統合を作成したい開発者向けには、&lt;a class="link" href="https://github.com/slashman413/cowork" target="_blank" rel="noopener"
&gt;Cowork リポジトリ&lt;/a&gt;に完全な MCP ツールリストが文書化されています——&lt;code&gt;create_task&lt;/code&gt;、&lt;code&gt;register_agent&lt;/code&gt;、&lt;code&gt;get_roster&lt;/code&gt;、&lt;code&gt;claim_task&lt;/code&gt;、&lt;code&gt;complete_task&lt;/code&gt;、&lt;code&gt;file_report&lt;/code&gt;、&lt;code&gt;heartbeat&lt;/code&gt; などを含む。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="正しいエージェントアーキテクチャの選択"&gt;正しいエージェントアーキテクチャの選択
&lt;/h2&gt;&lt;p&gt;すべてのプロジェクトに 285 人のエージェントが必要です。以下の意思決定フレームワークを参照してください：&lt;/p&gt;
&lt;h3 id="単一プロジェクトチーム13-エージェント"&gt;単一プロジェクトチーム（1〜3 エージェント）
&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;適している&lt;/strong&gt;：小規模リポジトリ、個人プロジェクト、個人クリエイター&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;設定&lt;/strong&gt;：一つの LLM バックエンドに接続し、3〜5 人のエージェントロールを使用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;例&lt;/strong&gt;：コードレビュアー + ライター + リサーチャー&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="部門レベルチーム520-エージェント"&gt;部門レベルチーム（5〜20 エージェント）
&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;適している&lt;/strong&gt;：小チーム、スタートアップ、代理店&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;設定&lt;/strong&gt;：複数の LLM バックエンド、部門専属エージェント&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;例&lt;/strong&gt;：完全なエンジニアリング部門 + マーケティングチーム + データアナリスト&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="エンタープライズレベルチーム50-エージェント"&gt;エンタープライズレベルチーム（50+ エージェント）
&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;適している&lt;/strong&gt;：プロダクト会社、大規模コンテンツ運営&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;設定&lt;/strong&gt;：リモート脳の登録、カスタムエージェント作成、API 自動化&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;例&lt;/strong&gt;：全 19 部門、マルチプラットフォーム LLM ルーティング、CI/CD 統合&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Cowork はすべての三つのレベルにスケーラブル——小規模から始め、ニーズの成長に伴ってエージェントを増やせます。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="よくある落とし穴"&gt;よくある落とし穴
&lt;/h2&gt;&lt;p&gt;本番環境でマルチエージェントシステムを数か月運用した結果、最もよくある間違いは以下の通りです：&lt;/p&gt;
&lt;h3 id="1-エージェントが多すぎるコンテキストが少なすぎる"&gt;1. エージェントが多すぎる、コンテキストが少なすぎる
&lt;/h3&gt;&lt;p&gt;簡単なタスクに 20 人のエージェントを使うのはやめましょう。各エージェントはレイテンシとコンテキストオーバーヘッドを増加させます。2〜3 人のエージェントから始め、必要と確認してから増やしてください。&lt;/p&gt;
&lt;h3 id="2-エージェントロールの品質を無視する"&gt;2. エージェントロールの品質を無視する
&lt;/h3&gt;&lt;p&gt;不適切に書かれたエージェント定義は不適切な結果を生みます。正確なロール説明、スキルリスト、プロンプトインストラクションを注意深く設計する時間を投資してください。Cowork の既存の 285 人のエージェントはすべて注意深く設計されています——それをテンプレートとして使ってください。&lt;/p&gt;
&lt;h3 id="3-タスク完了追跡を見逃す"&gt;3. タスク完了追跡を見逃す
&lt;/h3&gt;&lt;p&gt;必ず完了追跡を設定してください。Cowork のダッシュボードは一目で分かりますが、長時間実行されるワークフローの場合は通知も設定すべきです。&lt;/p&gt;
&lt;h3 id="4-単一ベンダー依存"&gt;4. 単一ベンダー依存
&lt;/h3&gt;&lt;p&gt;少なくとも二つの LLM バックエンドに接続してください。一つのプラットフォームがダウンするかレート制限を受けた場合、エージェントチームがもう一方に切り替えます。Cowork は自動的にマルチプラットフォームルーティングを処理します。&lt;/p&gt;
&lt;h3 id="5-重要な意思決定に人間の検証がない"&gt;5. 重要な意思決定に人間の検証がない
&lt;/h3&gt;&lt;p&gt;セキュリティ監査、財務分析、法務レビュー——AI 出力に基づいて行動する前に、必ず人間の検証を行ってください。エージェントは強力なアシスタントですが、高リスクな作業領域における自律的判断者ではありません。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="次のステップ"&gt;次のステップ
&lt;/h2&gt;&lt;p&gt;これで稼働するマルチエージェント AI システムを手に入れました。次のステップ：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;今日：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;http://localhost:6868/&lt;/code&gt; のダッシュボードを探索&lt;/li&gt;
&lt;li&gt;異なるエージェントに 3 つの異なるタスクをディスペッチ&lt;/li&gt;
&lt;li&gt;エージェント roster を閲覧し、予期せぬ専門家に気づく&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;今週：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;冗長用に二つ目の LLM バックエンドに接続&lt;/li&gt;
&lt;li&gt;カスタムエージェント定義を作成（既存の &lt;code&gt;.md&lt;/code&gt; ファイルをコピーして修正）&lt;/li&gt;
&lt;li&gt;毎日の市場調査またはコードレビューの定期タスクを設定&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;今月：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;CI/CD パイプラインに Cowork を統合&lt;/li&gt;
&lt;li&gt;多ステップワークフローを構築（3+ エージェントが順に実行）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://github.com/slashman413/cowork" target="_blank" rel="noopener"
&gt;Cowork ドキュメント&lt;/a&gt;を参照して、リモート脳登録やカスタム実行器などの高度な機能を理解&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;完全な&lt;a class="link" href="https://ckw19810413.github.io/multi-agent-coworking-platform/" &gt;マルチエージェント AI 協調プラットフォームガイド&lt;/a&gt;には、アーキテクチャ、ユースケース、他のフレームワークとの比較が含まれています——戦略的な概要を入手するために参照してください。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="よくある質問"&gt;よくある質問
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;Q：Cowork を使うために Python や AI エンジニアリングの知識が必要ですか？&lt;/strong&gt;
A：いいえ。&lt;code&gt;git clone&lt;/code&gt; と &lt;code&gt;npm install&lt;/code&gt; が実行できれば、Cowork を設定できます。エージェントの roster は事前設定済みです。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：Cowork をクラウドサーバー上で実行できますか？&lt;/strong&gt;
A：はい。Cowork は Node.js がインストールされたあらゆるマシンで実行できます。VPS、クラウド VM、ラズベリーパイへのデプロイが可能です。ダッシュボードと MCP エンドポイントはネットワーク経由でアクセスできます。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：同時にいくつのエージェントを実行できますか？&lt;/strong&gt;
A：Cowork は同時実行数に制限を設けていません——制限はあなたの LLM バックエンドとハードウェアによります。現代の GPU を備えた単一マシンで 5〜10 人のエージェントを並行実行できます。複数のバックエンドを備えたエンタープライズ設定ではより高い数にスケーリング可能です。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：Cowork は無料でオープンソースですか？&lt;/strong&gt;
A：はい。Cowork は MIT ライセンスで、&lt;a class="link" href="https://github.com/slashman413/cowork" target="_blank" rel="noopener"
&gt;GitHub&lt;/a&gt; で入手可能です。有料プランはありません、隠し制限もありません。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q：Cowork は CrewAI / AutoGen と何が異なりますか？&lt;/strong&gt;
A：Cowork は「幅」に焦点を当てています——19 部門にわたる 285 以上の事前設定エージェント、マルチプラットフォーム LLM サポート、ファイルシステムファーストのアプローチ。CrewAI は順序エージェントチェーンに優れ、AutoGen は会話型マルチエージェントパターンに優れています。Cowork の優位性は、厳選された専門家の roster にリアルタイムでアクセスできることです。&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="結論あなたの-ai-エージェントチームは準備完了"&gt;結論：あなたの AI エージェントチームは準備完了
&lt;/h2&gt;&lt;p&gt;マルチエージェント AI 協調は未来の技術ではありません——今日すぐに使えるツールです。20 分で、ゼロから 285 人の専門家が利用可能な稼働中のマルチエージェントシステムに至りました。&lt;/p&gt;
&lt;p&gt;重要な洞察：&lt;strong&gt;一つの AI モデルはジャネナリストです。AI エージェントチームは専門家の組織です。&lt;/strong&gt; MCP プロトコルで協調する専門エージェントを通じて、従来は人類のチーム全体を必要とする複雑なワークフロー——コード監査、コンテンツ制作、市場調査、プロダクトリリース——を数日で数時間ではなく、数分で自動化できます。&lt;/p&gt;
&lt;p&gt;Cowork MCP フレームワークはこのすべてを実用的にしました。オープンソース、セルフホスト可能、Node.js がインストールされたあらゆるマシンで動作します。ベンダーロックインはありません、クラウド依存はありません。ただ、ニーズの成長に合わせて拡張するクリーンでモジュールなシステムがあります。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a class="link" href="https://github.com/slashman413/cowork" target="_blank" rel="noopener"
&gt;GitHub で Cowork をフォーク&lt;/a&gt;、今日のうちに初めての AI エージェントチームを構築しましょう。&lt;/strong&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;読了時間：12 分 | 公開日：2026-07-26 | 最終更新：2026-07-26&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;&lt;a class="link" href="https://gumroad.com/l/diwoc" target="_blank" rel="noopener"
&gt;AI Prompt Library&lt;/a&gt; の即席使える AI プロンプトテンプレート——開発、コンテンツ制作、ビジネス自動化に対応——もご覧ください。&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;[&lt;a class="link" href="https://ckw19810413.github.io/" &gt;ホームに戻る&lt;/a&gt;]&lt;/p&gt;</description></item></channel></rss>