Skip to main content

​
Pinecone

ShanoneのPinecone連携は、ベクトルデータベースの全体像をカバーする85個のツールをエージェントに提供します。インデックス・ネームスペース管理、ベクトルのCRUD/検索、RAGチャット用のAssistant API、バックアップ/リストアに加えて、他の連携ではあまり扱われない組織レベルの管理機能(ユーザー、サービスアカウント、ロールバインディング)まで対応しています。

​
はじめに

1

Pinecone APIキーを作成する

Pineconeコンソールからキーを発行します。
2

Shanoneにキーを追加する

Shanoneダッシュボードの連携でPineconeを選択し、キー(pcsk_...)を貼り付けます。
3

リクエストを再実行する

保存が完了すると、pinecone_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはPinecone向けに85個のツールを、以下のカテゴリに整理して提供しています。
pinecone_list_indexes, pinecone_create_index, pinecone_describe_index, pinecone_delete_index, pinecone_configure_index, pinecone_create_index_for_model, pinecone_list_namespaces, pinecone_create_namespace, pinecone_describe_namespace, pinecone_delete_namespace, pinecone_upsert_records, pinecone_search_records
pinecone_upsert_vectors, pinecone_query_vectors, pinecone_fetch_vectors, pinecone_delete_vectors, pinecone_update_vector, pinecone_list_vectors, pinecone_describe_index_stats, pinecone_fetch_vectors_by_metadata
pinecone_list_assistants, pinecone_create_assistant, pinecone_describe_assistant, pinecone_update_assistant, pinecone_delete_assistant, pinecone_chat_assistant, pinecone_chat_completion_assistant, pinecone_context_assistant, pinecone_upload_assistant_file, pinecone_list_assistant_files, pinecone_describe_assistant_file, pinecone_upsert_assistant_file, pinecone_delete_assistant_file, pinecone_list_assistant_operations, pinecone_describe_assistant_operation
pinecone_create_backup, pinecone_list_index_backups, pinecone_list_project_backups, pinecone_describe_backup, pinecone_delete_backup, pinecone_create_index_from_backup, pinecone_list_restore_jobs, pinecone_describe_restore_job
pinecone_start_import, pinecone_list_imports, pinecone_describe_import, pinecone_cancel_import, pinecone_list_models, pinecone_describe_model, pinecone_generate_embeddings, pinecone_rerank
pinecone_list_collections, pinecone_create_collection, pinecone_describe_collection, pinecone_delete_collection
pinecone_admin_list_organizations, pinecone_admin_get_organization, pinecone_admin_update_organization, pinecone_admin_delete_organization, pinecone_admin_list_projects, pinecone_admin_create_project, pinecone_admin_get_project, pinecone_admin_update_project, pinecone_admin_delete_project
pinecone_admin_list_users, pinecone_admin_get_user, pinecone_admin_delete_user, pinecone_admin_list_api_keys, pinecone_admin_create_api_key, pinecone_admin_get_api_key, pinecone_admin_update_api_key, pinecone_admin_delete_api_key, pinecone_admin_list_invites, pinecone_admin_create_invite, pinecone_admin_get_invite, pinecone_admin_delete_invite, pinecone_admin_resend_invite, pinecone_admin_list_role_bindings, pinecone_admin_create_role_binding, pinecone_admin_get_role_binding, pinecone_admin_delete_role_binding, pinecone_admin_list_service_accounts, pinecone_admin_create_service_account, pinecone_admin_get_service_account, pinecone_admin_update_service_account, pinecone_admin_delete_service_account, pinecone_admin_rotate_service_account_secret

​
よくあるユースケース

セマンティック検索

テキストや埋め込みに最も近いベクトルを既存のインデックスから検索する

RAGアシスタントチャット

アップロードしたナレッジベース上にPinecone Assistantを作成し、直接チャットする

インデックスのライフサイクル管理

ワークロード用に新しいインデックスをプロビジョニングし、リスクの高い移行の前にバックアップを取る

一括インジェスト

ベクトルを一件ずつupsertする代わりに、オブジェクトストレージから一括インポートを開始する

​
トラブルシューティング

ベクトルの次元数はインデックスに設定された次元数と正確に一致する必要があります。特に埋め込みモデルを切り替えた後は、まずpinecone_describe_indexで確認してください。
これらは生のベクトルではなく、Pineconeの新しいRecords API(ネームスペース単位、統合推論による自動埋め込み対応)を操作します。shanone_get_tool_schemaでそれぞれが期待するフィールド形式を確認してください。
チャットする前にpinecone_describe_assistant_fileでファイルの処理が完了しているか確認してください——新しくアップロードされたファイルは、アシスタントが参照できるようになる前にインデックス化が必要です。
管理系エンドポイントには、プロジェクトレベルのキーではなく組織レベルのスコープを持つAPIキーが必要です。プロジェクトキーしか設定していない場合は、Pineconeコンソールから専用の管理者キーを発行してください。