doctl genai knowledge-base create
Generated on 20 Oct 2025
from doctl version
v1.146.0
Usage
doctl genai knowledge-base create [flags]Aliases
cDescription
Creates a knowledge base and returns the following information
- The Knowledge Base UUID
- The Knowledge Base Name
- The Knowledge Base Region
- The Knowledge Base Project ID
- The Knowledge Base Database ID
- The Knowledge Base Last Indexing Job
- The Knowledge Base Created At
- The Knowledge Base Updated At
- The Knowledge Base Added To Agent At
- The Knowledge Base Embedding Model UUID
- The Knowledge Base Tags
- The Knowledge Base Is Public
- The Knowledge Base User ID
For more information about datasources, see the datasources reference
Example
The following example creates Knowledge Base with the parameters
doctl genai knowledge-base create --name example-kb --region tor1 --project-id 84e1e297-0000-0000-0000-1067cf2206e9 --embedding-model-uuid 22653204-79ed-11ef-bf8f-4e013e2ddde4 --data-sources '[{"web_crawler_data_source":{"base_url":"https://example.com/apps/","crawling_option":"UNKNOWN","embed_media": true}}]'Flags
| Option | Description |
|---|---|
--data-sources |
JSON array of data source objects. (required) |
--database-id |
The database ID of the Knowledge Base. |
--embedding-model-uuid |
The embedding model UUID of the Knowledge Base. (required) |
--format |
Columns for output in a comma-separated list. Possible values: AddedToAgentAt, CreatedAt, DatabaseId, IsPublic, EmbeddingModelUuid, LastIndexingJob, Name, Region, ProjectId, Tags, UpdatedAt, UserId, UUID. |
--help, -h |
Help for this command |
--name |
The name of the Knowledge Base. (required) |
--no-header |
Return raw data with no headers Default: false |
--project-id |
The project ID of the Knowledge Base. (required) |
--region |
The region of the Knowledge Base. (required) |
--tags |
The tags of the Knowledge Base. |
--vpc_uuid |
The VPC UUID of the Knowledge Base. |
Related Commands
| Command | Description |
|---|---|
| doctl genai knowledge-base | Display commands that manage DigitalOcean Agent Knowledge Bases. |
Global Flags
| Option | Description |
|---|---|
--access-token, -t |
API V2 access token |
--api-url, -u |
Override default API endpoint |
--config, -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output, -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose, -v |
Enable verbose output Default: false |