Labsco
pinecone-io logo

pinecone-assistant

✓ Official★ 14

by pinecone-io · part of pinecone-io/skills

Create, manage, and chat with Pinecone Assistants for document Q&A with citations. Handles all assistant operations - create, upload, sync, chat, context retrieval, and list. Recognizes natural language like "create an assistant from my docs", "ask my assistant about X", or "upload my docs to Pinecone".

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#automation#git#memory
🧩 One of 7 skills in the pinecone-io/skills package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Pinecone Assistant

Pinecone Assistant is a fully managed RAG service. Upload documents, ask questions, get cited answers. No embedding pipelines or infrastructure required.

All scripts are in scripts/ relative to this skill directory. Run with: uv run scripts/script_name.py [arguments]

<<clarify_style>>

Operations

What to doScriptKey args
Create an assistantscripts/create.py--name --instructions --region
Upload filesscripts/upload.py--assistant --source --patterns
Sync files (incremental)scripts/sync.py--assistant --source --delete-missing --dry-run
Chat / ask a questionscripts/chat.py--assistant --message
Get context snippetsscripts/context.py--assistant --query --top-k
List assistantsscripts/list.py--files --json

For full workflow details on any operation, read the relevant file in references/.

Natural Language Recognition

Proactively handle these patterns without requiring explicit commands:

Create: "create an assistant", "make an assistant called X", "set up an assistant for my docs" → See references/create.md

Upload: "upload my docs", "add files to my assistant", "index my documentation" → See references/upload.md

Sync: "sync my docs", "update my assistant", "keep assistant in sync", "refresh from ./docs" → See references/sync.md

Chat: "ask my assistant about X", "what does my assistant know about X", "chat with X" → See references/chat.md

Context: "search my assistant for X", "find context about X" → See references/context.md

List: "show my assistants", "what assistants do I have" → Run uv run scripts/list.py

Conversation Memory

Track the last assistant used within the conversation:

  • When a user creates or first uses an assistant, remember its name
  • If user says "my assistant", "it", or "the assistant" → use the last one
  • Briefly confirm which assistant you're using: "Asking docs-bot..."
  • If ambiguous and multiple exist → ask the user to clarify

Multi-Step Requests

Handle chained requests naturally. Example:

"Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are"

  1. uv run scripts/create.py --name docs-bot
  2. uv run scripts/upload.py --assistant docs-bot --source ./docs
  3. uv run scripts/chat.py --assistant docs-bot --message "what are the main features?"