For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

You can edit a knowledge base’s name, project, tags, or reranking settings, or destroy it.

The following knowledge base details are view-only:

• Embeddings model shows the model in use and the token rate for indexing events.
• Associated agents lists any agents attached using the knowledge base. You can attach or detach any agent as needed.
• OpenSearch DB show the databases in use and its region. To manage databases, see the OpenSearch documentation.

Edit a Knowledge Base Using the Control Panel

To edit a knowledge base, go to the DigitalOcean Control Panel, in the left menu, click DATA SERVICES, and then click Knowledge Bases.

Then, find the knowledge base you want to edit, on the right of it, click …, and then click Manage Settings to open its Settings tab.

You can edit the following attributes:

• Knowledge base info, change the knowledge base name or select a different project.
• Tags, add or remove tags.
• Reranking, enable or disable reranking for the knowledge base.
• Destroy, destroy the knowledge base.

Click Edit on the right of the attribute you want to update, and then click Submit to apply your changes.

Edit Reranking

Reranking can improve retrieval quality by moving the most relevant chunks higher in the results after the initial search. This is most helpful for ambiguous queries, larger data sets, and content where many chunks use similar language. Because reranking adds an extra processing step, it also increases latency and incurs separate token charges.

Enable Reranking

You can either enable reranking when you first create your knowledge base or enable it later in the Settings tab of your knowledge base.

To enable reranking for your knowledge base from the Settings tab, in the Reranking model section, on the right, click Enable, click the Model dropdown menu to select a reranking model, and then click Enable reranking.

Once enabled, reranking charges apply to all future retrievals made against that knowledge base, because each retrieval request uses the configured reranking step until reranking is disabled.

Disable Reranking

Disabling reranking stops re-scoring retrieved results and affects all future retrieval requests for that knowledge base immediately. It doesn’t change your indexed data, previously generated responses, or past retrieval results. You might disable reranking to compare baseline retrieval results, reduce cost, lower latency, or troubleshoot whether reranking is improving relevance for a specific query.

To disable reranking for your knowledge base, in the Reranking model section, on the right, click Edit, and then click Disable reranking to open the Disable reranking model window.

To confirm disabling the reranking model, click Disable reranking.

After disabling reranking, test retrieval results again and compare outputs with and without reranking enabled to confirm whether it improves relevance for your use case.

Edit a Knowledge Base via the API

To edit a knowledge base via the DigitalOcean API, provide the knowledge base UUID and any attributes you want to update, such as the name, project ID, tags, or reranking configuration.

You can update the following optional fields:

• name: The knowledge base name.

• project_id: The ID of the DigitalOcean project the knowledge base belongs to.

• tags: Tags to organize the knowledge base.

• reranking_config: A configuration object for reranking during retrieval.

  • enabled: Whether reranking is enabled.
  • model: The reranking model to use.

To update a knowledge base, send a PUT request to the /v2/gen-ai/knowledge_bases/{uuid} endpoint.

curl -X PUT \
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/gen-ai/knowledge_bases/e51dba65-cf7a-11ef-bf8f-4e013e2ddde4" \
  -d '{
    "uuid": "e51dba65-cf7a-11ef-bf8f-4e013e2ddde4",
    "name": "kb-api-rename",
    "reranking_config": {
      "enabled": true,
      "model": "bge-reranker-v2-m3"
    }
  }'

After updating a knowledge base, you can view the knowledge base to confirm the changes or list all knowledge bases to review your other resources.