Skip to content
  • Auto
  • Light
  • Dark

Retrieve

Retrieve Information About an Existing Knowledge Base
knowledge_bases.retrieve(struuid) -> database_statusliteralknowledge_baseAPIKnowledgeBaseKnowledgeBaseRetrieveResponse
get/v2/gen-ai/knowledge_bases/{uuid}

To retrive information about an existing knowledge base, send a GET request to /v2/gen-ai/knowledge_bases/{uuid}.

Parameters
uuidstr
Returns
KnowledgeBaseRetrieveResponseclass

The knowledge base

Hide ParametersShow Parameters
database_statusliteral
optional
Optional[Literal["CREATING", "ONLINE", "POWEROFF", 9 more]]
Hide ParametersShow Parameters
"CREATING"
"ONLINE"
"POWEROFF"
"REBUILDING"
"REBALANCING"
"DECOMMISSIONED"
"FORKING"
"MIGRATING"
"RESIZING"
"RESTORING"
"POWERING_ON"
"UNHEALTHY"
knowledge_baseAPIKnowledgeBase
optional

Knowledgebase Description

from do_gradientai import GradientAI

client = GradientAI()
knowledge_base = client.knowledge_bases.retrieve(
    "uuid",
)
print(knowledge_base.database_status)
200 Example
{
  "database_status": "CREATING",
  "knowledge_base": {
    "added_to_agent_at": "2023-01-01T00:00:00Z",
    "created_at": "2023-01-01T00:00:00Z",
    "database_id": "\"123e4567-e89b-12d3-a456-426614174000\"",
    "embedding_model_uuid": "\"123e4567-e89b-12d3-a456-426614174000\"",
    "is_public": true,
    "last_indexing_job": {
      "completed_datasources": 123,
      "created_at": "2023-01-01T00:00:00Z",
      "data_source_uuids": [
        "example string"
      ],
      "finished_at": "2023-01-01T00:00:00Z",
      "knowledge_base_uuid": "\"123e4567-e89b-12d3-a456-426614174000\"",
      "phase": "BATCH_JOB_PHASE_UNKNOWN",
      "started_at": "2023-01-01T00:00:00Z",
      "status": "INDEX_JOB_STATUS_UNKNOWN",
      "tokens": 123,
      "total_datasources": 123,
      "updated_at": "2023-01-01T00:00:00Z",
      "uuid": "\"123e4567-e89b-12d3-a456-426614174000\""
    },
    "name": "\"example name\"",
    "project_id": "\"123e4567-e89b-12d3-a456-426614174000\"",
    "region": "\"example string\"",
    "tags": [
      "example string"
    ],
    "updated_at": "2023-01-01T00:00:00Z",
    "user_id": "user_id",
    "uuid": "\"123e4567-e89b-12d3-a456-426614174000\""
  }
}