# GEO Wiki エージェントスキル使用ガイド > AI エージェントにナレッジベースを自動管理させ、一コマンドで記事を公開 --- ## 🎯 エージェントスキルとは？ エージェントスキルは GEO Wiki が提供する AI エージェント統合機能で、AI エージェントが CLI または API を通じて直接ナレッジベースを管理できるようにします。 **コア機能**： - 📝 インテリジェントコンテンツ生成 - 🏷️ 自動分類・タグ付け - 🌍 多言語同期 - 🎨 レイアウト最適化 - 📊 SEO/GEO 最適化 --- ## 🚀 クイックスタート ### ステップ 1：Wiki にログイン ```bash geo login --url http://localhost:3002 --user admin --pass Admin123 ``` ### ステップ 2：ドキュメントを公開 ```bash # ファイルから公開 geo doc create --file ./article.md --category tech # AI が自動生成して公開 geo llm generate --title "製品紹介" --category products ``` ### ステップ 3：公開を確認 ```bash geo doc list --category tech ``` --- ## 📋 スマート分類ルール エージェントは以下のルールに基づいてドキュメントを自動分類する必要があります： ### カテゴリマッピング | コンテンツタイプ | カテゴリスラッグ | タグ | |-----------------|-----------------|------| | 製品仕様書 | `can-motion` | 製品, 技術仕様 | | 製品マニュアル | `can-motion` | 製品, ユーザーマニュアル | | プロトコルアダプター | `protocol-adapter` | プロトコル, アダプター | | コード例 | `code-examples` | コード, 例 | | クイックスタート | `support` | クイックスタート, チュートリアル | | FAQ | `faq` | FAQ, Q&A | | 技術チュートリアル | `support` | チュートリアル, 技術 | ### タグ生成ルール ```yaml # コンテンツに基づいてタグを自動生成 tags: - 製品モデル（例：UIM342） - 技術特性（例：CAN-bus, closed-loop） - アプリケーションシナリオ（例：産業自動化） - コンテンツタイプ（例：チュートリアル, 仕様書） ``` --- ## 🎨 レイアウト規範 ### ドキュメント構造テンプレート ```yaml --- title: ドキュメントタイトル slug: url-friendly-slug category: カテゴリスラッグ tags: [タグ1, タグ2] author: admin description: 20 文字以上の説明 language: jp notice: "💡 このページのヒップメッセージ" schema: type: TechArticle datePublished: YYYY-MM-DD dateModified: YYYY-MM-DD --- # ドキュメントタイトル > 一文要約 --- ## 製品概要 ## 主要機能 ## 技術仕様 ## アプリケーションシナリオ ## コード例 ## 関連ドキュメント --- *最終更新: YYYY-MM-DD | バージョン: v2.9.0* ``` ### Notice 自動生成ルール コンテンツに基づいて notice を自動生成： | コンテンツタイプ | Notice テンプレート | |----------------|---------------------| | 製品ドキュメント | "📋 このページには {製品モデル} の詳細な技術仕様が含まれています" | | チュートリアル | "💡 このチュートリアルには {前提条件} が必要で、完了までに {時間} が必要です" | | FAQ | "❓ よくある質問、クリックして詳細な回答を表示" | | コード例 | "💻 このページには実行可能なサンプルコードが含まれています" | | 安全注意 | "⚠️ 重要な安全注意事項、操作前に必ずお読みください" | --- ## 🔧 CLI コマンドリファレンス ### ドキュメント管理 ```bash # ドキュメント作成 geo doc create -f ./doc.md -c category -T "tag1,tag2" # ドキュメント更新 geo doc update --slug doc-slug -f ./updated.md # ドキュメント削除 geo doc delete --slug doc-slug # ドキュメント一覧 geo doc list --category products --json # 単一ドキュメント取得 geo doc get --slug doc-slug ``` ### カテゴリ管理 ```bash # カテゴリ作成 geo category create --name "カテゴリ名" --slug category-slug # カテゴリ一覧 geo category list --json ``` ### AI 機能 ```bash # AI ドキュメント生成 geo llm generate --title "タイトル" --category cat --lang jp # AI ドキュメント翻訳 geo llm translate --slug doc-slug --target-lang en # AI ドキュメント最適化 geo llm optimize --slug doc-slug --mode replace ``` --- ## 📊 完全なワークフロー例 ### シナリオ：バッチインポート製品ドキュメント ```bash #!/bin/bash # バッチインポート製品ドキュメント # ログイン geo login --url http://localhost:3002 --user admin --pass Admin123 # カテゴリ作成（存在しない場合） geo category create --name "製品ドキュメント" --slug products # バッチ公開 for f in ./products/*.md; do echo "公開: $f" geo doc create -f "$f" -c products -T "製品ドキュメント,インポート" done # 確認 geo doc list --category products --json ``` ### シナリオ：多言語同期 ```bash #!/bin/bash # 中国語ドキュメント公開後に自動翻訳 # 中国語版を公開 geo doc create -f ./doc-zh.md -c products # 英語に翻訳 geo llm translate --slug doc-slug --target-lang en # 確認 geo doc get --slug doc-slug --lang en ``` --- ## 🤖 エージェント統合設定 ### Claude Code / OpenClaw ```json { "tools": { "geo-wiki": { "command": "geo", "args": ["--url", "http://localhost:3002"] } } } ``` ### 環境変数設定 ```bash export GEO_URL=http://localhost:3002 export GEO_USER=admin export GEO_PASS=Admin123 ``` --- ## 📚 API リファレンス ### 認証 ```bash # ログインして Cookie を取得 curl -X POST http://localhost:3002/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"Admin123"}' \ -c cookies.txt ``` ### ドキュメント操作 | 機能 | メソッド | パス | |------|---------|------| | ドキュメント一覧 | GET | `/api/v1/docs` | | ドキュメント取得 | GET | `/api/v1/docs/:slug` | | ドキュメント作成 | POST | `/api/v1/admin/docs` | | ドキュメント更新 | PUT | `/api/v1/admin/docs/:slug` | | ドキュメント削除 | DELETE | `/api/v1/admin/docs/:slug` | | ドキュメント検索 | GET | `/api/v1/docs/search?q=keyword` | ### AI 機能 | 機能 | メソッド | パス | |------|---------|------| | AI 生成 | POST | `/api/v1/llm/generate` | | AI 翻訳 | POST | `/api/v1/llm/translate` | | AI 最適化 | POST | `/api/v1/llm/optimize` | | AI 分析 | POST | `/api/v1/llm/analyze` | --- ## ❓ よくある質問 **Q: エージェントスキルは追加料金がかかりか？** A: いいえ。エージェントスキルは GEO Wiki の組み込み機能で、無料で使用できます。 **Q: どの AI エージェントがサポートされていますか？** A: CLI または API 呼び出しをサポートするすべてのエージェント。 **Q: CSRF 問題を処理するには？** A: Cookie 認証を使用している場合、CSRF トークンは自動的に処理されます。問題が発生した場合は、新しい Cookie を取得するために再ログインしてください。 --- ## 🚀 次のステップ 1. **エージェントスキルを試す** → ローカルで GEO Wiki を起動して試す 2. **CLI ドキュメントを読む** → 完全なコマンドリファレンス 3. **AI 機能を読む** → AI 生成と最適化機能を学ぶ --- *最終更新: 2026-05-26 | バージョン: v2.9.0*