memos-cloud

MemOS Cloud

このスキルは、ユーザーが実際のプロジェクトに MemOS Cloud を統合する際に役立ちます。幅広い API の概要より、ソースに基づくコードと、タスクに必要な最小限のドキュメントを優先してください。

必須のワークフロー

1. リソースを読む前に、このスキルのフォルダーから scripts/upgrade.py を実行してください。ネットワークアクセスがブロックされている場合は、リソースの同期に失敗したことを報告し、既にバンドルされているリソースを使用して作業を続けてください。
2. このスキルが機能していることを確認してください。少なくとも resources/cn/index.md または resources/en/index.md が存在し、読み取り可能であることを確認してください。ファイルを読み取れない場合は、作業を中止し、スキルのインストールが壊れていることを報告してください。
3. resources/index.md を読み、リソースのロケールを選択してください。
   • 中国語のユーザーリクエスト、または中国語の製品・ドキュメントに関する作業には、resources/cn/index.md を使用してください。
   • 英語のユーザーリクエストには、resources/en/index.md を使用してください。
   • ユーザーの言語が混在している場合は、依頼された成果物で使われている言語を優先してください。
4. 「MemOS を統合する」「長期記憶を追加する」「Agent に記憶させる」「接入 MemOS」「长期记忆」などの幅広いリクエストでは、API リファレンスを読む前に、選択したロケールの starter-pack.md を読んでください。
5. 選択したロケールの index.md を使って、必要最小限のリソースを選んでください。既定ですべてのリソースを読み込まないでください。
6. MEMOS_API_KEY の環境変数を確認してください。
   • 存在し、mpg- で始まる場合は、接続を確認するために簡単な追加と検索の検証を実行してください。書き込んだ内容と取得した内容をユーザーに示してください。
   • 設定されていないか、プレースホルダーの場合は、処理を続けてください。続行には Key の設定が必要であることをユーザーに伝えてください。次の手順を案内してください。https://memos-dashboard.openmem.net/cn/quickstart にアクセスして Key を取得し、export MEMOS_API_KEY="mpg-..." を実行します。ユーザーが Key を設定したことを確認するまで待ってから、検証を実行してください。
   • 検証に成功したら、結果を報告して停止してください。ユーザーが明示的に依頼しない限り、次の指示を待ちます。プロジェクトの調査、統合方法の選択、コードの生成は行わないでください。

次の手順は、ユーザーが統合コードを明示的に依頼した場合にのみ実行してください。

7. ユーザーのプロジェクトを調査してください。ローカルファイルから、バックエンドとフロントエンドの境界、パッケージマネージャー、フレームワーク、ランタイム、既存の LLM 呼び出し経路、認証モデル、テストコマンドを特定してください。
8. 統合方法を選択してください。
   • 製品または Vibe Coding の統合では、ユーザーが Chat API を通じて MemOS に返信を生成させたいと明示的に希望しない限り、addMessage と searchMemory を使ったサーバーサイド API／SDK 統合を優先してください。
   • ナレッジベース検索では、features-knowledge-base.md と api-search-memory.md を組み合わせてください。
9. 特定したスタックに適合するコードを生成してください。Python SDK は Python バックエンドにのみ使用し、Node／TypeScript、Java／Spring、ブラウザー拡張機能のバックエンド、その他の非 Python スタックでは HTTP を使用してください。
10. プロジェクトで可能な場合は、生成した統合コードを使って最終検証を実行してください（テスト、型チェック、リンティング、またはライブでの追加と検索の呼び出し）。

必ず守るべきガードレール

• 内部スキルファイル名（starter-pack、reference-pack、advanced-pack、index.md など）をエンドユーザーに公開しないでください。これらは内部ルーティング用です。ユーザーに提示するのは、実行可能な出力だけです。
• MemOS API キーはサーバー側に保持してください。キーをブラウザーバンドル、モバイルクライアント、コンテンツスクリプト、公開設定、コミット済みファイルに含めてはいけません。
• プロジェクトですでに検証済みの上書き設定がある場合を除き、ドキュメントに記載された Cloud のベース URL https://memos.memtensor.cn/api/openmem/v1 を使用してください。
• 同梱の API リファレンスに記載された検証済みのエンドポイントパスを使用してください。主要な HTTP 呼び出しには、POST /add/message と POST /search/memory を優先してください。
• 選択した経路で必要な場合を除き、MemOS Cloud、オープンソースのローカルデプロイ、MCP、Dashboard のセットアップ、CLI のセットアップを混在させないでください。
• user_id は安定したエンドユーザー識別子として、conversation_id は安定したスレッド／セッション識別子として扱ってください。製品として継続性を意図的に不要としている場合を除き、ターンごとにランダムな ID を使用しないでください。
• ドキュメントが不完全、一貫していない、または古い場合は、その不足を明示し、挙動を作り上げるのではなく、検証済みの範囲で最も限定的な経路を選択してください。
• 削除、フィードバック、プロジェクト設定、Cloud とオープンソースの境界に関する質問には、慎重に対応し、回答する前に関連するリファレンスを確認してください。

リソースのルーティング

resources/index.md から開始してください。ここでは言語のみを選択します。次に、タスクのルートについて resources/cn/index.md または resources/en/index.md を使用してください。

• 初回の統合、接続確認、プロジェクトの調査、安全ルールについては starter-pack.md を参照してください。
• API リファレンスのルーティング、ナレッジベースのルーティング、削除／フィードバック／チャットのリファレンス、エンドポイントの参照元に関するガードレールについては reference-pack.md を参照してください。
• マルチモーダル入力、Tool Memory、Skill Memory、フィルター、タグ、非同期処理の詳細、その他の高度な機能については advanced-pack.md を参照してください。
• エージェントループのアーキテクチャと一般的な API／SDK パターンについては integration-guide.md を参照してください。
• デフォルトの製品統合ループについては api-add-message.md および api-search-memory.md を参照してください。
• ユーザーのメモリーを一覧表示／調査する場合（および削除前に memory_ids を解決する場合）は api-get-memory.md を参照してください。
• 候補ドキュメントの関連性を再ランク付けする場合（searchMemory の代替ではありません）は api-rerank.md を参照してください。
• MemOS にメモリーと返信生成の両方を任せたい場合に限り、api-chat.md を参照してください。
• ドキュメント／ナレッジベースの検索については features-knowledge-base.md を参照してください。
• リクエストされた機能で必要な場合に限り、features-filters.md、features-async-mode.md、features-tool-memory.md、features-skill.md、features-multimodal.md を参照してください。
• 制限事項、エラーの切り分け、デプロイに関する注意事項については faq-and-limits.md を参照してください。

出力の要件

統合コードを作成する際は、以下を含めてください。

1. 変更または提案したファイル。
2. 必要な環境変数。
3. 使用したリクエスト／レスポンスの形式。
4. メモリー検索の結果を LLM プロンプトに挿入する場所。
5. 完了したユーザー／アシスタントのターンを書き戻す場所。
6. MEMOS_API_KEY を使わないローカル確認と、任意で行う MEMOS_API_KEY を使った実環境での確認を含む検証手順。
7. 未解決の製品上またはドキュメント上の不足点。