• ADDITION
  • REVISION
  • REMOVAL
  • HUMAN

How to update vector embeddings with your AI

Connect Vald to your AI client once. From there, your agent manages your vector database directly.

Ask AI about this page

Short answer

How can I update my Vald vectors using an AI agent?

Your agent uses the Vald MCP to insert, update, or delete vectors in your cluster. This keeps your RAG retrieval accurate as your source data changes. You'll see how the agent handles these updates below.

Data sync outcomes

Where your data lands.

These are the results of your agent's actions in Vald.

ADDITION

New vectors added

The agent pushes new embeddings into the cluster. Your RAG pipeline can now find this new information during retrieval.

REVISION

Existing vectors updated

The agent overwrites old embeddings with new ones. This prevents your agent from pulling outdated context.

REMOVAL

Stale vectors deleted

The agent removes specific vectors from the cluster. This keeps your search results relevant and clean.

HUMAN

Manual review required

You decide which data needs to change. The agent only modifies the specific vectors you point out.

The workflow

What your AI does when data changes.

The agent handles the heavy lifting of database management through direct tool calls.

  1. Adding data

    When you provide new information, the agent creates a new entry in your Vald cluster.

    insert_vector

  2. Modifying entries

    If a document changes, the agent replaces the old embedding with the updated version.

    update_vector

  3. Cleaning up

    The agent removes vectors that are no longer needed to keep the index efficient.

    delete_vector

  4. Maintaining sync

    The agent uses these tools to ensure your cluster stays aligned with your latest files.

    insert_vectorupdate_vectordelete_vector

Try it

Copy these to start.

Use these prompts to trigger vector changes in Vald.

Starting points

Swap out the bracketed text for your actual vector IDs or document names.

Vald Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_LwabvjFRxR6SLDMyq0Lg8wB1fanBWcNw0aRuqiDM/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 — Vald capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "vald-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_LwabvjFRxR6SLDMyq0Lg8wB1fanBWcNw0aRuqiDM/mcp"
    }
  }
}
Copy into chat04

  • Insert a new vector for the Q3 sales report in my Vald cluster.

  • Update the vector for user_id_556 with this new text.

  • Delete the vector for the deprecated product manual.

  • Add a new embedding for the updated employee handbook.

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

Start here

Connect Vald once, then ask.

Connect the MCP to your client in one step. Your credentials stay encrypted on our side, and you can start managing vectors immediately.

Connect Vald to your AI

FAQ

How this task behaves

  • 01

    Can the AI create a new Vald cluster?

    No. The agent can only manage vectors within a cluster you have already set up.

  • 02

    Does the AI delete my entire database?

    No. The agent only deletes specific vectors that you explicitly tell it to remove.

  • 03

    Can the AI perform a search in Vald?

    No. This specific set of tools is for managing the contents of the cluster, not for performing similarity searches.

  • 04

    Can I use this with Cursor?

    Yes. Any MCP-compatible client like Cursor or Claude can use this once connected.

  • 05

    Will the AI automatically update vectors when I edit a file?

    No. The agent only updates vectors when you give it a direct instruction to do so.

  • More questions about Vald? See everything the Vald Connector can do

Connect Vald to Claude, Cursor, ChatGPT & more