docs: add Japanese documents

2026-07-20 13:47:15 +08:00 · 2026-03-18 19:13:39 +09:00
parent 8bb16c48c0
commit 5487c0befe
49 changed files with 2417 additions and 2 deletions
--- a/docs/ja/intro/architecture.mdx
+++ b/docs/ja/intro/architecture.mdx
@@ -0,0 +1,77 @@
+---
+title: アーキテクチャ
+description: CowAgent 2.0 のシステムアーキテクチャとコア設計
+---
+
+CowAgent 2.0 は、シンプルなチャットボットから、自律的な思考、タスク計画、長期記憶、Skill の拡張性を備えた Agent アーキテクチャのスーパーインテリジェントアシスタントへと進化しました。
+
+## システムアーキテクチャ
+
+CowAgent のアーキテクチャは以下のコアモジュールで構成されています：
+
+<img src="https://cdn.link-ai.tech/doc/68ef7b212c6f791e0e74314b912149f9-sz_5847990.png" alt="CowAgent Architecture" />
+
+### コアモジュール
+
+| モジュール | 説明 |
+| --- | --- |
+| **Channels** | メッセージの受信と送信を行うメッセージチャネル層。Web、Feishu（飛書）、DingTalk（釘釘）、WeCom（企業微信）、WeChat公式アカウントなどをサポート |
+| **Agent Core** | タスク計画、記憶システム、Skill エンジンを含む Agent エンジン |
+| **Tools** | Agent が OS リソースにアクセスするためのツール層。10 以上の組み込みツール |
+| **Models** | 主要な LLM への統一アクセスを提供するモデル層 |
+
+## Agent モードのワークフロー
+
+Agent モードが有効な場合、CowAgent は以下のワークフローで自律的な Agent として動作します：
+
+1. **メッセージ受信** — チャネルを通じてユーザーの入力を受信
+2. **意図の理解** — タスク要件とコンテキストを分析
+3. **タスク計画** — 複雑なタスクを複数のステップに分解
+4. **ツール呼び出し** — 各ステップに適切なツールを選択・実行
+5. **記憶の更新** — 重要な情報を長期記憶に保存
+6. **結果の返却** — 実行結果をユーザーに送信
+
+## ワークスペースのディレクトリ構成
+
+Agent のワークスペースはデフォルトで `~/cow` にあり、システムプロンプト、記憶ファイル、Skill ファイルを格納しています：
+
+```
+~/cow/
+├── system.md          # Agent システムプロンプト
+├── user.md            # ユーザープロフィール
+├── memory/            # 長期記憶ストレージ
+│   ├── core.md        # コアメモリ
+│   └── daily/         # デイリーメモリ
+└── skills/            # カスタム Skill
+    ├── skill-1/
+    └── skill-2/
+```
+
+シークレットキーはセキュリティのため `~/.cow` ディレクトリに別途保存されます：
+
+```
+~/.cow/
+└── .env               # Skill 用のシークレットキー
+```
+
+## コア設定
+
+`config.json` で Agent モードのパラメータを設定します：
+
+```json
+{
+  "agent": true,
+  "agent_workspace": "~/cow",
+  "agent_max_context_tokens": 40000,
+  "agent_max_context_turns": 30,
+  "agent_max_steps": 15
+}
+```
+
+| パラメータ | 説明 | デフォルト値 |
+| --- | --- | --- |
+| `agent` | Agent モードの有効化 | `true` |
+| `agent_workspace` | ワークスペースのパス | `~/cow` |
+| `agent_max_context_tokens` | 最大コンテキストトークン数 | `40000` |
+| `agent_max_context_turns` | 最大コンテキストターン数 | `30` |
+| `agent_max_steps` | タスクあたりの最大判断ステップ数 | `15` |
--- a/docs/ja/intro/features.mdx
+++ b/docs/ja/intro/features.mdx
@@ -0,0 +1,105 @@
+---
+title: 機能詳細
+description: CowAgent の長期記憶、タスク計画、Skill システムの詳細
+---
+
+## 1. 長期記憶
+
+記憶システムにより、Agent は重要な情報を長期にわたって記憶できます。ユーザーが好みや決定、重要な事実を共有すると、Agent は自発的に情報を保存し、会話が一定の長さに達すると自動的に要約を抽出します。記憶はコアメモリとデイリーメモリに分かれており、キーワード検索とベクトル検索の両方をサポートするハイブリッド検索が可能です。
+
+初回起動時、Agent はユーザーに重要な情報を自発的に尋ね、ワークスペース（デフォルト `~/cow`）に記録します。これには Agent の設定、ユーザーの身元情報、記憶ファイルが含まれます。
+
+その後の長期的な会話において、Agent は必要に応じてインテリジェントに記憶を保存・取得し、自身の設定やユーザーの好み、記憶ファイルを継続的に更新し、経験と教訓を要約します。これにより、真に自律的な思考と継続的な成長を実現しています。
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203000455.png" width="800" />
+</Frame>
+
+## 2. タスク計画とツール活用
+
+ツールは Agent がオペレーティングシステムのリソースにアクセスするための中核です。Agent はタスク要件に基づいてインテリジェントにツールを選択・呼び出し、ファイルの読み書き、コマンド実行、スケジュールタスクなどを実行します。組み込みツールはプロジェクトの `agent/tools/` ディレクトリに実装されています。
+
+**主なツール：** ファイルの読み書き・編集、Bash ターミナル、ファイル送信、スケジューラ、記憶検索、Web 検索、環境設定など。
+
+### 2.1 ターミナルとファイルアクセス
+
+OS のターミナルとファイルシステムへのアクセスは、最も基本的かつ中核的な機能です。多くの他のツールや Skill はこの機能の上に構築されています。ユーザーはモバイルデバイスから Agent とやり取りし、パソコンやサーバーのリソースを操作できます：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202181130.png" width="800" />
+</Frame>
+
+### 2.2 プログラミング能力
+
+プログラミングとシステムアクセスを組み合わせることで、Agent は完全な **Vibecoding ワークフロー** を実行できます。情報検索、アセット生成、コーディング、テスト、デプロイ、Nginx 設定、公開まで、すべてスマートフォンからの一つのコマンドで実行可能です：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203121008.png" width="800" />
+</Frame>
+
+### 2.3 スケジュールタスク
+
+`scheduler` ツールにより動的なスケジュールタスクが可能で、**ワンタイムタスク、固定間隔、Cron 式**をサポートしています。タスクは**固定メッセージ送信**または **Agent 動的タスク**実行としてトリガーできます：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202195402.png" width="800" />
+</Frame>
+
+### 2.4 環境変数管理
+
+Skill が必要とするシークレットキーは環境変数ファイルに保存され、`env_config` ツールによって管理されます。会話を通じてシークレットを更新でき、セキュリティ保護とマスキング機能が組み込まれています：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234939.png" width="800" />
+</Frame>
+
+## 3. Skill システム
+
+Skill システムは Agent に無限の拡張性を提供します。各 Skill は説明ファイル、実行スクリプト（任意）、リソース（任意）で構成され、特定のタイプのタスクを完了する方法を記述します。Skill により Agent は複雑なワークフローの指示に従い、ツールを呼び出し、サードパーティシステムと連携できます。
+
+- **組み込み Skill：** プロジェクトの `skills/` ディレクトリにあり、Skill クリエイター、画像認識、LinkAI Agent、Web フェッチなどが含まれます。組み込み Skill は依存条件（API キー、システムコマンドなど）に基づいて自動的に有効化されます。
+- **カスタム Skill：** ユーザーが会話を通じて作成し、ワークスペース（`~/cow/skills/`）に保存されます。あらゆる複雑なビジネスプロセスやサードパーティ連携を実装できます。
+
+### 3.1 Skill の作成
+
+`skill-creator` Skill により、会話を通じて Skill を素早く作成できます。ワークフローを Skill としてコード化するよう Agent に依頼したり、API ドキュメントやサンプルを送信して Agent に直接連携を完成させることができます：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
+</Frame>
+
+### 3.2 Web 検索と画像認識
+
+- **Web 検索：** 組み込みの `web_search` ツールで、複数の検索エンジンをサポートします。`BOCHA_API_KEY` または `LINKAI_API_KEY` を設定して有効化してください。
+- **画像認識：** 組み込みの `openai-image-vision` Skill で、`gpt-4.1-mini`、`gpt-4.1` などのモデルをサポートします。`OPENAI_API_KEY` が必要です。
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202213219.png" width="800" />
+</Frame>
+
+### 3.3 サードパーティナレッジベースとプラグイン
+
+`linkai-agent` Skill により、[LinkAI](https://link-ai.tech/) 上のすべての Agent を Skill として利用でき、マルチ Agent による意思決定が可能になります。
+
+設定方法：`env_config` で `LINKAI_API_KEY` を設定し、`skills/linkai-agent/config.json` に Agent の説明を追加します：
+
+```json
+{
+  "apps": [
+    {
+      "app_code": "G7z6vKwp",
+      "app_name": "LinkAI Customer Support",
+      "app_description": "Select only when the user needs help with LinkAI platform questions"
+    },
+    {
+      "app_code": "SFY5x7JR",
+      "app_name": "Content Creator",
+      "app_description": "Use only when the user needs to create images or videos"
+    }
+  ]
+}
+```
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234350.png" width="750" />
+</Frame>
--- a/docs/ja/intro/index.mdx
+++ b/docs/ja/intro/index.mdx
@@ -0,0 +1,68 @@
+---
+title: はじめに
+description: CowAgent - LLM を活用した AI スーパーアシスタント
+---
+
+<img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="600px"/>
+
+**CowAgent** は、自律的なタスク計画、長期記憶、Skill システム、マルチモーダルメッセージ、複数モデル対応、マルチプラットフォームデプロイを備えた、LLM を活用した AI スーパーアシスタントです。
+
+CowAgent は自ら思考しタスクを計画し、コンピュータや外部リソースを操作し、Skill を作成・実行し、長期記憶により継続的に成長します。複数モデルの柔軟な切り替えをサポートし、テキスト、音声、画像、ファイルなどのマルチモーダルメッセージを処理でき、Web、Feishu（飛書）、DingTalk（釘釘）、WeCom（企業微信）、WeChat公式アカウントに統合できます。お使いのパソコンやサーバー上で24時間365日稼働します。
+
+<Card title="GitHub" icon="github" href="https://github.com/zhayujie/chatgpt-on-wechat">
+  github.com/zhayujie/chatgpt-on-wechat
+</Card>
+
+## コア機能
+
+<CardGroup cols={2}>
+  <Card title="自律タスク計画" icon="brain" href="/ja/intro/architecture">
+    複雑なタスクを理解し、自律的に実行計画を立て、目標が達成されるまで思考とツール呼び出しを続けます。ツールを通じてファイルシステム、ターミナル、ブラウザ、スケジューラなどのシステムリソースにアクセスできます。
+  </Card>
+  <Card title="長期記憶" icon="database" href="/ja/memory">
+    会話の記憶をローカルファイルやデータベースに自動的に永続化します。コアメモリとデイリーメモリを含み、キーワード検索とベクトル検索に対応しています。
+  </Card>
+  <Card title="Skill システム" icon="puzzle-piece" href="/ja/skills/index">
+    Skill の作成・実行エンジンを実装し、組み込み Skill を搭載。自然言語の会話を通じてカスタム Skill の開発もサポートしています。
+  </Card>
+  <Card title="マルチモーダルメッセージ" icon="image" href="/ja/channels/web">
+    テキスト、画像、音声、ファイルなどのメッセージタイプの解析、処理、生成、送信をサポートします。
+  </Card>
+  <Card title="複数モデル対応" icon="microchip" href="/ja/models/index">
+    OpenAI、Claude、Gemini、DeepSeek、MiniMax、GLM、Qwen、Kimi、Doubao など、主要なモデルプロバイダーをサポートしています。
+  </Card>
+  <Card title="マルチプラットフォームデプロイ" icon="server" href="/ja/channels/web">
+    ローカルコンピュータやサーバー上で動作し、Web、Feishu（飛書）、DingTalk（釘釘）、WeChat公式アカウント、WeCom（企業微信）アプリケーションに統合できます。
+  </Card>
+</CardGroup>
+
+## クイック体験
+
+ターミナルで以下のコマンドを実行すると、ワンクリックでインストール、設定、起動ができます：
+
+```bash
+bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh)
+```
+
+デフォルトでは実行後に Web サービスが起動します。`http://localhost:9899/chat` にアクセスして Web インターフェースでチャットできます。
+
+<CardGroup cols={2}>
+  <Card title="クイックスタート" icon="rocket" href="/ja/guide/quick-start">
+    インストールと実行の完全ガイド
+  </Card>
+  <Card title="アーキテクチャ" icon="sitemap" href="/ja/intro/architecture">
+    CowAgent システムアーキテクチャ設計
+  </Card>
+</CardGroup>
+
+## 免責事項
+
+1. 本プロジェクトは [MIT License](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/LICENSE) に基づき、技術研究および学習を目的としています。利用者は現地の法律、規制、ポリシー、および企業の社内規程を遵守する必要があります。違法行為や権利侵害につながる利用は禁止されています。
+2. Agent モードは通常のチャットモードよりも多くのトークンを消費します。効果とコストを考慮してモデルを選択してください。Agent はホスト OS にアクセスできるため、デプロイには十分注意してください。
+3. CowAgent はオープンソース開発に注力しており、いかなる暗号通貨の発行、認可、参加も行っておりません。
+
+## コミュニティ
+
+WeChat でアシスタントを追加して、オープンソースコミュニティに参加しましょう：
+
+<img width="140" src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png" />