# Pinecone Docs: Pinecone Assistant

> Official Pinecone documentation for the vector database, Assistant, inference APIs, SDKs, and building production search and AI applications.

## Pinecone Assistant

- [Pinecone Assistant / Reference (92 pages)](https://docs.pinecone.io/_llms/pinecone-assistant/reference.md): Documentation for Pinecone Assistant / Reference.

### Guides

#### Get started

- [Pinecone Assistant](https://docs.pinecone.io/guides/assistant/overview.md): Overview of Pinecone Assistant, a managed service for building production-grade RAG chat and agent applications grounded in your data.
- [Pricing and limits](https://docs.pinecone.io/guides/assistant/pricing-and-limits.md): Understand Pinecone Assistant pricing for ingestion units, chat tokens, and storage, plus plan-based service limits for file uploads and knowledge size.

##### Quickstart

- [Pinecone Assistant: SDK quickstart](https://docs.pinecone.io/guides/assistant/quickstart/sdk-quickstart.md): Quickstart for Pinecone Assistant using the Python or Node.js SDK to create an assistant, upload documents, and chat with your data via RAG.
- [Pinecone Assistant: n8n quickstart](https://docs.pinecone.io/guides/assistant/quickstart/n8n-quickstart.md): Build an n8n workflow with Pinecone Assistant and OpenAI to download files via HTTP, upload documents, and chat with them from an automation.

#### Build an assistant

- [Create an assistant](https://docs.pinecone.io/guides/assistant/create-assistant.md): Create a Pinecone Assistant with custom instructions, metadata, and region settings using the API, Python SDK, Node.js SDK, or console.
- [Manage assistants](https://docs.pinecone.io/guides/assistant/manage-assistants.md): List, describe, update, and delete Pinecone assistants and check assistant status using the API, Python SDK, Node.js SDK, or Pinecone console.

#### Upload your data

- [Files in Pinecone Assistant](https://docs.pinecone.io/guides/assistant/files-overview.md): Overview of Pinecone Assistant files: supported file types (PDF, DOCX, JSON, MD, TXT), metadata filters, storage, and signed URL access.
- [Upload files](https://docs.pinecone.io/guides/assistant/upload-files.md): Upload local files to a Pinecone assistant with Python, JavaScript, or curl, track ingestion operations, and see how uploads are billed as ingestion units.
- [Multimodal context for assistants](https://docs.pinecone.io/guides/assistant/multimodal.md): Enable multimodal PDF context in Pinecone Assistant to analyze charts, images, and diagrams using OCR and visual understanding for RAG.
- [Manage files](https://docs.pinecone.io/guides/assistant/manage-files.md): List files in your Pinecone assistant, check individual file ingestion status by ID, view metadata, and delete files using the API, SDKs, or console.

#### Chat with an assistant

- [Chat through the standard interface](https://docs.pinecone.io/guides/assistant/chat-with-assistant.md): Chat with Pinecone Assistant through the standard interface with default, streaming, or JSON responses, plus citations and chat history support.
- [Chat through the OpenAI-compatible interface](https://docs.pinecone.io/guides/assistant/chat-through-the-openai-compatible-interface.md): Chat with Pinecone Assistant using the OpenAI-compatible Chat Completion API for inline citations, streaming responses, and easy integration.

#### Evaluate answers

- [Evaluation overview](https://docs.pinecone.io/guides/assistant/evaluation-overview.md): Overview of Pinecone Assistant response evaluation: measure correctness, completeness, and alignment scores to benchmark RAG system quality.
- [Evaluate answers](https://docs.pinecone.io/guides/assistant/evaluate-answers.md): Evaluate RAG system answers with Pinecone Assistant using correctness, completeness, and alignment metrics against a ground truth answer.

#### Retrieve context snippets

- [Context snippets overview](https://docs.pinecone.io/guides/assistant/context-snippets-overview.md): Learn how Pinecone Assistant retrieves context snippets with relevancy scores and references for RAG applications and agentic workflows.
- [Retrieve context snippets](https://docs.pinecone.io/guides/assistant/retrieve-context-snippets.md): Retrieve context snippets and citations from a Pinecone Assistant to power your own LLM, RAG application, or agentic workflow with signed URLs.

#### Integrate with AI agents

- [Use an Assistant MCP server](https://docs.pinecone.io/guides/assistant/mcp-server.md): Connect AI agents to a Pinecone Assistant MCP server via remote or local Model Context Protocol endpoints, including Cursor and Claude Desktop.

#### Admin

##### Manage billing

- [Upgrade your plan](https://docs.pinecone.io/guides/assistant/admin/upgrade-billing-plan.md): Learn how Pinecone Assistant admins upgrade to a paid plan to unlock higher limits, more files, evaluations, and advanced access controls.
- [Change your payment method](https://docs.pinecone.io/guides/assistant/admin/change-payment-method.md): Update the credit card or payment method on file for your Pinecone organization to keep billing details current and avoid failed charges.
- [Downgrade your plan](https://docs.pinecone.io/guides/assistant/admin/downgrade-billing-plan.md): Downgrade your Pinecone subscription from a paid tier back to the free Starter plan, including steps to review usage limits before switching.
- [Download a usage report](https://docs.pinecone.io/guides/assistant/admin/download-usage-report.md): Export a detailed Pinecone usage and cost report for your organization to analyze index consumption, credits, and monthly billing charges.
- [Access your invoices](https://docs.pinecone.io/guides/assistant/admin/access-your-invoices.md): View, download, and manage your Pinecone billing invoices from the console, including past invoice history, payment status, and PDF exports.

##### Manage security

- [Security overview](https://docs.pinecone.io/guides/assistant/admin/security-overview.md): Overview of Pinecone Assistant admin security features including API keys, single sign-on, service accounts, and audit logs across your organization.
- [Manage roles and access](https://docs.pinecone.io/guides/assistant/admin/manage-rbac.md): Assign organization and project roles to users, service accounts, and API keys in Pinecone Assistant, with common role combinations for each scenario.
- [Configure SSO with Okta](https://docs.pinecone.io/guides/assistant/admin/configure-sso-with-okta.md): Integrate Okta with Pinecone to enable single sign-on, configure SAML settings, and manage secure user authentication for your organization.
- [Configure audit logs](https://docs.pinecone.io/guides/assistant/admin/configure-audit-logs.md): Set up Pinecone audit logs streamed to an Amazon S3 bucket to track user, service account, and API actions across the control plane.

##### Manage organizations

- [Organizations overview](https://docs.pinecone.io/guides/assistant/admin/organizations-overview.md): Learn how Pinecone organizations group projects under shared billing, and how organization owners, members, and roles control access and permissions.
- [Monitor usage and cost](https://docs.pinecone.io/guides/assistant/admin/monitor-spend-and-usage.md): Monitor Pinecone Assistant usage and cost, set monthly spend alerts, and track token usage across chat, context retrieval, and evaluation.
- [Manage organization members](https://docs.pinecone.io/guides/assistant/admin/manage-organization-members.md): Invite new members to your Pinecone organization, change their organization roles, and remove users to control access across all projects.
- [Manage organization-level service accounts](https://docs.pinecone.io/guides/assistant/admin/manage-organization-service-accounts.md): Create and manage organization-level Pinecone service accounts, retrieve access tokens, and grant programmatic access to the Admin API.

##### Manage projects

- [Projects overview](https://docs.pinecone.io/guides/assistant/admin/projects-overview.md): Understand how Pinecone projects contain assistants, indexes, and users, and review project owner and project user roles and their permissions.
- [Create a project](https://docs.pinecone.io/guides/assistant/admin/create-a-project.md): Create a new Pinecone project in the console or through the Admin API, add tags, and optionally enable a customer-managed encryption key (CMEK).
- [Manage projects](https://docs.pinecone.io/guides/assistant/admin/manage-projects.md): View project details, rename projects, add project tags, and delete Pinecone projects using the console or the Admin API with an access token.
- [Manage project members](https://docs.pinecone.io/guides/assistant/admin/manage-project-members.md): Add users to a Pinecone project, assign project owner or user roles, edit permissions, and remove members to control access to indexes and API keys.
- [Manage API keys](https://docs.pinecone.io/guides/assistant/admin/manage-api-keys.md): Create, view, update, and delete Pinecone API keys for a project, plus assign custom permission roles to control data plane and control plane access.
- [Manage service accounts at the project-level](https://docs.pinecone.io/guides/assistant/admin/manage-project-service-accounts.md): Add and manage project-level service accounts in Pinecone Assistant to enable programmatic Admin API access, roles, and permissions.

### Examples

- [Assistant examples](https://docs.pinecone.io/examples/assistant.md): Notebooks and Next.js sample apps for Pinecone Assistant: quickstart, context snippet retrieval, and a full-stack chat UI with citations.

## OpenAPI Specs

- [assistant_control_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_control_2026-04.oas.yaml)
- [assistant_data_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_data_2026-04.oas.yaml)
- [assistant_evaluation_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_evaluation_2026-04.oas.yaml)
- [admin_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml)
- [oauth_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/oauth_2026-04.oas.yaml)
- [assistant_control_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_control_2025-10.oas.yaml)
- [assistant_data_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_data_2025-10.oas.yaml)
- [assistant_evaluation_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_evaluation_2025-10.oas.yaml)
- [admin_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/admin_2025-10.oas.yaml)
- [oauth_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/oauth_2025-10.oas.yaml)
- [assistant_control_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_control_2025-04.oas.yaml)
- [assistant_data_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_data_2025-04.oas.yaml)
- [assistant_evaluation_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_evaluation_2025-04.oas.yaml)
- [admin_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/admin_2025-04.oas.yaml)
- [oauth_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/oauth_2025-04.oas.yaml)
- [assistant_control_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_control_2025-01.oas.yaml)
- [assistant_data_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_data_2025-01.oas.yaml)
- [assistant_evaluation_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_evaluation_2025-01.oas.yaml)