pinecone-assistant について
マネージドRAGサービスのPinecone Assistantを、スクリプトや自然言語の依頼で操作するスキルです。アシスタントの作成、文書のアップロードと同期、チャット、コンテキスト取得、一覧表示に対応します。
主な機能
- 01設定を指定したアシスタント作成
- 02ファイルのアップロードと差分同期
- 03チャットでの質問
- 04コンテキスト断片の取得
- 05アシスタントとファイルの一覧表示
活用シーン
- 01ドキュメント用アシスタントの作成
- 02文書コレクションのアップロードや更新
- 03質問と関連コンテキストの取得
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pinecone-io/ skills --skill pinecone-assistantインストール後、Claude Code で/pinecone-assistantを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/chat.mdcontext.mdcreate.mdlist.mdsync.mdupload.mdscripts/chat.pycontext.pycreate.pylist.pysync.pyupload.py詳細
Pinecone Assistant
Pinecone Assistant は、フルマネージド型の RAG サービスです。ドキュメントをアップロードして質問すると、引用付きの回答が得られます。埋め込みパイプラインやインフラストラクチャは必要ありません。
すべてのスクリプトは、このスキルディレクトリを基準とした
scripts/にあります。 次のコマンドで実行します:uv run scripts/script_name.py [arguments]
<<clarify_style>>
操作
| 実行すること | スクリプト | 主な引数 |
|---|---|---|
| アシスタントを作成する | scripts/create.py | --name --instructions --region |
| ファイルをアップロードする | scripts/upload.py | --assistant --source --patterns |
| ファイルを同期する(差分) | scripts/sync.py | --assistant --source --delete-missing --dry-run |
| チャットする/質問する | scripts/chat.py | --assistant --message |
| コンテキストの抜粋を取得する | scripts/context.py | --assistant --query --top-k |
| アシスタントを一覧表示する | scripts/list.py | --files --json |
各操作のワークフローの詳細については、references/ 内の該当ファイルをお読みください。
自然言語の認識
明示的なコマンドがなくても、次のようなパターンに対応します。
作成: "create an assistant", "make an assistant called X", "set up an assistant for my docs" → references/create.md を参照してください
アップロード: "upload my docs", "add files to my assistant", "index my documentation" → references/upload.md を参照してください
同期: "sync my docs", "update my assistant", "keep assistant in sync", "refresh from ./docs" → references/sync.md を参照してください
チャット: "ask my assistant about X", "what does my assistant know about X", "chat with X" → references/chat.md を参照してください
コンテキスト: "search my assistant for X", "find context about X" → references/context.md を参照してください
一覧表示: "show my assistants", "what assistants do I have"
→ uv run scripts/list.py を実行してください
会話の記憶
会話中に最後に使用したアシスタントを記憶します。
- ユーザーがアシスタントを作成するか、初めて使用したときは、その名前を記憶します
- ユーザーが "my assistant"、"it"、または "the assistant" と言った場合は、最後に使用したアシスタントを使います
- 使用するアシスタントを簡潔に確認します:"Asking docs-bot..."
- 複数のアシスタントがあり、どれを指しているか曖昧な場合は、ユーザーに確認します
複数ステップのリクエスト
連続するリクエストにも自然に対応します。例:
"Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are"
uv run scripts/create.py --name docs-botuv run scripts/upload.py --assistant docs-bot --source ./docsuv run scripts/chat.py --assistant docs-bot --message "what are the main features?"
前提条件
PINECONE_API_KEYを利用できる必要があります: <<api_key_setup>>uvがインストールされている必要があります — uv をインストール- 無料の API キーはこちらから取得できます:https://app.pinecone.io/?sessionType=signup