• UPDATED
  • REMOVED
  • SYNCED
  • MANUAL

How to upsert and delete vector documents with your AI

Connect OpenSearch Vector once to give your AI direct control over your vector database. You can then manage specific embeddings through natural language.

Ask AI about this page

Short answer

How do I update or remove specific vectors?

You tell your AI to update a document by its ID or delete it entirely. The AI uses the provided tools to modify the OpenSearch index without you needing to write manual API calls. This keeps your vector data fresh and accurate.

Where every change lands.

Outcomes of your requests

Your AI handles the heavy lifting in OpenSearch, resulting in these specific states.

UPDATED

Fresh embeddings

The AI replaces an old vector with new data. Your search results stay relevant to your latest information.

REMOVED

Cleaned index

The AI wipes out specific vectors. This prevents outdated or incorrect data from appearing in your searches.

SYNCED

Data parity

Your vector store matches your source data. The AI ensures the index reflects the current state of your documents.

MANUAL

Human oversight

You decide which IDs to target. The AI won't guess which documents are obsolete; it only acts on the specific IDs you confirm.

The workflow

What your AI does when a request arrives.

The AI translates your intent into specific OpenSearch operations.

  1. Identify the target

    Your AI looks at your request to find the specific document ID you want to change or remove.

    index_documentdelete_document

  2. Update the vector

    If you want to refresh data, the AI pushes the new embedding to the index.

    index_document

  3. Remove the vector

    If the data is no longer needed, the AI targets the ID for deletion.

    delete_document

  4. Confirm the change

    The AI verifies the operation was successful and tells you the index is updated.

    index_documentdelete_document

Try it

Copy these to start.

Use these prompts to trigger actions in OpenSearch.

Starting points

Replace the bracketed text with your actual OpenSearch document IDs or index names.

OpenSearch Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_6R4dQ885yexHhsyH4M5e8fLiT1BjuMlzaUlJMumQ/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OpenSearch capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "opensearch-vector-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_6R4dQ885yexHhsyH4M5e8fLiT1BjuMlzaUlJMumQ/mcp"
    }
  }
}
Copy into chat04

  • Update the vector for document ID [ID_HERE] with this new content.

  • Delete the embedding for document [ID_HERE] from the index.

  • I have a new version of the document with ID [ID_HERE], please upsert it.

  • Remove the outdated vector associated with ID [ID_HERE].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect OpenSearch Vector once, then ask.

Just link your OpenSearch instance. Your credentials stay encrypted, and you can immediately start managing vectors through your chat interface.

Connect OpenSearch Vector to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete my entire index?

    No. The AI can only delete specific documents using the delete_document tool. It cannot drop or wipe an entire index.

  • 02

    Does the AI create new vectors from scratch?

    The AI uses the index_document tool to add or update embeddings, but it relies on the data you provide in the prompt.

  • 03

    Can I undo a deletion?

    No. Once the AI executes a delete_document command, that vector is gone from OpenSearch. You would need to re-index it.

  • 04

    Will the AI change my index settings?

    No. This connector is strictly for managing document embeddings, not for altering index configurations or mappings.

  • 05

    How does the AI know which ID to delete?

    You must specify the document ID in your prompt so the AI knows exactly which record to target.

  • More questions about OpenSearch Vector? The Connector page answers them. See everything the OpenSearch Vector Connector can do

Connect OpenSearch to Claude, Cursor, ChatGPT & more