[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-pinecone-pinecone-quickstart":3,"mdc--kli9xx-key":40,"related-org-pinecone-pinecone-quickstart":1406,"related-repo-pinecone-pinecone-quickstart":1557},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":35,"sourceUrl":38,"mdContent":39},"pinecone-quickstart","run interactive Pinecone quickstart for developers","Interactive Pinecone quickstart for new developers. Choose between two paths - Database (create an integrated index, upsert data, and query using Pinecone MCP + Python) or Assistant (create a Pinecone Assistant for document Q&A). Use when a user wants to get started with Pinecone for the first time or wants a guided tour of Pinecone's tools.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"pinecone","Pinecone","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fpinecone.png","pinecone-io",[13,17,20,23],{"name":14,"slug":15,"type":16},"Onboarding","onboarding","tag",{"name":18,"slug":19,"type":16},"Database","database",{"name":21,"slug":22,"type":16},"MCP","mcp",{"name":9,"slug":8,"type":16},14,"https:\u002F\u002Fgithub.com\u002Fpinecone-io\u002Fskills","2026-07-13T06:02:41.62555",null,2,[30,31,8,32,33,34],"agent-skills","agents","retrieval-augmented-generation","semantic-search","skills-sh",{"repoUrl":25,"stars":24,"forks":28,"topics":36,"description":37},[30,31,8,32,33,34],"Pinecone's official Agent Skills library, for use with agentic IDEs such as Cursor, Github Copilot, Antigravity, Gemini CLI and more.","https:\u002F\u002Fgithub.com\u002Fpinecone-io\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fpinecone-quickstart","---\nname: pinecone-quickstart\ndescription: Interactive Pinecone quickstart for new developers. Choose between two paths - Database (create an integrated index, upsert data, and query using Pinecone MCP + Python) or Assistant (create a Pinecone Assistant for document Q&A). Use when a user wants to get started with Pinecone for the first time or wants a guided tour of Pinecone's tools.\n---\n\n# Pinecone Quickstart\n\nWelcome! This skill walks you through your first Pinecone experience using the tools available to you. In this quickstart,\nyou will learn how to do a simple form of semantic search over some example data.\n\n## Prerequisites\n\nBefore starting either path, verify the API key works by calling `list-indexes` via the Pinecone MCP. If it succeeds, proceed. If it fails, ask the user to set their key:\n\n- Terminal: `export PINECONE_API_KEY=\"your-key\"`\n- Or create a `.env` file in the project root: `PINECONE_API_KEY=your-key`\n\nThen retry `list-indexes` to confirm.\n\n## Step 0: Choose Your Path\n\nAsk the user which path they want:\n\n- **Database** – Build a vector search index. Best for developers who want to store and search embeddings. Uses the Pinecone MCP + a Python upsert script.\n- **Assistant** – Build a document Q&A assistant. Best for users who want to upload files and ask questions with cited answers. No code required.\n\n---\n\n## Path A: Database Quickstart\n\nFor each step, explain to the user what will happen. An overview is here:\n\n1. Check if MCP is set\n2. Create an integrated index with MCP\n3. Upsert sample data using the bundled script (9 sentences across productivity, health, and nature themes)\n4. Run a semantic search query and explore further queries\n5. Optionally try reranking\n6. Offer the complete standalone script\n\n### Step 1 – Verify MCP is Available\n\nThe prerequisite check already called `list-indexes`. If it succeeded, the MCP is working — proceed to Step 2.\n\nIf it failed because MCP tools were unavailable (not an auth error):\n- Tell the user the MCP server needs to be configured\n- Point them to: https:\u002F\u002Fdocs.pinecone.io\u002Freference\u002Ftools\u002Fmcp\n\n### Step 2 – Create an Integrated Index\n\nUse the MCP `create-index-for-model` tool to create a serverless index with integrated embeddings:\n\n```\nname: quickstart-skills\ncloud: aws\nregion: us-east-1\nembed:\n  model: llama-text-embed-v2\n  fieldMap:\n    text: chunk_text\n```\n\n**Explain to the user what's happening:**\n- An *integrated index* uses a built-in Pinecone embedding model (`llama-text-embed-v2`)\n- This means you send plain text and Pinecone handles the embedding automatically\n- The `field_map` tells Pinecone which field in your records contains the text to embed\n\nWait for the index to become ready before proceeding. Waiting a few seconds is sufficient.\n\n### Step 3 – Upsert Sample Data\n\nRun the bundled upsert script to seed the index with sample records.\n\nIf `PINECONE_API_KEY` is set in the environment:\n```bash\nuv run scripts\u002Fupsert.py --index quickstart-skills\n```\n\nIf using a `.env` file:\n```bash\nuv run --env-file .env scripts\u002Fupsert.py --index quickstart-skills\n```\n\n**Explain to the user what's happening:**\n- The script uploads 9 sample records across three themes: **productivity** (getting work done), **health** (feeling unwell), and **nature** (outdoors\u002Fwildlife)\n- The dataset is intentionally varied so semantic search can show its value — the queries below use completely different words than the records, but the right ones still surface\n- Each record has an `_id`, a `chunk_text` field (the text that gets embedded), and a `category` field\n- This is the same structure you'd use for your own data — just replace the records\n\n### Step 4 – Query with the MCP\n\nUse the MCP `search-records` tool to run the first semantic search:\n\n```\nindex: quickstart-skills\nnamespace: example-namespace\nquery:\n  topK: 3\n  inputs:\n    text: \"getting things done efficiently\"\n```\n\nDisplay the results in a clean table: ID, score, and `chunk_text`.\n\n**Explain to the user what's happening:**\n- Notice the query shares no keywords with the records — but it surfaces the productivity sentences\n- That's semantic search: it finds meaning, not just matching words\n- You sent plain text — Pinecone embedded the query using the same model as the index\n\n**Offer to explore further:** Ask the user if they'd like to try another query to see the effect more clearly:\n- Option A: `\"feeling under the weather\"` — should surface the health records\n- Option B: `\"wildlife spotting outside\"` — should surface the nature records\n- Option C: No thanks, move on\n\nRun whichever query they choose and display the results the same way. If they want to try both, do both. After each result, point out which theme surfaced and why.\n\nIf they decline or are done exploring, proceed to Step 5 or offer to skip ahead to the complete script.\n\n### Step 5 – Try Reranking (Optional)\n\nAsk the user if they want to try reranking.\n\nIf yes, use `search-records` again with reranking enabled:\n\n```\nrerank:\n  model: bge-reranker-v2-m3\n  rankFields: [chunk_text]\n  topN: 3\n```\n\n**Explain**: Reranking runs a second-pass model over the results to improve relevance ordering.\n\n### Step 6 – Wrap Up\n\nCongratulate the user on completing the quickstart. Ask if they'd like a standalone Python script that does everything in one go — create index, upsert, query, and rerank.\n\nIf yes, copy it to their working directory:\n\n```bash\ncp scripts\u002Fquickstart_complete.py .\u002Fpinecone_quickstart.py\n```\n\nTell the user:\n- The script is at `.\u002Fpinecone_quickstart.py`\n- Run it with: `uv run pinecone_quickstart.py`\n- It uses `uv` inline dependencies — no separate install needed\n- They can swap in their own `records` list to build something real\n\n---\n\n## Path B: Assistant Quickstart\n\nGuide the user through the Pinecone Assistant workflow using the existing assistant skills:\n\n### Step 1 – Check for Documents\n\nBefore anything else, ask the user if they have files to upload. Pinecone Assistant accepts `.pdf`, `.md`, `.txt`, and `.docx` files — a single file or a folder of files both work.\n\n**If they have files:** ask for the path and proceed to Step 2.\n\n**If they don't have files:** offer two options:\n- **Generate sample docs** — create a few short markdown files in `.\u002Fsample-docs\u002F` so they can complete the quickstart right now. Ask what topics they'd like (or default to: a product FAQ, a short how-to guide, and a brief company overview). Write 3 files, each 150–250 words.\n- **Come back later** — let them know they can return once they have documents and pick up from Step 2.\n\n### Step 2 – Create an Assistant\n\nInvoke `pinecone-assistant` or run (add `--env-file .env` if using a `.env` file):\n```bash\nuv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fcreate.py --name my-assistant\n```\n\nExplain: The assistant is a fully managed RAG service — upload documents, ask questions, get cited answers.\n\n### Step 3 – Upload Documents\n\nInvoke `pinecone-assistant` or run (add `--env-file .env` if using a `.env` file):\n```bash\nuv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fupload.py --assistant my-assistant --source .\u002Fyour-docs\n```\n\nExplain: Pinecone handles chunking, embedding, and indexing automatically — no configuration needed.\n\n### Step 4 – Chat with the Assistant\n\nInvoke `pinecone-assistant` or run (add `--env-file .env` if using a `.env` file):\n```bash\nuv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fchat.py --assistant my-assistant --message \"What are the main topics in these documents?\"\n```\n\nExplain: Responses include citations with source file and page number.\n\n### Next Steps for Assistant\n\n- Invoke `pinecone-assistant` to keep the assistant up to date as documents change\n- Use the assistant skill to retrieve raw context snippets for custom workflows\n- Every assistant is also an MCP server — see https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fassistant\u002Fmcp-server\n\n---\n\n## Troubleshooting\n\n**`PINECONE_API_KEY` not set**\n\nTerminal environments:\n```bash\nexport PINECONE_API_KEY=\"your-key\"\n```\nIDEs that don't inherit shell variables: create a `.env` file in the project root:\n```\nPINECONE_API_KEY=your-key\n```\nThen use `uv run --env-file .env` when running scripts. Restart your IDE\u002Fagent session after setting.\n\n**MCP tools not available**\n- Verify the Pinecone MCP server is configured in your IDE's MCP settings\n- Check that `PINECONE_API_KEY` is set before the MCP server starts\n\n**Index already exists**\n- The upsert script is safe to re-run — it will upsert over existing records\n- Or delete and recreate: use `pc index delete -n quickstart-skills` via the CLI\n\n**`uv` not installed**\nSee the [uv installation guide](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F).\n\n## Further Reading\n\n- Quickstart docs: https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fget-started\u002Fquickstart\n- Integrated indexes: https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Findex-data\u002Fcreate-an-index\n- Python SDK: https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fget-started\u002Fpython-sdk\n- MCP server: https:\u002F\u002Fdocs.pinecone.io\u002Freference\u002Ftools\u002Fmcp\n",{"data":41,"body":42},{"name":4,"description":6},{"type":43,"children":44},"root",[45,53,59,66,80,115,127,133,138,161,165,171,176,210,217,229,234,255,261,274,286,294,336,341,347,352,365,407,419,459,466,534,540,552,561,573,580,598,608,642,647,652,658,663,675,684,694,700,705,710,735,740,790,793,799,804,810,846,856,866,897,903,931,964,969,975,997,1040,1045,1051,1073,1125,1130,1136,1166,1169,1175,1188,1193,1234,1246,1255,1268,1276,1296,1304,1325,1348,1354,1400],{"type":46,"tag":47,"props":48,"children":49},"element","h1",{"id":4},[50],{"type":51,"value":52},"text","Pinecone Quickstart",{"type":46,"tag":54,"props":55,"children":56},"p",{},[57],{"type":51,"value":58},"Welcome! This skill walks you through your first Pinecone experience using the tools available to you. In this quickstart,\nyou will learn how to do a simple form of semantic search over some example data.",{"type":46,"tag":60,"props":61,"children":63},"h2",{"id":62},"prerequisites",[64],{"type":51,"value":65},"Prerequisites",{"type":46,"tag":54,"props":67,"children":68},{},[69,71,78],{"type":51,"value":70},"Before starting either path, verify the API key works by calling ",{"type":46,"tag":72,"props":73,"children":75},"code",{"className":74},[],[76],{"type":51,"value":77},"list-indexes",{"type":51,"value":79}," via the Pinecone MCP. If it succeeds, proceed. If it fails, ask the user to set their key:",{"type":46,"tag":81,"props":82,"children":83},"ul",{},[84,96],{"type":46,"tag":85,"props":86,"children":87},"li",{},[88,90],{"type":51,"value":89},"Terminal: ",{"type":46,"tag":72,"props":91,"children":93},{"className":92},[],[94],{"type":51,"value":95},"export PINECONE_API_KEY=\"your-key\"",{"type":46,"tag":85,"props":97,"children":98},{},[99,101,107,109],{"type":51,"value":100},"Or create a ",{"type":46,"tag":72,"props":102,"children":104},{"className":103},[],[105],{"type":51,"value":106},".env",{"type":51,"value":108}," file in the project root: ",{"type":46,"tag":72,"props":110,"children":112},{"className":111},[],[113],{"type":51,"value":114},"PINECONE_API_KEY=your-key",{"type":46,"tag":54,"props":116,"children":117},{},[118,120,125],{"type":51,"value":119},"Then retry ",{"type":46,"tag":72,"props":121,"children":123},{"className":122},[],[124],{"type":51,"value":77},{"type":51,"value":126}," to confirm.",{"type":46,"tag":60,"props":128,"children":130},{"id":129},"step-0-choose-your-path",[131],{"type":51,"value":132},"Step 0: Choose Your Path",{"type":46,"tag":54,"props":134,"children":135},{},[136],{"type":51,"value":137},"Ask the user which path they want:",{"type":46,"tag":81,"props":139,"children":140},{},[141,151],{"type":46,"tag":85,"props":142,"children":143},{},[144,149],{"type":46,"tag":145,"props":146,"children":147},"strong",{},[148],{"type":51,"value":18},{"type":51,"value":150}," – Build a vector search index. Best for developers who want to store and search embeddings. Uses the Pinecone MCP + a Python upsert script.",{"type":46,"tag":85,"props":152,"children":153},{},[154,159],{"type":46,"tag":145,"props":155,"children":156},{},[157],{"type":51,"value":158},"Assistant",{"type":51,"value":160}," – Build a document Q&A assistant. Best for users who want to upload files and ask questions with cited answers. No code required.",{"type":46,"tag":162,"props":163,"children":164},"hr",{},[],{"type":46,"tag":60,"props":166,"children":168},{"id":167},"path-a-database-quickstart",[169],{"type":51,"value":170},"Path A: Database Quickstart",{"type":46,"tag":54,"props":172,"children":173},{},[174],{"type":51,"value":175},"For each step, explain to the user what will happen. An overview is here:",{"type":46,"tag":177,"props":178,"children":179},"ol",{},[180,185,190,195,200,205],{"type":46,"tag":85,"props":181,"children":182},{},[183],{"type":51,"value":184},"Check if MCP is set",{"type":46,"tag":85,"props":186,"children":187},{},[188],{"type":51,"value":189},"Create an integrated index with MCP",{"type":46,"tag":85,"props":191,"children":192},{},[193],{"type":51,"value":194},"Upsert sample data using the bundled script (9 sentences across productivity, health, and nature themes)",{"type":46,"tag":85,"props":196,"children":197},{},[198],{"type":51,"value":199},"Run a semantic search query and explore further queries",{"type":46,"tag":85,"props":201,"children":202},{},[203],{"type":51,"value":204},"Optionally try reranking",{"type":46,"tag":85,"props":206,"children":207},{},[208],{"type":51,"value":209},"Offer the complete standalone script",{"type":46,"tag":211,"props":212,"children":214},"h3",{"id":213},"step-1-verify-mcp-is-available",[215],{"type":51,"value":216},"Step 1 – Verify MCP is Available",{"type":46,"tag":54,"props":218,"children":219},{},[220,222,227],{"type":51,"value":221},"The prerequisite check already called ",{"type":46,"tag":72,"props":223,"children":225},{"className":224},[],[226],{"type":51,"value":77},{"type":51,"value":228},". If it succeeded, the MCP is working — proceed to Step 2.",{"type":46,"tag":54,"props":230,"children":231},{},[232],{"type":51,"value":233},"If it failed because MCP tools were unavailable (not an auth error):",{"type":46,"tag":81,"props":235,"children":236},{},[237,242],{"type":46,"tag":85,"props":238,"children":239},{},[240],{"type":51,"value":241},"Tell the user the MCP server needs to be configured",{"type":46,"tag":85,"props":243,"children":244},{},[245,247],{"type":51,"value":246},"Point them to: ",{"type":46,"tag":248,"props":249,"children":253},"a",{"href":250,"rel":251},"https:\u002F\u002Fdocs.pinecone.io\u002Freference\u002Ftools\u002Fmcp",[252],"nofollow",[254],{"type":51,"value":250},{"type":46,"tag":211,"props":256,"children":258},{"id":257},"step-2-create-an-integrated-index",[259],{"type":51,"value":260},"Step 2 – Create an Integrated Index",{"type":46,"tag":54,"props":262,"children":263},{},[264,266,272],{"type":51,"value":265},"Use the MCP ",{"type":46,"tag":72,"props":267,"children":269},{"className":268},[],[270],{"type":51,"value":271},"create-index-for-model",{"type":51,"value":273}," tool to create a serverless index with integrated embeddings:",{"type":46,"tag":275,"props":276,"children":280},"pre",{"className":277,"code":279,"language":51},[278],"language-text","name: quickstart-skills\ncloud: aws\nregion: us-east-1\nembed:\n  model: llama-text-embed-v2\n  fieldMap:\n    text: chunk_text\n",[281],{"type":46,"tag":72,"props":282,"children":284},{"__ignoreMap":283},"",[285],{"type":51,"value":279},{"type":46,"tag":54,"props":287,"children":288},{},[289],{"type":46,"tag":145,"props":290,"children":291},{},[292],{"type":51,"value":293},"Explain to the user what's happening:",{"type":46,"tag":81,"props":295,"children":296},{},[297,318,323],{"type":46,"tag":85,"props":298,"children":299},{},[300,302,308,310,316],{"type":51,"value":301},"An ",{"type":46,"tag":303,"props":304,"children":305},"em",{},[306],{"type":51,"value":307},"integrated index",{"type":51,"value":309}," uses a built-in Pinecone embedding model (",{"type":46,"tag":72,"props":311,"children":313},{"className":312},[],[314],{"type":51,"value":315},"llama-text-embed-v2",{"type":51,"value":317},")",{"type":46,"tag":85,"props":319,"children":320},{},[321],{"type":51,"value":322},"This means you send plain text and Pinecone handles the embedding automatically",{"type":46,"tag":85,"props":324,"children":325},{},[326,328,334],{"type":51,"value":327},"The ",{"type":46,"tag":72,"props":329,"children":331},{"className":330},[],[332],{"type":51,"value":333},"field_map",{"type":51,"value":335}," tells Pinecone which field in your records contains the text to embed",{"type":46,"tag":54,"props":337,"children":338},{},[339],{"type":51,"value":340},"Wait for the index to become ready before proceeding. Waiting a few seconds is sufficient.",{"type":46,"tag":211,"props":342,"children":344},{"id":343},"step-3-upsert-sample-data",[345],{"type":51,"value":346},"Step 3 – Upsert Sample Data",{"type":46,"tag":54,"props":348,"children":349},{},[350],{"type":51,"value":351},"Run the bundled upsert script to seed the index with sample records.",{"type":46,"tag":54,"props":353,"children":354},{},[355,357,363],{"type":51,"value":356},"If ",{"type":46,"tag":72,"props":358,"children":360},{"className":359},[],[361],{"type":51,"value":362},"PINECONE_API_KEY",{"type":51,"value":364}," is set in the environment:",{"type":46,"tag":275,"props":366,"children":370},{"className":367,"code":368,"language":369,"meta":283,"style":283},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","uv run scripts\u002Fupsert.py --index quickstart-skills\n","bash",[371],{"type":46,"tag":72,"props":372,"children":373},{"__ignoreMap":283},[374],{"type":46,"tag":375,"props":376,"children":379},"span",{"class":377,"line":378},"line",1,[380,386,392,397,402],{"type":46,"tag":375,"props":381,"children":383},{"style":382},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[384],{"type":51,"value":385},"uv",{"type":46,"tag":375,"props":387,"children":389},{"style":388},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[390],{"type":51,"value":391}," run",{"type":46,"tag":375,"props":393,"children":394},{"style":388},[395],{"type":51,"value":396}," scripts\u002Fupsert.py",{"type":46,"tag":375,"props":398,"children":399},{"style":388},[400],{"type":51,"value":401}," --index",{"type":46,"tag":375,"props":403,"children":404},{"style":388},[405],{"type":51,"value":406}," quickstart-skills\n",{"type":46,"tag":54,"props":408,"children":409},{},[410,412,417],{"type":51,"value":411},"If using a ",{"type":46,"tag":72,"props":413,"children":415},{"className":414},[],[416],{"type":51,"value":106},{"type":51,"value":418}," file:",{"type":46,"tag":275,"props":420,"children":422},{"className":367,"code":421,"language":369,"meta":283,"style":283},"uv run --env-file .env scripts\u002Fupsert.py --index quickstart-skills\n",[423],{"type":46,"tag":72,"props":424,"children":425},{"__ignoreMap":283},[426],{"type":46,"tag":375,"props":427,"children":428},{"class":377,"line":378},[429,433,437,442,447,451,455],{"type":46,"tag":375,"props":430,"children":431},{"style":382},[432],{"type":51,"value":385},{"type":46,"tag":375,"props":434,"children":435},{"style":388},[436],{"type":51,"value":391},{"type":46,"tag":375,"props":438,"children":439},{"style":388},[440],{"type":51,"value":441}," --env-file",{"type":46,"tag":375,"props":443,"children":444},{"style":388},[445],{"type":51,"value":446}," .env",{"type":46,"tag":375,"props":448,"children":449},{"style":388},[450],{"type":51,"value":396},{"type":46,"tag":375,"props":452,"children":453},{"style":388},[454],{"type":51,"value":401},{"type":46,"tag":375,"props":456,"children":457},{"style":388},[458],{"type":51,"value":406},{"type":46,"tag":54,"props":460,"children":461},{},[462],{"type":46,"tag":145,"props":463,"children":464},{},[465],{"type":51,"value":293},{"type":46,"tag":81,"props":467,"children":468},{},[469,495,500,529],{"type":46,"tag":85,"props":470,"children":471},{},[472,474,479,481,486,488,493],{"type":51,"value":473},"The script uploads 9 sample records across three themes: ",{"type":46,"tag":145,"props":475,"children":476},{},[477],{"type":51,"value":478},"productivity",{"type":51,"value":480}," (getting work done), ",{"type":46,"tag":145,"props":482,"children":483},{},[484],{"type":51,"value":485},"health",{"type":51,"value":487}," (feeling unwell), and ",{"type":46,"tag":145,"props":489,"children":490},{},[491],{"type":51,"value":492},"nature",{"type":51,"value":494}," (outdoors\u002Fwildlife)",{"type":46,"tag":85,"props":496,"children":497},{},[498],{"type":51,"value":499},"The dataset is intentionally varied so semantic search can show its value — the queries below use completely different words than the records, but the right ones still surface",{"type":46,"tag":85,"props":501,"children":502},{},[503,505,511,513,519,521,527],{"type":51,"value":504},"Each record has an ",{"type":46,"tag":72,"props":506,"children":508},{"className":507},[],[509],{"type":51,"value":510},"_id",{"type":51,"value":512},", a ",{"type":46,"tag":72,"props":514,"children":516},{"className":515},[],[517],{"type":51,"value":518},"chunk_text",{"type":51,"value":520}," field (the text that gets embedded), and a ",{"type":46,"tag":72,"props":522,"children":524},{"className":523},[],[525],{"type":51,"value":526},"category",{"type":51,"value":528}," field",{"type":46,"tag":85,"props":530,"children":531},{},[532],{"type":51,"value":533},"This is the same structure you'd use for your own data — just replace the records",{"type":46,"tag":211,"props":535,"children":537},{"id":536},"step-4-query-with-the-mcp",[538],{"type":51,"value":539},"Step 4 – Query with the MCP",{"type":46,"tag":54,"props":541,"children":542},{},[543,544,550],{"type":51,"value":265},{"type":46,"tag":72,"props":545,"children":547},{"className":546},[],[548],{"type":51,"value":549},"search-records",{"type":51,"value":551}," tool to run the first semantic search:",{"type":46,"tag":275,"props":553,"children":556},{"className":554,"code":555,"language":51},[278],"index: quickstart-skills\nnamespace: example-namespace\nquery:\n  topK: 3\n  inputs:\n    text: \"getting things done efficiently\"\n",[557],{"type":46,"tag":72,"props":558,"children":559},{"__ignoreMap":283},[560],{"type":51,"value":555},{"type":46,"tag":54,"props":562,"children":563},{},[564,566,571],{"type":51,"value":565},"Display the results in a clean table: ID, score, and ",{"type":46,"tag":72,"props":567,"children":569},{"className":568},[],[570],{"type":51,"value":518},{"type":51,"value":572},".",{"type":46,"tag":54,"props":574,"children":575},{},[576],{"type":46,"tag":145,"props":577,"children":578},{},[579],{"type":51,"value":293},{"type":46,"tag":81,"props":581,"children":582},{},[583,588,593],{"type":46,"tag":85,"props":584,"children":585},{},[586],{"type":51,"value":587},"Notice the query shares no keywords with the records — but it surfaces the productivity sentences",{"type":46,"tag":85,"props":589,"children":590},{},[591],{"type":51,"value":592},"That's semantic search: it finds meaning, not just matching words",{"type":46,"tag":85,"props":594,"children":595},{},[596],{"type":51,"value":597},"You sent plain text — Pinecone embedded the query using the same model as the index",{"type":46,"tag":54,"props":599,"children":600},{},[601,606],{"type":46,"tag":145,"props":602,"children":603},{},[604],{"type":51,"value":605},"Offer to explore further:",{"type":51,"value":607}," Ask the user if they'd like to try another query to see the effect more clearly:",{"type":46,"tag":81,"props":609,"children":610},{},[611,624,637],{"type":46,"tag":85,"props":612,"children":613},{},[614,616,622],{"type":51,"value":615},"Option A: ",{"type":46,"tag":72,"props":617,"children":619},{"className":618},[],[620],{"type":51,"value":621},"\"feeling under the weather\"",{"type":51,"value":623}," — should surface the health records",{"type":46,"tag":85,"props":625,"children":626},{},[627,629,635],{"type":51,"value":628},"Option B: ",{"type":46,"tag":72,"props":630,"children":632},{"className":631},[],[633],{"type":51,"value":634},"\"wildlife spotting outside\"",{"type":51,"value":636}," — should surface the nature records",{"type":46,"tag":85,"props":638,"children":639},{},[640],{"type":51,"value":641},"Option C: No thanks, move on",{"type":46,"tag":54,"props":643,"children":644},{},[645],{"type":51,"value":646},"Run whichever query they choose and display the results the same way. If they want to try both, do both. After each result, point out which theme surfaced and why.",{"type":46,"tag":54,"props":648,"children":649},{},[650],{"type":51,"value":651},"If they decline or are done exploring, proceed to Step 5 or offer to skip ahead to the complete script.",{"type":46,"tag":211,"props":653,"children":655},{"id":654},"step-5-try-reranking-optional",[656],{"type":51,"value":657},"Step 5 – Try Reranking (Optional)",{"type":46,"tag":54,"props":659,"children":660},{},[661],{"type":51,"value":662},"Ask the user if they want to try reranking.",{"type":46,"tag":54,"props":664,"children":665},{},[666,668,673],{"type":51,"value":667},"If yes, use ",{"type":46,"tag":72,"props":669,"children":671},{"className":670},[],[672],{"type":51,"value":549},{"type":51,"value":674}," again with reranking enabled:",{"type":46,"tag":275,"props":676,"children":679},{"className":677,"code":678,"language":51},[278],"rerank:\n  model: bge-reranker-v2-m3\n  rankFields: [chunk_text]\n  topN: 3\n",[680],{"type":46,"tag":72,"props":681,"children":682},{"__ignoreMap":283},[683],{"type":51,"value":678},{"type":46,"tag":54,"props":685,"children":686},{},[687,692],{"type":46,"tag":145,"props":688,"children":689},{},[690],{"type":51,"value":691},"Explain",{"type":51,"value":693},": Reranking runs a second-pass model over the results to improve relevance ordering.",{"type":46,"tag":211,"props":695,"children":697},{"id":696},"step-6-wrap-up",[698],{"type":51,"value":699},"Step 6 – Wrap Up",{"type":46,"tag":54,"props":701,"children":702},{},[703],{"type":51,"value":704},"Congratulate the user on completing the quickstart. Ask if they'd like a standalone Python script that does everything in one go — create index, upsert, query, and rerank.",{"type":46,"tag":54,"props":706,"children":707},{},[708],{"type":51,"value":709},"If yes, copy it to their working directory:",{"type":46,"tag":275,"props":711,"children":713},{"className":367,"code":712,"language":369,"meta":283,"style":283},"cp scripts\u002Fquickstart_complete.py .\u002Fpinecone_quickstart.py\n",[714],{"type":46,"tag":72,"props":715,"children":716},{"__ignoreMap":283},[717],{"type":46,"tag":375,"props":718,"children":719},{"class":377,"line":378},[720,725,730],{"type":46,"tag":375,"props":721,"children":722},{"style":382},[723],{"type":51,"value":724},"cp",{"type":46,"tag":375,"props":726,"children":727},{"style":388},[728],{"type":51,"value":729}," scripts\u002Fquickstart_complete.py",{"type":46,"tag":375,"props":731,"children":732},{"style":388},[733],{"type":51,"value":734}," .\u002Fpinecone_quickstart.py\n",{"type":46,"tag":54,"props":736,"children":737},{},[738],{"type":51,"value":739},"Tell the user:",{"type":46,"tag":81,"props":741,"children":742},{},[743,754,765,777],{"type":46,"tag":85,"props":744,"children":745},{},[746,748],{"type":51,"value":747},"The script is at ",{"type":46,"tag":72,"props":749,"children":751},{"className":750},[],[752],{"type":51,"value":753},".\u002Fpinecone_quickstart.py",{"type":46,"tag":85,"props":755,"children":756},{},[757,759],{"type":51,"value":758},"Run it with: ",{"type":46,"tag":72,"props":760,"children":762},{"className":761},[],[763],{"type":51,"value":764},"uv run pinecone_quickstart.py",{"type":46,"tag":85,"props":766,"children":767},{},[768,770,775],{"type":51,"value":769},"It uses ",{"type":46,"tag":72,"props":771,"children":773},{"className":772},[],[774],{"type":51,"value":385},{"type":51,"value":776}," inline dependencies — no separate install needed",{"type":46,"tag":85,"props":778,"children":779},{},[780,782,788],{"type":51,"value":781},"They can swap in their own ",{"type":46,"tag":72,"props":783,"children":785},{"className":784},[],[786],{"type":51,"value":787},"records",{"type":51,"value":789}," list to build something real",{"type":46,"tag":162,"props":791,"children":792},{},[],{"type":46,"tag":60,"props":794,"children":796},{"id":795},"path-b-assistant-quickstart",[797],{"type":51,"value":798},"Path B: Assistant Quickstart",{"type":46,"tag":54,"props":800,"children":801},{},[802],{"type":51,"value":803},"Guide the user through the Pinecone Assistant workflow using the existing assistant skills:",{"type":46,"tag":211,"props":805,"children":807},{"id":806},"step-1-check-for-documents",[808],{"type":51,"value":809},"Step 1 – Check for Documents",{"type":46,"tag":54,"props":811,"children":812},{},[813,815,821,823,829,830,836,838,844],{"type":51,"value":814},"Before anything else, ask the user if they have files to upload. Pinecone Assistant accepts ",{"type":46,"tag":72,"props":816,"children":818},{"className":817},[],[819],{"type":51,"value":820},".pdf",{"type":51,"value":822},", ",{"type":46,"tag":72,"props":824,"children":826},{"className":825},[],[827],{"type":51,"value":828},".md",{"type":51,"value":822},{"type":46,"tag":72,"props":831,"children":833},{"className":832},[],[834],{"type":51,"value":835},".txt",{"type":51,"value":837},", and ",{"type":46,"tag":72,"props":839,"children":841},{"className":840},[],[842],{"type":51,"value":843},".docx",{"type":51,"value":845}," files — a single file or a folder of files both work.",{"type":46,"tag":54,"props":847,"children":848},{},[849,854],{"type":46,"tag":145,"props":850,"children":851},{},[852],{"type":51,"value":853},"If they have files:",{"type":51,"value":855}," ask for the path and proceed to Step 2.",{"type":46,"tag":54,"props":857,"children":858},{},[859,864],{"type":46,"tag":145,"props":860,"children":861},{},[862],{"type":51,"value":863},"If they don't have files:",{"type":51,"value":865}," offer two options:",{"type":46,"tag":81,"props":867,"children":868},{},[869,887],{"type":46,"tag":85,"props":870,"children":871},{},[872,877,879,885],{"type":46,"tag":145,"props":873,"children":874},{},[875],{"type":51,"value":876},"Generate sample docs",{"type":51,"value":878}," — create a few short markdown files in ",{"type":46,"tag":72,"props":880,"children":882},{"className":881},[],[883],{"type":51,"value":884},".\u002Fsample-docs\u002F",{"type":51,"value":886}," so they can complete the quickstart right now. Ask what topics they'd like (or default to: a product FAQ, a short how-to guide, and a brief company overview). Write 3 files, each 150–250 words.",{"type":46,"tag":85,"props":888,"children":889},{},[890,895],{"type":46,"tag":145,"props":891,"children":892},{},[893],{"type":51,"value":894},"Come back later",{"type":51,"value":896}," — let them know they can return once they have documents and pick up from Step 2.",{"type":46,"tag":211,"props":898,"children":900},{"id":899},"step-2-create-an-assistant",[901],{"type":51,"value":902},"Step 2 – Create an Assistant",{"type":46,"tag":54,"props":904,"children":905},{},[906,908,914,916,922,924,929],{"type":51,"value":907},"Invoke ",{"type":46,"tag":72,"props":909,"children":911},{"className":910},[],[912],{"type":51,"value":913},"pinecone-assistant",{"type":51,"value":915}," or run (add ",{"type":46,"tag":72,"props":917,"children":919},{"className":918},[],[920],{"type":51,"value":921},"--env-file .env",{"type":51,"value":923}," if using a ",{"type":46,"tag":72,"props":925,"children":927},{"className":926},[],[928],{"type":51,"value":106},{"type":51,"value":930}," file):",{"type":46,"tag":275,"props":932,"children":934},{"className":367,"code":933,"language":369,"meta":283,"style":283},"uv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fcreate.py --name my-assistant\n",[935],{"type":46,"tag":72,"props":936,"children":937},{"__ignoreMap":283},[938],{"type":46,"tag":375,"props":939,"children":940},{"class":377,"line":378},[941,945,949,954,959],{"type":46,"tag":375,"props":942,"children":943},{"style":382},[944],{"type":51,"value":385},{"type":46,"tag":375,"props":946,"children":947},{"style":388},[948],{"type":51,"value":391},{"type":46,"tag":375,"props":950,"children":951},{"style":388},[952],{"type":51,"value":953}," ..\u002Fpinecone-assistant\u002Fscripts\u002Fcreate.py",{"type":46,"tag":375,"props":955,"children":956},{"style":388},[957],{"type":51,"value":958}," --name",{"type":46,"tag":375,"props":960,"children":961},{"style":388},[962],{"type":51,"value":963}," my-assistant\n",{"type":46,"tag":54,"props":965,"children":966},{},[967],{"type":51,"value":968},"Explain: The assistant is a fully managed RAG service — upload documents, ask questions, get cited answers.",{"type":46,"tag":211,"props":970,"children":972},{"id":971},"step-3-upload-documents",[973],{"type":51,"value":974},"Step 3 – Upload Documents",{"type":46,"tag":54,"props":976,"children":977},{},[978,979,984,985,990,991,996],{"type":51,"value":907},{"type":46,"tag":72,"props":980,"children":982},{"className":981},[],[983],{"type":51,"value":913},{"type":51,"value":915},{"type":46,"tag":72,"props":986,"children":988},{"className":987},[],[989],{"type":51,"value":921},{"type":51,"value":923},{"type":46,"tag":72,"props":992,"children":994},{"className":993},[],[995],{"type":51,"value":106},{"type":51,"value":930},{"type":46,"tag":275,"props":998,"children":1000},{"className":367,"code":999,"language":369,"meta":283,"style":283},"uv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fupload.py --assistant my-assistant --source .\u002Fyour-docs\n",[1001],{"type":46,"tag":72,"props":1002,"children":1003},{"__ignoreMap":283},[1004],{"type":46,"tag":375,"props":1005,"children":1006},{"class":377,"line":378},[1007,1011,1015,1020,1025,1030,1035],{"type":46,"tag":375,"props":1008,"children":1009},{"style":382},[1010],{"type":51,"value":385},{"type":46,"tag":375,"props":1012,"children":1013},{"style":388},[1014],{"type":51,"value":391},{"type":46,"tag":375,"props":1016,"children":1017},{"style":388},[1018],{"type":51,"value":1019}," ..\u002Fpinecone-assistant\u002Fscripts\u002Fupload.py",{"type":46,"tag":375,"props":1021,"children":1022},{"style":388},[1023],{"type":51,"value":1024}," --assistant",{"type":46,"tag":375,"props":1026,"children":1027},{"style":388},[1028],{"type":51,"value":1029}," my-assistant",{"type":46,"tag":375,"props":1031,"children":1032},{"style":388},[1033],{"type":51,"value":1034}," --source",{"type":46,"tag":375,"props":1036,"children":1037},{"style":388},[1038],{"type":51,"value":1039}," .\u002Fyour-docs\n",{"type":46,"tag":54,"props":1041,"children":1042},{},[1043],{"type":51,"value":1044},"Explain: Pinecone handles chunking, embedding, and indexing automatically — no configuration needed.",{"type":46,"tag":211,"props":1046,"children":1048},{"id":1047},"step-4-chat-with-the-assistant",[1049],{"type":51,"value":1050},"Step 4 – Chat with the Assistant",{"type":46,"tag":54,"props":1052,"children":1053},{},[1054,1055,1060,1061,1066,1067,1072],{"type":51,"value":907},{"type":46,"tag":72,"props":1056,"children":1058},{"className":1057},[],[1059],{"type":51,"value":913},{"type":51,"value":915},{"type":46,"tag":72,"props":1062,"children":1064},{"className":1063},[],[1065],{"type":51,"value":921},{"type":51,"value":923},{"type":46,"tag":72,"props":1068,"children":1070},{"className":1069},[],[1071],{"type":51,"value":106},{"type":51,"value":930},{"type":46,"tag":275,"props":1074,"children":1076},{"className":367,"code":1075,"language":369,"meta":283,"style":283},"uv run ..\u002Fpinecone-assistant\u002Fscripts\u002Fchat.py --assistant my-assistant --message \"What are the main topics in these documents?\"\n",[1077],{"type":46,"tag":72,"props":1078,"children":1079},{"__ignoreMap":283},[1080],{"type":46,"tag":375,"props":1081,"children":1082},{"class":377,"line":378},[1083,1087,1091,1096,1100,1104,1109,1115,1120],{"type":46,"tag":375,"props":1084,"children":1085},{"style":382},[1086],{"type":51,"value":385},{"type":46,"tag":375,"props":1088,"children":1089},{"style":388},[1090],{"type":51,"value":391},{"type":46,"tag":375,"props":1092,"children":1093},{"style":388},[1094],{"type":51,"value":1095}," ..\u002Fpinecone-assistant\u002Fscripts\u002Fchat.py",{"type":46,"tag":375,"props":1097,"children":1098},{"style":388},[1099],{"type":51,"value":1024},{"type":46,"tag":375,"props":1101,"children":1102},{"style":388},[1103],{"type":51,"value":1029},{"type":46,"tag":375,"props":1105,"children":1106},{"style":388},[1107],{"type":51,"value":1108}," --message",{"type":46,"tag":375,"props":1110,"children":1112},{"style":1111},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1113],{"type":51,"value":1114}," \"",{"type":46,"tag":375,"props":1116,"children":1117},{"style":388},[1118],{"type":51,"value":1119},"What are the main topics in these documents?",{"type":46,"tag":375,"props":1121,"children":1122},{"style":1111},[1123],{"type":51,"value":1124},"\"\n",{"type":46,"tag":54,"props":1126,"children":1127},{},[1128],{"type":51,"value":1129},"Explain: Responses include citations with source file and page number.",{"type":46,"tag":211,"props":1131,"children":1133},{"id":1132},"next-steps-for-assistant",[1134],{"type":51,"value":1135},"Next Steps for Assistant",{"type":46,"tag":81,"props":1137,"children":1138},{},[1139,1150,1155],{"type":46,"tag":85,"props":1140,"children":1141},{},[1142,1143,1148],{"type":51,"value":907},{"type":46,"tag":72,"props":1144,"children":1146},{"className":1145},[],[1147],{"type":51,"value":913},{"type":51,"value":1149}," to keep the assistant up to date as documents change",{"type":46,"tag":85,"props":1151,"children":1152},{},[1153],{"type":51,"value":1154},"Use the assistant skill to retrieve raw context snippets for custom workflows",{"type":46,"tag":85,"props":1156,"children":1157},{},[1158,1160],{"type":51,"value":1159},"Every assistant is also an MCP server — see ",{"type":46,"tag":248,"props":1161,"children":1164},{"href":1162,"rel":1163},"https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fassistant\u002Fmcp-server",[252],[1165],{"type":51,"value":1162},{"type":46,"tag":162,"props":1167,"children":1168},{},[],{"type":46,"tag":60,"props":1170,"children":1172},{"id":1171},"troubleshooting",[1173],{"type":51,"value":1174},"Troubleshooting",{"type":46,"tag":54,"props":1176,"children":1177},{},[1178],{"type":46,"tag":145,"props":1179,"children":1180},{},[1181,1186],{"type":46,"tag":72,"props":1182,"children":1184},{"className":1183},[],[1185],{"type":51,"value":362},{"type":51,"value":1187}," not set",{"type":46,"tag":54,"props":1189,"children":1190},{},[1191],{"type":51,"value":1192},"Terminal environments:",{"type":46,"tag":275,"props":1194,"children":1196},{"className":367,"code":1195,"language":369,"meta":283,"style":283},"export PINECONE_API_KEY=\"your-key\"\n",[1197],{"type":46,"tag":72,"props":1198,"children":1199},{"__ignoreMap":283},[1200],{"type":46,"tag":375,"props":1201,"children":1202},{"class":377,"line":378},[1203,1209,1215,1220,1225,1230],{"type":46,"tag":375,"props":1204,"children":1206},{"style":1205},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1207],{"type":51,"value":1208},"export",{"type":46,"tag":375,"props":1210,"children":1212},{"style":1211},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1213],{"type":51,"value":1214}," PINECONE_API_KEY",{"type":46,"tag":375,"props":1216,"children":1217},{"style":1111},[1218],{"type":51,"value":1219},"=",{"type":46,"tag":375,"props":1221,"children":1222},{"style":1111},[1223],{"type":51,"value":1224},"\"",{"type":46,"tag":375,"props":1226,"children":1227},{"style":388},[1228],{"type":51,"value":1229},"your-key",{"type":46,"tag":375,"props":1231,"children":1232},{"style":1111},[1233],{"type":51,"value":1124},{"type":46,"tag":54,"props":1235,"children":1236},{},[1237,1239,1244],{"type":51,"value":1238},"IDEs that don't inherit shell variables: create a ",{"type":46,"tag":72,"props":1240,"children":1242},{"className":1241},[],[1243],{"type":51,"value":106},{"type":51,"value":1245}," file in the project root:",{"type":46,"tag":275,"props":1247,"children":1250},{"className":1248,"code":1249,"language":51},[278],"PINECONE_API_KEY=your-key\n",[1251],{"type":46,"tag":72,"props":1252,"children":1253},{"__ignoreMap":283},[1254],{"type":51,"value":1249},{"type":46,"tag":54,"props":1256,"children":1257},{},[1258,1260,1266],{"type":51,"value":1259},"Then use ",{"type":46,"tag":72,"props":1261,"children":1263},{"className":1262},[],[1264],{"type":51,"value":1265},"uv run --env-file .env",{"type":51,"value":1267}," when running scripts. Restart your IDE\u002Fagent session after setting.",{"type":46,"tag":54,"props":1269,"children":1270},{},[1271],{"type":46,"tag":145,"props":1272,"children":1273},{},[1274],{"type":51,"value":1275},"MCP tools not available",{"type":46,"tag":81,"props":1277,"children":1278},{},[1279,1284],{"type":46,"tag":85,"props":1280,"children":1281},{},[1282],{"type":51,"value":1283},"Verify the Pinecone MCP server is configured in your IDE's MCP settings",{"type":46,"tag":85,"props":1285,"children":1286},{},[1287,1289,1294],{"type":51,"value":1288},"Check that ",{"type":46,"tag":72,"props":1290,"children":1292},{"className":1291},[],[1293],{"type":51,"value":362},{"type":51,"value":1295}," is set before the MCP server starts",{"type":46,"tag":54,"props":1297,"children":1298},{},[1299],{"type":46,"tag":145,"props":1300,"children":1301},{},[1302],{"type":51,"value":1303},"Index already exists",{"type":46,"tag":81,"props":1305,"children":1306},{},[1307,1312],{"type":46,"tag":85,"props":1308,"children":1309},{},[1310],{"type":51,"value":1311},"The upsert script is safe to re-run — it will upsert over existing records",{"type":46,"tag":85,"props":1313,"children":1314},{},[1315,1317,1323],{"type":51,"value":1316},"Or delete and recreate: use ",{"type":46,"tag":72,"props":1318,"children":1320},{"className":1319},[],[1321],{"type":51,"value":1322},"pc index delete -n quickstart-skills",{"type":51,"value":1324}," via the CLI",{"type":46,"tag":54,"props":1326,"children":1327},{},[1328,1338,1340,1347],{"type":46,"tag":145,"props":1329,"children":1330},{},[1331,1336],{"type":46,"tag":72,"props":1332,"children":1334},{"className":1333},[],[1335],{"type":51,"value":385},{"type":51,"value":1337}," not installed",{"type":51,"value":1339},"\nSee the ",{"type":46,"tag":248,"props":1341,"children":1344},{"href":1342,"rel":1343},"https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F",[252],[1345],{"type":51,"value":1346},"uv installation guide",{"type":51,"value":572},{"type":46,"tag":60,"props":1349,"children":1351},{"id":1350},"further-reading",[1352],{"type":51,"value":1353},"Further Reading",{"type":46,"tag":81,"props":1355,"children":1356},{},[1357,1368,1379,1390],{"type":46,"tag":85,"props":1358,"children":1359},{},[1360,1362],{"type":51,"value":1361},"Quickstart docs: ",{"type":46,"tag":248,"props":1363,"children":1366},{"href":1364,"rel":1365},"https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fget-started\u002Fquickstart",[252],[1367],{"type":51,"value":1364},{"type":46,"tag":85,"props":1369,"children":1370},{},[1371,1373],{"type":51,"value":1372},"Integrated indexes: ",{"type":46,"tag":248,"props":1374,"children":1377},{"href":1375,"rel":1376},"https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Findex-data\u002Fcreate-an-index",[252],[1378],{"type":51,"value":1375},{"type":46,"tag":85,"props":1380,"children":1381},{},[1382,1384],{"type":51,"value":1383},"Python SDK: ",{"type":46,"tag":248,"props":1385,"children":1388},{"href":1386,"rel":1387},"https:\u002F\u002Fdocs.pinecone.io\u002Fguides\u002Fget-started\u002Fpython-sdk",[252],[1389],{"type":51,"value":1386},{"type":46,"tag":85,"props":1391,"children":1392},{},[1393,1395],{"type":51,"value":1394},"MCP server: ",{"type":46,"tag":248,"props":1396,"children":1398},{"href":250,"rel":1397},[252],[1399],{"type":51,"value":250},{"type":46,"tag":1401,"props":1402,"children":1403},"style",{},[1404],{"type":51,"value":1405},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1407,"total":1556},[1408,1428,1441,1457,1468,1479,1491,1508,1520,1530,1540,1548],{"slug":1409,"name":1410,"fn":1411,"description":1412,"org":1413,"tags":1414,"stars":1425,"repoUrl":1426,"updatedAt":1427},"pineconeassistant","pinecone:assistant","manage Pinecone Assistants for document Q&A","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\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1415,1418,1421,1422],{"name":1416,"slug":1417,"type":16},"Knowledge Management","knowledge-management",{"name":1419,"slug":1420,"type":16},"LLM","llm",{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"Search","search",67,"https:\u002F\u002Fgithub.com\u002Fpinecone-io\u002Fpinecone-claude-code-plugin","2026-07-13T06:02:15.573985",{"slug":1429,"name":1430,"fn":1431,"description":1432,"org":1433,"tags":1434,"stars":1425,"repoUrl":1426,"updatedAt":1440},"pineconecli","pinecone:cli","manage Pinecone resources via CLI","Guide for using the Pinecone CLI (pc) to manage Pinecone resources from the terminal. The CLI supports ALL index types (standard, integrated, sparse) and all vector operations — unlike the MCP which only supports integrated indexes. Use for batch operations, vector management, backups, namespaces, CI\u002FCD automation, and full control over Pinecone resources.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1435,1438,1439],{"name":1436,"slug":1437,"type":16},"CLI","cli",{"name":18,"slug":19,"type":16},{"name":9,"slug":8,"type":16},"2026-07-13T06:02:07.032383",{"slug":1442,"name":1443,"fn":1444,"description":1445,"org":1446,"tags":1447,"stars":1425,"repoUrl":1426,"updatedAt":1456},"pineconedocs","pinecone:docs","search Pinecone developer documentation","Curated documentation reference for developers building with Pinecone. Contains links to official docs organized by topic and data format references. Use when writing Pinecone code, looking up API parameters, or needing the correct format for vectors or records.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1448,1451,1452,1455],{"name":1449,"slug":1450,"type":16},"Documentation","documentation",{"name":9,"slug":8,"type":16},{"name":1453,"slug":1454,"type":16},"Reference","reference",{"name":1423,"slug":1424,"type":16},"2026-07-13T06:02:12.996533",{"slug":1458,"name":1459,"fn":1460,"description":1461,"org":1462,"tags":1463,"stars":1425,"repoUrl":1426,"updatedAt":1467},"pineconefull-text-search","pinecone:full-text-search","build and query Pinecone full-text search indexes","Create, ingest into, and query a Pinecone full-text-search (FTS) index using the preview API (2026-01.alpha, public preview). Use when the user or agent asks to build a text search index on Pinecone, add dense or sparse vector fields, ingest documents, construct score_by clauses (text \u002F query_string \u002F dense_vector \u002F sparse_vector), or compose with text-match filters ($match_phrase \u002F $match_all \u002F $match_any). Ships `scripts\u002Fingest.py` for safe bulk ingestion (batch_upsert + error inspection + readiness polling); query construction is documented inline in this skill — write `documents.search(...)` calls directly, validated against `pc.preview.indexes.describe(...)` output.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1464,1465,1466],{"name":18,"slug":19,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"2026-07-13T06:02:18.270055",{"slug":1469,"name":1470,"fn":1471,"description":1472,"org":1473,"tags":1474,"stars":1425,"repoUrl":1426,"updatedAt":1478},"pineconehelp","pinecone:help","provide Pinecone skill guidance","Overview of all available Pinecone skills and what a user needs to get started. Invoke when a user asks what skills are available, how to get started with Pinecone, or what they need to set up before using any Pinecone skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1475,1476,1477],{"name":1449,"slug":1450,"type":16},{"name":9,"slug":8,"type":16},{"name":1453,"slug":1454,"type":16},"2026-07-13T06:02:11.702305",{"slug":1480,"name":1481,"fn":1482,"description":1483,"org":1484,"tags":1485,"stars":1425,"repoUrl":1426,"updatedAt":1490},"pineconemcp","pinecone:mcp","use Pinecone MCP server tools","Reference for the Pinecone MCP server tools. Documents all available tools - list-indexes, describe-index, describe-index-stats, create-index-for-model, upsert-records, search-records, cascading-search, and rerank-documents. Use when an agent needs to understand what Pinecone MCP tools are available, how to use them, or what parameters they accept.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1486,1487,1488,1489],{"name":18,"slug":19,"type":16},{"name":21,"slug":22,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"2026-07-16T05:59:21.318686",{"slug":1492,"name":1493,"fn":1494,"description":1495,"org":1496,"tags":1497,"stars":1425,"repoUrl":1426,"updatedAt":1507},"pineconen8n","pinecone:n8n","build RAG workflows with Pinecone and n8n","Build n8n workflows using the Pinecone Assistant node or Pinecone Vector Store node. Use when building RAG pipelines, chat-with-docs workflows, configuring Pinecone nodes in n8n, troubleshooting Pinecone n8n nodes, or asking about best practices for Pinecone in n8n.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1498,1500,1501,1504],{"name":1499,"slug":1499,"type":16},"n8n",{"name":9,"slug":8,"type":16},{"name":1502,"slug":1503,"type":16},"RAG","rag",{"name":1505,"slug":1506,"type":16},"Workflow Automation","workflow-automation","2026-07-13T06:02:05.735702",{"slug":1509,"name":1510,"fn":1511,"description":1512,"org":1513,"tags":1514,"stars":1425,"repoUrl":1426,"updatedAt":1519},"pineconequery","pinecone:query","query Pinecone integrated indexes with text","Query integrated indexes using text with Pinecone MCP. IMPORTANT - This skill ONLY works with integrated indexes (indexes with built-in Pinecone embedding models like multilingual-e5-large). For standard indexes or advanced vector operations, use the CLI skill instead. Requires PINECONE_API_KEY environment variable and Pinecone MCP server to be configured.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1515,1516,1517,1518],{"name":18,"slug":19,"type":16},{"name":21,"slug":22,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"2026-07-13T06:02:14.255922",{"slug":1521,"name":1522,"fn":5,"description":6,"org":1523,"tags":1524,"stars":1425,"repoUrl":1426,"updatedAt":1529},"pineconequickstart","pinecone:quickstart",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1525,1526,1527,1528],{"name":18,"slug":19,"type":16},{"name":21,"slug":22,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-07-13T06:02:16.886569",{"slug":913,"name":913,"fn":1411,"description":1412,"org":1531,"tags":1532,"stars":24,"repoUrl":25,"updatedAt":1539},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1533,1536,1537,1538],{"name":1534,"slug":1535,"type":16},"Documents","documents",{"name":1419,"slug":1420,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"2026-07-13T06:02:40.044479",{"slug":1541,"name":1541,"fn":1431,"description":1432,"org":1542,"tags":1543,"stars":24,"repoUrl":25,"updatedAt":1547},"pinecone-cli",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1544,1545,1546],{"name":1436,"slug":1437,"type":16},{"name":18,"slug":19,"type":16},{"name":9,"slug":8,"type":16},"2026-07-13T06:02:31.804044",{"slug":1549,"name":1549,"fn":1444,"description":1445,"org":1550,"tags":1551,"stars":24,"repoUrl":25,"updatedAt":1555},"pinecone-docs",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1552,1553,1554],{"name":1449,"slug":1450,"type":16},{"name":9,"slug":8,"type":16},{"name":1453,"slug":1454,"type":16},"2026-07-13T06:02:35.982565",18,{"items":1558,"total":1613},[1559,1566,1572,1578,1586,1595,1604],{"slug":913,"name":913,"fn":1411,"description":1412,"org":1560,"tags":1561,"stars":24,"repoUrl":25,"updatedAt":1539},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1562,1563,1564,1565],{"name":1534,"slug":1535,"type":16},{"name":1419,"slug":1420,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},{"slug":1541,"name":1541,"fn":1431,"description":1432,"org":1567,"tags":1568,"stars":24,"repoUrl":25,"updatedAt":1547},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1569,1570,1571],{"name":1436,"slug":1437,"type":16},{"name":18,"slug":19,"type":16},{"name":9,"slug":8,"type":16},{"slug":1549,"name":1549,"fn":1444,"description":1445,"org":1573,"tags":1574,"stars":24,"repoUrl":25,"updatedAt":1555},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1575,1576,1577],{"name":1449,"slug":1450,"type":16},{"name":9,"slug":8,"type":16},{"name":1453,"slug":1454,"type":16},{"slug":1579,"name":1579,"fn":1460,"description":1461,"org":1580,"tags":1581,"stars":24,"repoUrl":25,"updatedAt":1585},"pinecone-full-text-search",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1582,1583,1584],{"name":18,"slug":19,"type":16},{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"2026-07-13T06:02:43.249808",{"slug":1587,"name":1587,"fn":1588,"description":1472,"org":1589,"tags":1590,"stars":24,"repoUrl":25,"updatedAt":1594},"pinecone-help","get started with Pinecone agent skills",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1591,1592,1593],{"name":1449,"slug":1450,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-07-13T06:02:37.342095",{"slug":1596,"name":1596,"fn":1597,"description":1483,"org":1598,"tags":1599,"stars":24,"repoUrl":25,"updatedAt":1603},"pinecone-mcp","reference Pinecone MCP server tools",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1600,1601,1602],{"name":1449,"slug":1450,"type":16},{"name":21,"slug":22,"type":16},{"name":9,"slug":8,"type":16},"2026-07-13T06:02:33.158312",{"slug":1605,"name":1605,"fn":1494,"description":1495,"org":1606,"tags":1607,"stars":24,"repoUrl":25,"updatedAt":1612},"pinecone-n8n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1608,1609,1610,1611],{"name":1499,"slug":1499,"type":16},{"name":9,"slug":8,"type":16},{"name":1502,"slug":1503,"type":16},{"name":1505,"slug":1506,"type":16},"2026-07-13T06:02:34.599969",9]