'1.0', 'info' => [ 'style' => 'ROA', 'product' => 'PAILangStudio', 'version' => '2024-07-10', ], 'directories' => [ 'CreateKnowledgeBase', 'GetKnowledgeBase', 'UpdateKnowledgeBase', 'DeleteKnowledgeBase', 'ListKnowledgeBases', 'RetrieveKnowledgeBase', 'CreateKnowledgeBaseJob', 'GetKnowledgeBaseJob', 'UpdateKnowledgeBaseJob', 'DeleteKnowledgeBaseJob', 'ListKnowledgeBaseJobs', 'UpdateKnowledgeBaseChunk', 'ListKnowledgeBaseChunks', ], 'components' => [ 'schemas' => [ 'KnowledgeBase' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '478***', 'backendName' => 'workspaceId', ], 'Accessibility' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'PRIVATE', 'backendName' => 'accessibility', ], 'GmtCreateTime' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2024-12-15T14:46:23Z', 'backendName' => 'gmtCreateTime', ], 'GmtModifiedTime' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2025-12-18T19:32:58Z', 'backendName' => 'gmtModifiedTime', ], 'Name' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'myName', 'backendName' => 'name', ], 'KnowledgeBaseId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'd-nacr******sxd2', 'backendName' => 'knowledgeBaseId', ], 'Description' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'This is a description of the knowledge base.', 'backendName' => 'description', ], 'KnowledgeBaseType' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'TEXT', 'backendName' => 'knowledgeBaseType', ], 'DatasetId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'd-lvb6****865w', 'backendName' => 'datasetId', ], 'DataSources' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Uri' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/', 'readOnly' => true, 'descriptionEn' => 'Uri', ], ], 'extendType' => 'true', ], 'backendName' => 'dataSources', 'itemName' => 'DataSources', ], 'OutputDir' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/output/', 'backendName' => 'outputDir', ], 'ChunkConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'ChunkSize' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1024', 'readOnly' => true, 'descriptionEn' => 'Chunk size', ], 'ChunkOverlap' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '200', 'readOnly' => true, 'descriptionEn' => 'Chunk overlap', ], 'ChunkDuration' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'readOnly' => true, 'descriptionEn' => 'Chunk duration', ], 'ChunkStrategy' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Default', 'readOnly' => true, 'descriptionEn' => 'Chunk strategy', 'default' => 'Default', ], ], 'backendName' => 'chunkConfig', ], 'EmbeddingConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'EmbeddingType' => [ 'title' => '', 'description' => '', 'visibility' => 'Private', 'type' => 'string', 'example' => 'DashScope', 'descriptionEn' => 'Embedding type', ], 'ConnectionName' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'myEmbeddingConn', 'descriptionEn' => 'Embedding connection name', ], 'ConnectionId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'conn-r3o7******38bh', 'descriptionEn' => 'Embedding connection id', ], 'Model' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'text-embedding-v4', 'descriptionEn' => 'Model', ], ], 'backendName' => 'embeddingConfig', ], 'VectorDBConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'VectorDBType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Milvus', 'descriptionEn' => 'VectorDB type', ], 'ConnectionName' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'myConnName', 'descriptionEn' => 'VectorDB connection name', ], 'ConnectionId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'conn-v2wq****z7rg', 'descriptionEn' => 'Embedding connection id', ], 'CollectionName' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'my_collection', 'descriptionEn' => 'Collectio name', ], ], 'backendName' => 'vectorDBConfig', ], 'UserVpc' => [ 'description' => '', 'visibility' => 'Private', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => 'VPC ID', 'description' => 'VPC ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vpc-y7d8****io93', 'descriptionEn' => 'VPC ID', ], ], 'backendName' => 'userVpc', ], 'Creator' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '1247****1467', 'backendName' => 'creator', ], 'RuntimeId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'rtime-78****d6', 'backendName' => 'runtimeId', ], 'ScheduleConfig' => [ 'description' => '', 'visibility' => 'Private', 'type' => 'object', 'properties' => [ 'InstanceMode' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'T+1', 'descriptionEn' => 'Instance mode', 'default' => 'Immediately', 'enum' => [ 'Immediately', 'T+1', ], ], 'Recurrence' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Normal', 'descriptionEn' => 'Recurrence', 'default' => 'Normal', 'enum' => [ 'Normal', 'Skip', 'Pause', ], ], 'RerunMode' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '***', 'descriptionEn' => 'Rerun mode', 'default' => 'Allowed', 'enum' => [ 'Allowed', 'Denied', 'FailureAllowed', ], ], 'FailureRerunConfig' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'RerunTimes' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '3', 'descriptionEn' => 'Rerun times', 'default' => '3', ], 'RerunInterval' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1800', 'descriptionEn' => 'Rerun interval', 'default' => '180', ], ], 'descriptionEn' => 'Failure rerun config', ], 'Timeout' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'descriptionEn' => 'Run timeout', 'default' => '86400', ], 'TriggerConfig' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Cron' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '0 0/10 * * * ?', 'descriptionEn' => 'Cron expression', ], 'StartTime' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2025-04-14T02:22:01Z', 'descriptionEn' => 'Start time', ], 'EndTime' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2025-04-14T02:30:00Z', 'descriptionEn' => 'End time', ], ], 'descriptionEn' => 'Trigger config', ], 'ResourceGroupConfig' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'ResourceGroup' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '{}', 'descriptionEn' => 'ResourceGroup ', ], 'Id' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '113', 'descriptionEn' => 'ResourceGroup ID', ], ], 'descriptionEn' => 'ResourceGroup config', ], 'EcsSpecs' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Worker', 'readOnly' => true, 'backendName' => 'Type', 'descriptionEn' => 'Node type', 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'ecs.c6.large', 'readOnly' => true, 'backendName' => 'InstanceType', 'descriptionEn' => 'Instance type', ], 'PodCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'readOnly' => true, 'backendName' => 'PodCount', 'descriptionEn' => 'Pod count', ], 'CPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '4', 'readOnly' => true, 'backendName' => 'CPU', 'descriptionEn' => 'CPU', ], 'GPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'readOnly' => true, 'backendName' => 'GPU', 'descriptionEn' => 'GPU', ], 'Memory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'readOnly' => true, 'backendName' => 'Memory', 'descriptionEn' => 'Memory', ], 'SharedMemory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'readOnly' => true, 'backendName' => 'SharedMemory', 'descriptionEn' => 'Shared memory', ], 'GPUType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'V100', 'readOnly' => true, 'backendName' => 'GPUType', 'descriptionEn' => 'GPU type', ], 'Driver' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '550.127.08', 'readOnly' => true, 'backendName' => 'Driver', 'descriptionEn' => 'Driver version', ], ], 'extendType' => 'true', ], 'descriptionEn' => 'ECS config', ], 'UserVpc' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => 'VPC ID', 'description' => 'VPC ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vpc-wz90****5v23', 'descriptionEn' => 'VPC ID', ], 'VSwitchId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vsw-wz9r****ng10', 'descriptionEn' => 'Switch ID', ], 'SecurityGroupId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sg-wz9i****1129', 'descriptionEn' => 'Security group ID', ], ], 'descriptionEn' => 'User VPC config', ], 'ResourceId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'quota89**76', 'descriptionEn' => 'Resource ID', ], 'Status' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Success', 'descriptionEn' => 'Schedule config status', ], 'GmtCreateTime' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2025-04-29T02:07:14Z', 'descriptionEn' => 'Schedule config create time', ], 'GmtModifiedTime' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2025-04-29T02:40:36Z', 'descriptionEn' => 'Schedule config modified time', ], 'ScheduleWorkflowId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '6237****9023', 'descriptionEn' => 'Schedule config workflow ID', ], 'ScheduleCycleTaskId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '11**67', 'descriptionEn' => 'Schedule cycle task ID', ], ], 'backendName' => 'scheduleConfig', ], 'MetaDataConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'CustomMetaData' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'column1', 'descriptionEn' => 'Metadata key', ], 'ValueType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'String', 'descriptionEn' => 'Metadata value type', ], 'ReferenceCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '3', 'readOnly' => true, 'descriptionEn' => 'Reference count', ], 'ValueCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '8', 'readOnly' => true, 'descriptionEn' => 'Value count', ], ], 'extendType' => 'true', ], 'itemName' => 'CustomMetaData', 'descriptionEn' => 'Custom metadata', ], ], 'backendName' => 'metaDataConfig', ], 'AutoUpdateConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Status' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Enable', 'descriptionEn' => 'Auto update status', 'default' => 'Disable', ], 'ResourceId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'quota87**45', 'descriptionEn' => 'Resource id', ], 'MaxRunningTimeInSeconds' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '86400', 'descriptionEn' => 'Max running time', ], 'EmbeddingConfig' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '8', 'descriptionEn' => 'Embedding batch size', ], 'Concurrency' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'maximum' => '200', 'minimum' => '1', 'example' => '1', 'descriptionEn' => 'Embedding concurrency', ], ], 'descriptionEn' => 'Embedding config', ], 'UserVpc' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'descriptionEn' => 'Vpc config', '$ref' => '#/components/schemas/UserVpc', ], 'EcsSpecs' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Worker', 'backendName' => 'Type', 'descriptionEn' => 'Node type', 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'ecs.c6.large', 'backendName' => 'InstanceType', 'descriptionEn' => 'Instance type', ], 'PodCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'backendName' => 'PodCount', 'descriptionEn' => 'Pod count', ], 'GPUType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'V100', 'backendName' => 'GPUType', 'descriptionEn' => 'GPU type', ], 'CPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '4', 'backendName' => 'CPU', 'descriptionEn' => 'CPU', ], 'GPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'backendName' => 'GPU', 'descriptionEn' => 'GPU', ], 'Memory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'backendName' => 'Memory', 'descriptionEn' => 'Memory', ], 'SharedMemory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'backendName' => 'SharedMemory', 'descriptionEn' => 'Shared memory', ], 'Driver' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '550.127.08', 'backendName' => 'Driver', 'descriptionEn' => 'Driver version', ], ], 'extendType' => 'true', ], 'itemName' => 'EcsSpecElem', 'descriptionEn' => 'Running resource config', ], ], 'backendName' => 'autoUpdateConfig', ], 'VersionName' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'v1', 'backendName' => 'versionName', ], 'IndexColumnConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'EmbeddingColumns' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'column1', 'readOnly' => true, 'descriptionEn' => 'Column key', ], ], 'readOnly' => true, 'extendType' => 'true', ], 'readOnly' => true, 'itemName' => 'EmbeddingColumn', 'descriptionEn' => 'Embedding columns', ], 'ContentColumns' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'column1', 'readOnly' => true, 'descriptionEn' => 'Column key', ], ], 'readOnly' => true, 'extendType' => 'true', ], 'readOnly' => true, 'itemName' => 'ContentColumn', 'descriptionEn' => 'Content columns', ], 'ColumnDefinitions' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'column1', 'readOnly' => true, 'descriptionEn' => 'Column key', ], ], 'readOnly' => true, 'extendType' => 'true', ], 'readOnly' => true, 'itemName' => 'ColumnDefinition', 'descriptionEn' => 'Column definitions', ], ], 'backendName' => 'indexColumnConfig', ], 'IndexManifest' => [ 'description' => '', 'visibility' => 'Private', 'type' => 'string', 'example' => '{}', 'backendName' => 'indexManifest', ], ], ], 'KnowledgeBaseFileChunk' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Score' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'number', 'format' => 'float', 'example' => '0.9832', 'backendName' => 'score', ], 'ChunkId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '7fjs******90fs', 'backendName' => 'chunkId', ], 'ChunkStart' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '0', 'backendName' => 'chunkStart', ], 'ChunkEnd' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '30000', 'backendName' => 'chunkEnd', ], 'ChunkSequence' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '0', 'backendName' => 'chunkSequence', ], 'ChunkContent' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'content of chunk', 'backendName' => 'chunkContent', ], 'ChunkSize' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '3452', 'backendName' => 'chunkSize', ], 'ChunkStatus' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Enable', 'backendName' => 'chunkStatus', ], 'DownloadUrl' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://cas-documents-service.oss-cn-shanghai.aliyuncs.com/5743962650c522fd54620fb9868d8c4c?Expires=1735092238&OSSAccessKeyId=LTAIgoNmxRtIx2Ue&Signature=PepwMeJs%2Bfz9aypuvMPUSVFF', 'backendName' => 'downloadUrl', ], 'ThumbnailUrl' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://cas-documents-service.oss-cn-shanghai.aliyuncs.com/5743962650c522fd54620fb9868d8c4c?Expires=1735092238&OSSAccessKeyId=LTAIgoNmxRtIx2Ue&Signature=PepwMeJs%2Bfz9aypuvMPUSVFF&x-oss-process=video%2Fsnapshot%2Ct_0%2Cf_jpg%2Ch_200', 'backendName' => 'thumbnailUrl', ], 'ChunkAttachment' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'PlaceholderId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'IMAGE_PLACEHOLDER_0', 'backendName' => 'placeholderId', ], 'Type' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'image', 'backendName' => 'type', ], 'Uri' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'oss://mybucket/file1/img1.jpg', 'backendName' => 'uri', ], 'DownloadUrl' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://cas-documents-service.oss-cn-shanghai.aliyuncs.com/Batch_Upload_Monitor_Domain.xlsx?Expires=1737338736&OSSAccessKeyId=LTAIgoNmxRtIx2Ue&Signature=YEOPgNII9xxCLrfkWvWjQN9pkXo%3D', 'backendName' => 'downloadUrl', ], ], 'extendType' => 'true', ], 'backendName' => 'chunkAttachment', ], 'MetaData' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'FileName' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'abc.txt', 'backendName' => 'fileName', ], 'FileUri' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'oss://mybucket/path/abc.txt', 'backendName' => 'fileUri', ], 'FileMetaId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sd8c******67ux', 'backendName' => 'fileMetaId', ], ], 'backendName' => 'metaData', ], ], ], 'KnowledgeBaseJob' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '478**', 'backendName' => 'workspaceId', ], 'Accessibility' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'PRIVATE', 'backendName' => 'accessibility', ], 'Creator' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2003******4844', 'backendName' => 'creator', ], 'GmtCreateTime' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2024-05-13T01:43:15Z', 'backendName' => 'gmtCreateTime', ], 'GmtModifiedTime' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2024-05-13T03:05:22Z', 'backendName' => 'gmtModifiedTime', ], 'KnowledgeBaseId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'd-ksicx823d', 'backendName' => 'knowledgeBaseId', ], 'KnowledgeBaseJobId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'kbjob-9m******54', 'backendName' => 'knowledgeBaseJobId', ], 'JobAction' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'SyncIndex', 'backendName' => 'jobAction', ], 'Description' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'This is a description of the knowledge base job.', 'backendName' => 'description', ], 'Status' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Running', 'backendName' => 'status', ], 'ResourceId' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'quota89**76', 'backendName' => 'resourceId', ], 'EcsSpecs' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'array', 'items' => [ 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Worker', 'readOnly' => true, 'backendName' => 'Type', 'descriptionEn' => 'Node type', 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'ecs.c6.large', 'readOnly' => true, 'backendName' => 'InstanceType', 'descriptionEn' => 'Instance type', ], 'PodCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'readOnly' => true, 'backendName' => 'PodCount', 'descriptionEn' => 'Pod count', ], 'CPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '4', 'readOnly' => true, 'backendName' => 'CPU', 'descriptionEn' => 'CPU', ], 'GPU' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'readOnly' => true, 'backendName' => 'GPU', 'descriptionEn' => 'GPU', ], 'Memory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'readOnly' => true, 'backendName' => 'Memory', 'descriptionEn' => 'Memory', ], 'SharedMemory' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '16', 'readOnly' => true, 'backendName' => 'SharedMemory', 'descriptionEn' => 'Shared memory', ], 'GPUType' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'V100', 'readOnly' => true, 'backendName' => 'GPUType', 'descriptionEn' => 'GPU type', ], 'Driver' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '550.127.08', 'readOnly' => true, 'backendName' => 'Driver', 'descriptionEn' => 'Driver version', ], ], 'extendType' => 'true', ], 'backendName' => 'ecsSpecs', 'itemName' => 'EcsSpecElem', ], 'UserVpc' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => 'VPC ID', 'description' => 'VPC ID。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vpc-wz90****5v23', 'descriptionEn' => 'VPC ID', ], 'VSwitchId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vsw-wz9r****ng10', 'descriptionEn' => 'Switch ID', ], 'SecurityGroupId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sg-wz91****e10e', 'descriptionEn' => 'Security group ID', ], ], 'backendName' => 'userVpc', ], 'MaxRunningTimeInSeconds' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '86400', 'backendName' => 'maxRunningTimeInSeconds', ], 'GmtFinishTime' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => '2024-05-13T04:03:27Z', 'backendName' => 'gmtFinishTime', ], 'ErrorMessage' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Failed to update knwoledge base index, pipelineRunId: flow-9p8f****4t9z', 'backendName' => 'errorMessage', ], 'PipelineRunInfo' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'PipelineRunId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'flow-fi8z******g4gy', 'readOnly' => true, 'descriptionEn' => 'PaiFlow pipeline run ID', ], ], 'backendName' => 'pipelineRunInfo', ], 'KnowledgeBaseJobResult' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'TotalFileCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'descriptionEn' => 'Total file count', ], 'AddChunkCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '10', 'descriptionEn' => 'Add chunk count', ], 'DeleteChunkCount' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '2', 'descriptionEn' => 'Delete chunk count', ], 'FileMetas' => [ 'title' => '', 'description' => '', 'visibility' => 'Private', 'type' => 'array', 'items' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'FileMetaId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'ks3fje****8cedew', 'descriptionEn' => 'File meta Id', ], 'FileName' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'abc.pdf', 'descriptionEn' => 'File name', ], 'FileUri' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'oss://mybucket/path/abc.pdf', 'descriptionEn' => 'OSS uri', ], 'Action' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Add', 'descriptionEn' => 'Action', ], ], 'extendType' => 'true', ], 'readOnly' => true, 'itemName' => 'FileMetas', 'descriptionEn' => 'File meta data', ], ], 'backendName' => 'knowledgeBaseJobResult', ], 'EmbeddingConfig' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '8', 'readOnly' => true, 'descriptionEn' => 'Embedding batch size', ], 'Concurrency' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'maximum' => '200', 'minimum' => '1', 'example' => '1', 'readOnly' => true, 'descriptionEn' => 'Embedding concurrency', ], ], 'backendName' => 'embeddingConfig', ], ], ], 'UserVpc' => [ 'description' => '', 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vpc-m5ec******44cn', 'backendName' => 'VpcId', 'descriptionEn' => 'Vpc id', ], 'VSwitchId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'vsw-hp32******z9qo', 'backendName' => 'VSwitchId', 'descriptionEn' => 'VSwitch id', ], 'SecurityGroupId' => [ 'title' => '', 'description' => '', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sg-bp1f******iy9h', 'backendName' => 'SecurityGroupId', 'descriptionEn' => 'Security group id', ], ], ], ], ], 'apis' => [ 'CreateKnowledgeBase' => [ 'summary' => 'Create a knowledge base.', 'path' => '/api/v1/langstudio/knowledgebases', 'methods' => [ 'post', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'write', 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478**', ], 'Accessibility' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'PUBLIC', 'default' => 'PUBLIC', 'enum' => [ 'PUBLIC', 'PRIVATE', ], ], 'Name' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'myName', ], 'Description' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'This is a description of the knowledge base.', ], 'KnowledgeBaseType' => [ 'description' => '', 'type' => 'string', 'required' => true, 'enumValueTitles' => [ 'STRUCTURED' => 'STRUCTURED', 'IMAGE' => 'IMAGE', 'VIDEO' => 'VIDEO', 'TEXT' => 'TEXT', ], 'example' => 'TEXT', ], 'OutputDir' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/output/', ], 'DataSources' => [ 'description' => '', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Uri' => [ 'title' => '统一资源识别码', 'description' => '统一资源识别码', 'type' => 'string', 'required' => false, 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/', 'readOnly' => true, ], ], 'required' => false, ], 'required' => true, ], 'ChunkConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'ChunkSize' => [ 'title' => '分块大小', 'description' => '分块大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1024', 'readOnly' => true, ], 'ChunkOverlap' => [ 'title' => '分块重叠大小', 'description' => '分块重叠大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '200', 'readOnly' => true, ], 'ChunkDuration' => [ 'title' => '分块时长', 'description' => '分块时长', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'readOnly' => true, ], 'ChunkStrategy' => [ 'title' => '分块策略', 'description' => '分块策略', 'type' => 'string', 'required' => false, 'example' => 'Default', 'readOnly' => true, 'default' => 'Default', ], ], 'required' => true, ], 'EmbeddingConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'ConnectionId' => [ 'title' => 'Embedding连接ID', 'description' => 'Embedding连接ID', 'type' => 'string', 'required' => true, 'example' => 'conn-r3o7******38bh', 'readOnly' => true, ], 'Model' => [ 'title' => '模型', 'description' => '模型', 'type' => 'string', 'required' => true, 'example' => 'text-embedding-v4', 'readOnly' => true, ], ], 'required' => true, ], 'VectorDBConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'VectorDBType' => [ 'title' => 'VectorDB类型', 'description' => 'VectorDB类型', 'type' => 'string', 'required' => true, 'enumValueTitles' => [ 'Elasticsearch' => 'Elasticsearch', 'Faiss' => 'Faiss', 'Milvus' => 'Milvus', ], 'example' => 'Milvus', 'readOnly' => true, ], 'ConnectionId' => [ 'title' => 'Embedding连接ID', 'description' => 'Embedding连接ID', 'type' => 'string', 'required' => false, 'example' => 'conn-7y5y******jja7', 'readOnly' => true, ], 'CollectionName' => [ 'title' => 'Collection名称', 'description' => 'Collectioin名称', 'type' => 'string', 'required' => false, 'example' => 'my_collection', 'readOnly' => true, ], ], 'required' => true, ], 'RuntimeId' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'rtime-apje******beaz', ], 'MetaDataConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'CustomMetaData' => [ 'title' => '自定义元数据', 'description' => '自定义元数据', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '元数据Key', 'description' => '元数据Key', 'type' => 'string', 'required' => false, 'example' => 'author', ], 'ValueType' => [ 'title' => '元数据Value类型', 'description' => '元数据Value类型', 'type' => 'string', 'required' => false, 'example' => 'String', ], ], 'required' => false, ], 'required' => false, ], ], 'required' => false, ], 'IndexColumnConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'EmbeddingColumns' => [ 'title' => 'Embedding列', 'description' => 'Embedding列', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'required' => false, 'example' => 'column1', 'readOnly' => true, ], ], 'required' => false, 'readOnly' => true, ], 'required' => false, 'readOnly' => true, ], 'ContentColumns' => [ 'title' => '内容检索列', 'description' => '内容检索列', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'required' => false, 'example' => 'column1', 'readOnly' => true, ], ], 'required' => false, 'readOnly' => true, ], 'required' => false, 'readOnly' => true, ], 'ColumnDefinitions' => [ 'title' => '所有列名', 'description' => '所有列名', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'required' => false, 'example' => 'column1', 'readOnly' => true, ], ], 'required' => false, 'readOnly' => true, ], 'required' => false, 'readOnly' => true, ], ], 'required' => false, ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'example' => '478**', ], 'KnowledgeBaseId' => [ 'description' => '', 'type' => 'string', 'example' => 'd-ksicx823d', ], 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '48E6392E-C3C9-5212-9FAD-13256ABD9AF6', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"WorkspaceId\\": \\"478**\\",\\n \\"KnowledgeBaseId\\": \\"d-ksicx823d\\",\\n \\"RequestId\\": \\"48E6392E-C3C9-5212-9FAD-13256ABD9AF6\\"\\n}","type":"json"}]', 'title' => 'CreateKnowledgeBase', ], 'GetKnowledgeBase' => [ 'summary' => 'Get knowledge base.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478**', ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-ksicx823d', ], ], [ 'name' => 'VersionName', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'v1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', 'title' => '请求ID', ], 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'example' => '478**', ], 'Accessibility' => [ 'description' => '', 'type' => 'string', 'example' => 'PRIVATE', ], 'GmtCreateTime' => [ 'description' => '', 'type' => 'string', 'example' => '2024-12-15T14:46:23Z', ], 'GmtModifiedTime' => [ 'description' => '', 'type' => 'string', 'example' => '2025-12-18T19:32:58Z', ], 'Name' => [ 'description' => '', 'type' => 'string', 'example' => 'myName', ], 'KnowledgeBaseId' => [ 'description' => '', 'type' => 'string', 'example' => 'd-ksicx823d', ], 'Description' => [ 'description' => '', 'type' => 'string', 'example' => 'This is a description of the knowledge base.', ], 'KnowledgeBaseType' => [ 'description' => '', 'type' => 'string', 'example' => 'TEXT', ], 'DatasetId' => [ 'description' => '', 'type' => 'string', 'example' => 'd-cupbwkk5us9xpjz870', ], 'DataSources' => [ 'description' => '', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Uri' => [ 'title' => '统一资源识别码', 'description' => '统一资源识别码', 'type' => 'string', 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/', 'readOnly' => true, ], ], ], ], 'OutputDir' => [ 'description' => '', 'type' => 'string', 'example' => 'oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/output/', ], 'ChunkConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'ChunkSize' => [ 'title' => '分块大小', 'description' => '分块大小', 'type' => 'integer', 'format' => 'int32', 'example' => '1024', 'readOnly' => true, ], 'ChunkOverlap' => [ 'title' => '分块重叠大小', 'description' => '分块重叠大小', 'type' => 'integer', 'format' => 'int32', 'example' => '200', 'readOnly' => true, ], 'ChunkDuration' => [ 'title' => '分块时长', 'description' => '分块时长', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'readOnly' => true, ], 'ChunkStrategy' => [ 'title' => '分块策略', 'description' => '分块策略', 'type' => 'string', 'example' => 'Default', 'readOnly' => true, 'default' => 'Default', ], ], ], 'EmbeddingConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'ConnectionName' => [ 'title' => 'Embedding连接名称', 'description' => 'Embedding连接名称', 'type' => 'string', 'example' => 'myEmbeddingConn', ], 'ConnectionId' => [ 'title' => 'Embedding连接ID', 'description' => 'Embedding连接ID', 'type' => 'string', 'example' => 'conn-r3o7******38bh', ], 'Model' => [ 'title' => '模型', 'description' => '模型', 'type' => 'string', 'example' => 'text-embedding-v4', ], ], ], 'VectorDBConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'VectorDBType' => [ 'title' => 'VectorDB类型', 'description' => 'VectorDB类型', 'type' => 'string', 'example' => 'Milvus', ], 'ConnectionName' => [ 'title' => 'VectorDB连接名称', 'description' => 'VectorDB连接名称', 'type' => 'string', 'example' => 'myVectorConn', ], 'ConnectionId' => [ 'title' => 'Embedding连接ID', 'description' => 'Embedding连接ID', 'type' => 'string', 'example' => 'conn-7y5y******jja7', ], 'CollectionName' => [ 'title' => 'Collection名称', 'description' => 'Collectioin名称', 'type' => 'string', 'example' => 'my_collection', ], ], ], 'Creator' => [ 'description' => '', 'type' => 'string', 'example' => '2485765****023475', ], 'RuntimeId' => [ 'description' => '', 'type' => 'string', 'example' => 'rtime-apje******beaz', ], 'MetaDataConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'CustomMetaData' => [ 'title' => '自定义元数据', 'description' => '自定义元数据', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '元数据Key', 'description' => '元数据Key', 'type' => 'string', ], 'ValueType' => [ 'title' => '元数据Value类型', 'description' => '元数据Value类型', 'type' => 'string', ], 'ReferenceCount' => [ 'title' => '引用次数', 'description' => '引用次数', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], 'ValueCount' => [ 'title' => '值的个数', 'description' => '值的个数', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], ], ], ], ], ], 'AutoUpdateConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'Status' => [ 'title' => '知识库自动更新状态', 'description' => '知识库自动更新状态', 'type' => 'string', 'enumValueTitles' => [ 'Enable' => 'Enable', 'Disable' => 'Disable', ], 'example' => 'Enable', 'default' => 'Disable', ], 'ResourceId' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'example' => 'public-cluster', ], 'MaxRunningTimeInSeconds' => [ 'title' => '任务最大运行时间', 'description' => '任务最大运行时间', 'type' => 'integer', 'format' => 'int32', 'example' => '86400', ], 'EmbeddingConfig' => [ 'title' => 'Embedding配置', 'description' => 'Embedding配置', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => 'Embedding分批大小', 'description' => 'Embedding分批大小', 'type' => 'integer', 'format' => 'int32', 'example' => '8', ], 'Concurrency' => [ 'title' => 'Embedding并发数', 'description' => 'Embedding并发数', 'type' => 'integer', 'format' => 'int32', 'maximum' => '200', 'minimum' => '1', 'example' => '1', ], ], ], 'UserVpc' => [ 'title' => '用户VPC配置', 'description' => '用户VPC配置', '$ref' => '#/components/schemas/UserVpc', ], 'EcsSpecs' => [ 'title' => '运行资源配置', 'description' => '运行资源配置', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '节点类型', 'description' => '节点类型', 'type' => 'string', 'example' => 'Worker', 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '机型名称', 'description' => '机型名称', 'type' => 'string', 'example' => 'ecs.c6.large', ], 'PodCount' => [ 'title' => '副本数量', 'description' => '副本数量', 'type' => 'integer', 'format' => 'int32', ], 'GPUType' => [ 'title' => 'GPU类型', 'description' => 'GPU类型', 'type' => 'string', ], 'CPU' => [ 'title' => 'CPU核数', 'description' => 'CPU核数', 'type' => 'integer', 'format' => 'int32', ], 'GPU' => [ 'title' => 'GPU卡数', 'description' => 'GPU卡数', 'type' => 'integer', 'format' => 'int32', ], 'Memory' => [ 'title' => '内存大小', 'description' => '内存大小', 'type' => 'integer', 'format' => 'int32', ], 'SharedMemory' => [ 'title' => '共享内存容量', 'description' => '共享内存容量', 'type' => 'integer', 'format' => 'int32', ], 'Driver' => [ 'title' => '驱动版本', 'description' => '驱动版本', 'type' => 'string', ], ], ], ], ], ], 'VersionName' => [ 'description' => '', 'type' => 'string', ], 'IndexColumnConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'EmbeddingColumns' => [ 'title' => 'Embedding列', 'description' => 'Embedding列', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'readOnly' => true, ], ], 'readOnly' => true, ], 'readOnly' => true, ], 'ContentColumns' => [ 'title' => '内容检索列', 'description' => '内容检索列', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'readOnly' => true, ], ], 'readOnly' => true, ], 'readOnly' => true, ], 'ColumnDefinitions' => [ 'title' => '所有列名', 'description' => '所有列名', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '列Key', 'description' => '列Key', 'type' => 'string', 'readOnly' => true, ], ], 'readOnly' => true, ], 'readOnly' => true, ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"963BD7F9-0C02-5594-9550-BCC6DD43E3C0\\",\\n \\"WorkspaceId\\": \\"478**\\",\\n \\"Accessibility\\": \\"PRIVATE\\",\\n \\"GmtCreateTime\\": \\"2024-12-15T14:46:23Z\\",\\n \\"GmtModifiedTime\\": \\"2025-12-18T19:32:58Z\\",\\n \\"Name\\": \\"myName\\",\\n \\"KnowledgeBaseId\\": \\"d-ksicx823d\\",\\n \\"Description\\": \\"This is a description of the knowledge base.\\",\\n \\"KnowledgeBaseType\\": \\"TEXT\\",\\n \\"DatasetId\\": \\"d-cupbwkk5us9xpjz870\\",\\n \\"DataSources\\": [\\n {\\n \\"Uri\\": \\"oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/\\"\\n }\\n ],\\n \\"OutputDir\\": \\"oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/output/\\",\\n \\"ChunkConfig\\": {\\n \\"ChunkSize\\": 1024,\\n \\"ChunkOverlap\\": 200,\\n \\"ChunkDuration\\": 30,\\n \\"ChunkStrategy\\": \\"Default\\"\\n },\\n \\"EmbeddingConfig\\": {\\n \\"ConnectionName\\": \\"myEmbeddingConn\\",\\n \\"ConnectionId\\": \\"conn-r3o7******38bh\\",\\n \\"Model\\": \\"text-embedding-v4\\"\\n },\\n \\"VectorDBConfig\\": {\\n \\"VectorDBType\\": \\"Milvus\\",\\n \\"ConnectionName\\": \\"myVectorConn\\",\\n \\"ConnectionId\\": \\"conn-7y5y******jja7\\",\\n \\"CollectionName\\": \\"my_collection\\"\\n },\\n \\"Creator\\": \\"2485765****023475\\",\\n \\"RuntimeId\\": \\"rtime-apje******beaz\\",\\n \\"MetaDataConfig\\": {\\n \\"CustomMetaData\\": [\\n {\\n \\"Key\\": \\"author\\",\\n \\"ValueType\\": \\"String\\",\\n \\"ReferenceCount\\": 5,\\n \\"ValueCount\\": 3\\n }\\n ]\\n },\\n \\"AutoUpdateConfig\\": {\\n \\"Status\\": \\"Enable\\",\\n \\"ResourceId\\": \\"quota89**76\\",\\n \\"MaxRunningTimeInSeconds\\": 86400,\\n \\"EmbeddingConfig\\": {\\n \\"BatchSize\\": 8,\\n \\"Concurrency\\": 1\\n },\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"\\",\\n \\"VSwitchId\\": \\"\\",\\n \\"SecurityGroupId\\": \\"\\"\\n },\\n \\"EcsSpecs\\": [\\n {\\n \\"Type\\": \\"Worker\\",\\n \\"InstanceType\\": \\"ecs.c6.large\\",\\n \\"PodCount\\": 1,\\n \\"GPUType\\": \\"V100\\",\\n \\"CPU\\": 4,\\n \\"GPU\\": 1,\\n \\"Memory\\": 16,\\n \\"SharedMemory\\": 16,\\n \\"Driver\\": \\"550.127.08\\"\\n }\\n ]\\n },\\n \\"VersionName\\": \\"v1\\",\\n \\"IndexColumnConfig\\": {\\n \\"EmbeddingColumns\\": [\\n {\\n \\"Key\\": \\"column1\\"\\n }\\n ],\\n \\"ContentColumns\\": [\\n {\\n \\"Key\\": \\"column1\\"\\n }\\n ],\\n \\"ColumnDefinitions\\": [\\n {\\n \\"Key\\": \\"column1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => 'GetKnowledgeBase', ], 'UpdateKnowledgeBase' => [ 'summary' => 'Update Knowledge Base.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}', 'methods' => [ 'put', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, ], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'required' => true, ], 'Description' => [ 'description' => '', 'type' => 'string', 'required' => false, ], 'RuntimeId' => [ 'description' => '', 'type' => 'string', 'required' => false, ], 'BindRuntime' => [ 'description' => '', 'type' => 'boolean', 'required' => false, ], 'MetaDataConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'CustomMetaData' => [ 'title' => '自定义元数据', 'description' => '自定义元数据', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '元数据Key', 'description' => '元数据Key', 'type' => 'string', 'required' => false, ], 'ValueType' => [ 'title' => '元数据Value类型', 'description' => '元数据Value类型', 'type' => 'string', 'required' => false, 'example' => 'String', ], ], 'required' => false, ], 'required' => false, ], ], 'required' => false, ], 'AutoUpdateConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'Status' => [ 'title' => '知识库自动更新状态', 'description' => '知识库自动更新状态', 'type' => 'string', 'required' => false, 'default' => 'Disable', ], 'ResourceId' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'required' => false, ], 'MaxRunningTimeInSeconds' => [ 'title' => '任务最大运行时间', 'description' => '任务最大运行时间', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '86400', ], 'EmbeddingConfig' => [ 'title' => 'Embedding配置', 'description' => 'Embedding配置', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => 'Embedding分批大小', 'description' => 'Embedding分批大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'Concurrency' => [ 'title' => 'Embedding并发数', 'description' => 'Embedding并发数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '1', ], ], 'required' => false, ], 'UserVpc' => [ 'title' => '用户VPC配置', 'description' => '用户VPC配置', 'required' => false, '$ref' => '#/components/schemas/UserVpc', ], 'EcsSpecs' => [ 'title' => '运行资源配置', 'description' => '运行资源配置', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '节点类型', 'description' => '节点类型', 'type' => 'string', 'required' => false, 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '机型名称', 'description' => '机型名称', 'type' => 'string', 'required' => false, ], 'PodCount' => [ 'title' => '副本数量', 'description' => '副本数量', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'GPUType' => [ 'title' => 'GPU类型', 'description' => 'GPU类型', 'type' => 'string', 'required' => false, ], 'CPU' => [ 'title' => 'CPU核数', 'description' => 'CPU核数', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'GPU' => [ 'title' => 'GPU卡数', 'description' => 'GPU卡数', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'Memory' => [ 'title' => '内存大小', 'description' => '内存大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'SharedMemory' => [ 'title' => '共享内存容量', 'description' => '共享内存容量', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], 'Driver' => [ 'title' => '驱动版本', 'description' => '驱动版本', 'type' => 'string', 'required' => false, ], ], 'required' => false, ], 'required' => false, ], ], 'required' => false, ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'type' => 'string', 'title' => '请求ID', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"48E6392E-C3C9-5212-9FAD-13256ABD9AF6\\"\\n}","type":"json"}]', 'title' => 'UpdateKnowledgeBase', ], 'DeleteKnowledgeBase' => [ 'summary' => 'Delete knowledge base.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}', 'methods' => [ 'delete', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'write', 'systemTags' => [ 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478***', ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-nacr******sxd2', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => 'C25324E3-18E6-50D8-9026-16D74AAEEB26', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C25324E3-18E6-50D8-9026-16D74AAEEB26\\"\\n}","type":"json"}]', 'title' => 'DeleteKnowledgeBase', ], 'ListKnowledgeBases' => [ 'summary' => 'Queries a list of knowledge bases.', 'path' => '/api/v1/langstudio/knowledgebases', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'Name', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'NextToken', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'MaxResults', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], ], [ 'name' => 'SortBy', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'GmtCreateTime', ], ], [ 'name' => 'Order', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'DESC', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, ], ], [ 'name' => 'Creator', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'KnowledgeBaseType', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'KnowledgeBases' => [ 'description' => '', 'type' => 'array', 'items' => [ '$ref' => '#/components/schemas/KnowledgeBase', ], ], 'MaxResults' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'title' => '请求最大返回结果数', 'example' => '10', ], 'NextToken' => [ 'description' => '', 'type' => 'string', 'title' => '下次请求令牌', 'example' => '11', ], 'TotalCount' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'title' => '总量', 'example' => '25', ], 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '35686626-8D83-5ADE-B400-08A6613A6057', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"KnowledgeBases\\": [\\n {\\n \\"WorkspaceId\\": \\"\\",\\n \\"Accessibility\\": \\"\\",\\n \\"GmtCreateTime\\": \\"\\",\\n \\"GmtModifiedTime\\": \\"\\",\\n \\"Name\\": \\"\\",\\n \\"KnowledgeBaseId\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"KnowledgeBaseType\\": \\"\\",\\n \\"DatasetId\\": \\"\\",\\n \\"DataSources\\": [\\n {\\n \\"Uri\\": \\"\\"\\n }\\n ],\\n \\"OutputDir\\": \\"\\",\\n \\"ChunkConfig\\": {\\n \\"ChunkSize\\": 0,\\n \\"ChunkOverlap\\": 0,\\n \\"ChunkDuration\\": 0,\\n \\"ChunkStrategy\\": \\"\\"\\n },\\n \\"EmbeddingConfig\\": {\\n \\"EmbeddingType\\": \\"\\",\\n \\"ConnectionName\\": \\"\\",\\n \\"ConnectionId\\": \\"\\",\\n \\"Model\\": \\"\\"\\n },\\n \\"VectorDBConfig\\": {\\n \\"VectorDBType\\": \\"\\",\\n \\"ConnectionName\\": \\"\\",\\n \\"ConnectionId\\": \\"\\",\\n \\"CollectionName\\": \\"\\"\\n },\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"\\"\\n },\\n \\"Creator\\": \\"\\",\\n \\"RuntimeId\\": \\"\\",\\n \\"ScheduleConfig\\": {\\n \\"InstanceMode\\": \\"\\",\\n \\"Recurrence\\": \\"\\",\\n \\"RerunMode\\": \\"\\",\\n \\"FailureRerunConfig\\": {\\n \\"RerunTimes\\": 0,\\n \\"RerunInterval\\": 0\\n },\\n \\"Timeout\\": 0,\\n \\"TriggerConfig\\": {\\n \\"Cron\\": \\"\\",\\n \\"StartTime\\": \\"\\",\\n \\"EndTime\\": \\"\\"\\n },\\n \\"ResourceGroupConfig\\": {\\n \\"ResourceGroup\\": \\"\\",\\n \\"Id\\": \\"\\"\\n },\\n \\"EcsSpecs\\": [\\n {\\n \\"Type\\": \\"\\",\\n \\"InstanceType\\": \\"\\",\\n \\"PodCount\\": 0,\\n \\"CPU\\": 0,\\n \\"GPU\\": 0,\\n \\"Memory\\": 0,\\n \\"SharedMemory\\": 0,\\n \\"GPUType\\": \\"\\",\\n \\"Driver\\": \\"\\"\\n }\\n ],\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"\\",\\n \\"VSwitchId\\": \\"\\",\\n \\"SecurityGroupId\\": \\"\\"\\n },\\n \\"ResourceId\\": \\"\\",\\n \\"Status\\": \\"\\",\\n \\"GmtCreateTime\\": \\"\\",\\n \\"GmtModifiedTime\\": \\"\\",\\n \\"ScheduleWorkflowId\\": \\"\\",\\n \\"ScheduleCycleTaskId\\": \\"\\"\\n },\\n \\"MetaDataConfig\\": {\\n \\"CustomMetaData\\": [\\n {\\n \\"Key\\": \\"\\",\\n \\"ValueType\\": \\"\\",\\n \\"ReferenceCount\\": 0,\\n \\"ValueCount\\": 0\\n }\\n ]\\n },\\n \\"AutoUpdateConfig\\": {\\n \\"Status\\": \\"\\",\\n \\"ResourceId\\": \\"\\",\\n \\"MaxRunningTimeInSeconds\\": 0,\\n \\"EmbeddingConfig\\": {\\n \\"BatchSize\\": 0,\\n \\"Concurrency\\": 0\\n },\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"\\",\\n \\"VSwitchId\\": \\"\\",\\n \\"SecurityGroupId\\": \\"\\"\\n },\\n \\"EcsSpecs\\": [\\n {\\n \\"Type\\": \\"\\",\\n \\"InstanceType\\": \\"\\",\\n \\"PodCount\\": 0,\\n \\"GPUType\\": \\"\\",\\n \\"CPU\\": 0,\\n \\"GPU\\": 0,\\n \\"Memory\\": 0,\\n \\"SharedMemory\\": 0,\\n \\"Driver\\": \\"\\"\\n }\\n ]\\n },\\n \\"VersionName\\": \\"\\",\\n \\"IndexColumnConfig\\": {\\n \\"EmbeddingColumns\\": [\\n {\\n \\"Key\\": \\"\\"\\n }\\n ],\\n \\"ContentColumns\\": [\\n {\\n \\"Key\\": \\"\\"\\n }\\n ],\\n \\"ColumnDefinitions\\": [\\n {\\n \\"Key\\": \\"\\"\\n }\\n ]\\n },\\n \\"IndexManifest\\": \\"\\"\\n }\\n ],\\n \\"MaxResults\\": 20,\\n \\"NextToken\\": \\"20\\",\\n \\"TotalCount\\": 51,\\n \\"RequestId\\": \\"35686626-8D83-5ADE-B400-08A6613A6057\\"\\n}","type":"json"}]', 'title' => 'ListKnowledgeBases', ], 'RetrieveKnowledgeBase' => [ 'summary' => 'Retrieve the knowledge base.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/action/retrieve', 'methods' => [ 'post', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'd-ksicx823d', ], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '174***', ], 'Query' => [ 'description' => '', 'type' => 'string', 'required' => true, ], 'TopK' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '5', ], 'ScoreThreshold' => [ 'description' => '', 'type' => 'number', 'format' => 'float', 'required' => false, ], 'MetaDataFilterConditions' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => '{'."\n" .' "FilterCondition": "and", '."\n" .' "MetaDataFilters": ['."\n" .' {'."\n" .' "Key": "key1", '."\n" .' "Value": "value1", '."\n" .' "Operator": "=="'."\n" .' },'."\n" .' {'."\n" .' "Key": "key2", '."\n" .' "Value": "value2", '."\n" .' "Operator": "!="'."\n" .' },'."\n" .' {'."\n" .' "Key": "file_name", '."\n" .' "Value": "prefix", '."\n" .' "Operator": "contains"'."\n" .' }'."\n" .' ]'."\n" .'}', ], 'QueryMode' => [ 'description' => '', 'type' => 'string', 'required' => false, 'enumValueTitles' => [ 'hybrid' => 'hybrid', 'dense' => 'dense', ], 'example' => 'dense', ], 'VersionName' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'v1', ], 'RerankConfig' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => '{'."\n" .' "ConnectionId":"conn-xxx",'."\n" .' "Model": "qwen-max",'."\n" .' "TopK": 5'."\n" .'}', ], 'RewriteConfig' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => '{'."\n" .' "ConnectionId":"conn-xxx",'."\n" .' "Model": "qwen-max",'."\n" .' "Temperature": 0.7,'."\n" .' "TopP": 0.9,'."\n" .' "PresencePenalty": 0.5,'."\n" .' "FrequencyPenalty": 0.5,'."\n" .' "Seed": 0,'."\n" .' "MaxTokens": 1024,'."\n" .' "Stop": [],'."\n" .' "EnableThinking": true'."\n" .'}', ], 'HybridStrategyConfig' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => '{'."\n" .' "Strategy": "rrf",'."\n" .' "RRFK":60,'."\n" .' "Weight": 0.5'."\n" .'}', ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'KnowledgeBaseFileChunks' => [ 'description' => '', 'type' => 'array', 'items' => [ '$ref' => '#/components/schemas/KnowledgeBaseFileChunk', ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"KnowledgeBaseFileChunks\\": [\\n {\\n \\"Score\\": 0,\\n \\"ChunkId\\": \\"\\",\\n \\"ChunkStart\\": 0,\\n \\"ChunkEnd\\": 0,\\n \\"ChunkSequence\\": 0,\\n \\"ChunkContent\\": \\"\\",\\n \\"ChunkSize\\": 0,\\n \\"ChunkStatus\\": \\"\\",\\n \\"DownloadUrl\\": \\"\\",\\n \\"ThumbnailUrl\\": \\"\\",\\n \\"ChunkAttachment\\": [\\n {\\n \\"PlaceholderId\\": \\"\\",\\n \\"Type\\": \\"\\",\\n \\"Uri\\": \\"\\",\\n \\"DownloadUrl\\": \\"\\"\\n }\\n ],\\n \\"MetaData\\": {\\n \\"FileName\\": \\"\\",\\n \\"FileUri\\": \\"\\",\\n \\"FileMetaId\\": \\"\\"\\n }\\n }\\n ]\\n}","type":"json"}]', 'title' => 'RetrieveKnowledgeBase', ], 'CreateKnowledgeBaseJob' => [ 'summary' => 'Create a Knowledge Base Task.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasejobs', 'methods' => [ 'post', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'write', 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'd-ksicx823d', ], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478**', ], 'Accessibility' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'PUBLIC', 'default' => 'PUBLIC', 'enum' => [ 'PUBLIC', 'PRIVATE', ], ], 'Description' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'This is a description of the knowledge base job.', ], 'JobAction' => [ 'description' => '', 'type' => 'string', 'required' => false, ], 'MaxRunningTimeInSeconds' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '86400', ], 'ResourceId' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'public-cluster', ], 'EcsSpecs' => [ 'description' => '', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '节点类型', 'description' => '节点类型', 'type' => 'string', 'required' => false, 'example' => 'Worker', 'readOnly' => true, 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '机型名称', 'description' => '机型名称', 'type' => 'string', 'required' => false, 'example' => 'ecs.c6.large', 'readOnly' => true, ], 'PodCount' => [ 'title' => '副本数量', 'description' => '副本数量', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'readOnly' => true, ], 'CPU' => [ 'title' => 'CPU核数', 'description' => 'CPU核数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2', 'readOnly' => true, ], 'GPU' => [ 'title' => 'GPU卡数', 'description' => 'GPU卡数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'readOnly' => true, ], 'Memory' => [ 'title' => '内存大小', 'description' => '内存大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '8', 'readOnly' => true, ], 'SharedMemory' => [ 'title' => '共享内存容量', 'description' => '共享内存容量', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'readOnly' => true, ], 'GPUType' => [ 'title' => 'GPU类型', 'description' => 'GPU类型', 'type' => 'string', 'required' => false, 'readOnly' => true, ], 'Driver' => [ 'title' => '驱动版本', 'description' => '驱动版本', 'type' => 'string', 'required' => false, 'example' => '535.161.08', 'readOnly' => true, ], ], 'required' => false, ], 'required' => false, ], 'UserVpc' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => 'VPC ID', 'description' => 'VPC ID。', 'type' => 'string', 'required' => false, 'readOnly' => true, ], 'VSwitchId' => [ 'title' => '交换机ID', 'description' => '交换机ID', 'type' => 'string', 'required' => false, 'readOnly' => true, ], 'SecurityGroupId' => [ 'title' => '安全组ID', 'description' => '安全组ID', 'type' => 'string', 'required' => false, 'readOnly' => true, ], ], 'required' => false, ], 'EmbeddingConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => 'Embedding分批大小', 'description' => 'Embedding分批大小', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '8', 'readOnly' => true, ], 'Concurrency' => [ 'title' => 'Embedding并发数', 'description' => 'Embedding并发数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '1', 'example' => '1', 'readOnly' => true, ], ], 'required' => false, ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'KnowledgeBaseJobId' => [ 'description' => '', 'type' => 'string', 'example' => 'kbjob-9mn******1z54', ], 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"KnowledgeBaseJobId\\": \\"kbjob-9mn******1z54\\",\\n \\"RequestId\\": \\"963BD7F9-0C02-5594-9550-BCC6DD43E3C0\\"\\n}","type":"json"}]', 'title' => 'CreateKnowledgeBaseJob', ], 'GetKnowledgeBaseJob' => [ 'summary' => '查看知识库任务', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasejobs/{KnowledgeBaseJobId}', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478***', ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-nacr******sxd2', ], ], [ 'name' => 'KnowledgeBaseJobId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'kbjob-9m******54', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => 'C25324E3-18E6-50D8-9026-16D74AAEEB26', 'title' => '请求ID', ], 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'example' => '478***', ], 'Accessibility' => [ 'description' => '', 'type' => 'string', 'example' => 'PUBLIC', ], 'Creator' => [ 'description' => '', 'type' => 'string', ], 'GmtCreateTime' => [ 'description' => '', 'type' => 'string', 'example' => '2025-09-24T07:33:53Z', ], 'GmtModifiedTime' => [ 'description' => '', 'type' => 'string', 'example' => '2025-06-11T08:58:35.438Z', ], 'KnowledgeBaseId' => [ 'description' => '', 'type' => 'string', 'example' => 'd-nacr******sxd2', ], 'KnowledgeBaseJobId' => [ 'description' => '', 'type' => 'string', 'example' => 'kbjob-9m******54', ], 'JobAction' => [ 'description' => '', 'type' => 'string', 'example' => 'UpdateScheduleConfig', ], 'Description' => [ 'description' => '', 'type' => 'string', 'example' => 'project name pass the check', ], 'Status' => [ 'description' => '', 'type' => 'string', 'example' => 'discovering', ], 'ResourceId' => [ 'description' => '', 'type' => 'string', ], 'EcsSpecs' => [ 'description' => '', 'type' => 'array', 'items' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'Type' => [ 'title' => '节点类型', 'description' => '节点类型', 'type' => 'string', 'example' => 'Worker', 'readOnly' => true, 'default' => 'Worker', ], 'InstanceType' => [ 'title' => '机型名称', 'description' => '机型名称', 'type' => 'string', 'example' => 'ecs.c6.large', 'readOnly' => true, ], 'PodCount' => [ 'title' => '副本数量', 'description' => '副本数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'readOnly' => true, ], 'CPU' => [ 'title' => 'CPU核数', 'description' => 'CPU核数', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], 'GPU' => [ 'title' => 'GPU卡数', 'description' => 'GPU卡数', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], 'Memory' => [ 'title' => '内存大小', 'description' => '内存大小', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], 'SharedMemory' => [ 'title' => '共享内存容量', 'description' => '共享内存容量', 'type' => 'integer', 'format' => 'int32', 'readOnly' => true, ], 'GPUType' => [ 'title' => 'GPU类型', 'description' => 'GPU类型', 'type' => 'string', 'readOnly' => true, ], 'Driver' => [ 'title' => '驱动版本', 'description' => '驱动版本', 'type' => 'string', 'example' => '535.161.08', 'readOnly' => true, ], ], ], ], 'UserVpc' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'VpcId' => [ 'title' => 'VPC ID', 'description' => 'VPC ID。', 'type' => 'string', ], 'VSwitchId' => [ 'title' => '交换机ID', 'description' => '交换机ID', 'type' => 'string', ], 'SecurityGroupId' => [ 'title' => '安全组ID', 'description' => '安全组ID', 'type' => 'string', ], ], ], 'MaxRunningTimeInSeconds' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'example' => '86400', ], 'GmtFinishTime' => [ 'description' => '', 'type' => 'string', 'example' => '2025-02-08T15:45:12Z', ], 'ErrorMessage' => [ 'description' => '', 'type' => 'string', ], 'PipelineRunInfo' => [ 'type' => 'object', 'properties' => [ 'PipelineRunId' => [ 'title' => 'PaiFlow工作流运行ID', 'description' => 'PaiFlow工作流运行ID', 'type' => 'string', 'example' => 'flow-fi8z******g4gy', 'readOnly' => true, ], ], ], 'KnowledgeBaseJobResult' => [ 'type' => 'object', 'properties' => [ 'TotalFileCount' => [ 'title' => '总处理文件数', 'description' => '总处理文件数', 'type' => 'integer', 'format' => 'int32', ], 'AddChunkCount' => [ 'title' => '增加Chunk数量', 'description' => '增加Chunk数量', 'type' => 'integer', 'format' => 'int32', ], 'DeleteChunkCount' => [ 'title' => '删除Chunk数量', 'description' => '删除Chunk数量', 'type' => 'integer', 'format' => 'int32', ], ], ], 'EmbeddingConfig' => [ 'description' => '', 'type' => 'object', 'properties' => [ 'BatchSize' => [ 'title' => 'Embedding分批大小', 'description' => 'Embedding分批大小', 'type' => 'integer', 'format' => 'int32', 'example' => '10', 'readOnly' => true, ], 'Concurrency' => [ 'title' => 'Embedding并发数', 'description' => 'Embedding并发数', 'type' => 'integer', 'format' => 'int32', 'maximum' => '200', 'minimum' => '1', 'example' => '2', 'readOnly' => true, ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C25324E3-18E6-50D8-9026-16D74AAEEB26\\",\\n \\"WorkspaceId\\": \\"478***\\",\\n \\"Accessibility\\": \\"PUBLIC\\",\\n \\"Creator\\": \\"2003******4844\\",\\n \\"GmtCreateTime\\": \\"2025-09-24T07:33:53Z\\",\\n \\"GmtModifiedTime\\": \\"2025-09-24T08:58:35Z\\",\\n \\"KnowledgeBaseId\\": \\"d-nacr******sxd2\\",\\n \\"KnowledgeBaseJobId\\": \\"kbjob-9m******54\\",\\n \\"JobAction\\": \\"UpdateScheduleConfig\\",\\n \\"Description\\": \\"This is a description of the knowledge base job.\\",\\n \\"Status\\": \\"discovering\\",\\n \\"ResourceId\\": \\"quota89**76\\",\\n \\"EcsSpecs\\": [\\n {\\n \\"Type\\": \\"Worker\\",\\n \\"InstanceType\\": \\"ecs.c6.large\\",\\n \\"PodCount\\": 1,\\n \\"CPU\\": 4,\\n \\"GPU\\": 1,\\n \\"Memory\\": 16,\\n \\"SharedMemory\\": 16,\\n \\"GPUType\\": \\"V100\\",\\n \\"Driver\\": \\"550.127.08\\"\\n }\\n ],\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"vpc-wz90****5v23\\",\\n \\"VSwitchId\\": \\"vsw-wz9r****ng10\\",\\n \\"SecurityGroupId\\": \\"sg-wz91****e10e\\"\\n },\\n \\"MaxRunningTimeInSeconds\\": 86400,\\n \\"GmtFinishTime\\": \\"2025-02-08T15:45:12Z\\",\\n \\"ErrorMessage\\": \\"Failed to update knwoledge base index, pipelineRunId: flow-9p8f****4t9z\\",\\n \\"PipelineRunInfo\\": {\\n \\"PipelineRunId\\": \\"flow-fi8z******g4gy\\"\\n },\\n \\"KnowledgeBaseJobResult\\": {\\n \\"TotalFileCount\\": 1,\\n \\"AddChunkCount\\": 10,\\n \\"DeleteChunkCount\\": 2\\n },\\n \\"EmbeddingConfig\\": {\\n \\"BatchSize\\": 10,\\n \\"Concurrency\\": 2\\n }\\n}","type":"json"}]', ], 'UpdateKnowledgeBaseJob' => [ 'summary' => 'Update Knowledge Base Task.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasejobs/{KnowledgeBaseJobId}', 'methods' => [ 'put', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-nacr******sxd2', ], ], [ 'name' => 'KnowledgeBaseJobId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'kbjob-9m******54', ], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'type' => 'object', 'properties' => [ 'WorkspaceId' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '285***', ], 'Description' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'This is a description of the knowledge base job.', ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '35686626-8D83-5ADE-B400-08A6613A6057', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"35686626-8D83-5ADE-B400-08A6613A6057\\"\\n}","type":"json"}]', 'title' => 'UpdateKnowledgeBaseJob', ], 'DeleteKnowledgeBaseJob' => [ 'summary' => 'Delete Knowledge Base Task.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasejobs/{KnowledgeBaseJobId}', 'methods' => [ 'delete', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'write', 'systemTags' => [ 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => '478***', ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-nacr******sxd2', ], ], [ 'name' => 'KnowledgeBaseJobId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'kbjob-9m******54', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '48E6392E-C3C9-5212-9FAD-13256ABD9AF6', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"48E6392E-C3C9-5212-9FAD-13256ABD9AF6\\"\\n}","type":"json"}]', 'title' => 'DeleteKnowledgeBaseJob', ], 'ListKnowledgeBaseJobs' => [ 'summary' => 'Get the Knowledge Base task list.', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasejobs', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'WorkspaceId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => '478**', ], ], [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'd-ksicx823d', ], ], [ 'name' => 'KnowledgeBaseJobId', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'kbjob-9m******54', ], ], [ 'name' => 'Status', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'JobAction', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'SyncIndex', ], ], [ 'name' => 'NextToken', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, ], ], [ 'name' => 'MaxResults', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10', ], ], [ 'name' => 'SortBy', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'GmtCreateTime', ], ], [ 'name' => 'Order', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'DESC', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'KnowledgeBaseJobs' => [ 'description' => '', 'type' => 'array', 'items' => [ '$ref' => '#/components/schemas/KnowledgeBaseJob', ], ], 'MaxResults' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'title' => '请求最大返回结果数', 'example' => '10', ], 'NextToken' => [ 'description' => '', 'type' => 'string', 'title' => '下次请求令牌', 'example' => '11', ], 'TotalCount' => [ 'description' => '', 'type' => 'integer', 'format' => 'int32', 'title' => '总量', 'example' => '25', ], 'RequestId' => [ 'description' => '', 'type' => 'string', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', 'title' => '请求ID', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"KnowledgeBaseJobs\\": [\\n {\\n \\"WorkspaceId\\": \\"\\",\\n \\"Accessibility\\": \\"\\",\\n \\"Creator\\": \\"\\",\\n \\"GmtCreateTime\\": \\"\\",\\n \\"GmtModifiedTime\\": \\"\\",\\n \\"KnowledgeBaseId\\": \\"\\",\\n \\"KnowledgeBaseJobId\\": \\"\\",\\n \\"JobAction\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"Status\\": \\"\\",\\n \\"ResourceId\\": \\"\\",\\n \\"EcsSpecs\\": [\\n {\\n \\"Type\\": \\"\\",\\n \\"InstanceType\\": \\"\\",\\n \\"PodCount\\": 0,\\n \\"CPU\\": 0,\\n \\"GPU\\": 0,\\n \\"Memory\\": 0,\\n \\"SharedMemory\\": 0,\\n \\"GPUType\\": \\"\\",\\n \\"Driver\\": \\"\\"\\n }\\n ],\\n \\"UserVpc\\": {\\n \\"VpcId\\": \\"\\",\\n \\"VSwitchId\\": \\"\\",\\n \\"SecurityGroupId\\": \\"\\"\\n },\\n \\"MaxRunningTimeInSeconds\\": 0,\\n \\"GmtFinishTime\\": \\"\\",\\n \\"ErrorMessage\\": \\"\\",\\n \\"PipelineRunInfo\\": {\\n \\"PipelineRunId\\": \\"\\"\\n },\\n \\"KnowledgeBaseJobResult\\": {\\n \\"TotalFileCount\\": 0,\\n \\"AddChunkCount\\": 0,\\n \\"DeleteChunkCount\\": 0,\\n \\"FileMetas\\": [\\n {\\n \\"FileMetaId\\": \\"\\",\\n \\"FileName\\": \\"\\",\\n \\"FileUri\\": \\"\\",\\n \\"Action\\": \\"\\"\\n }\\n ]\\n },\\n \\"EmbeddingConfig\\": {\\n \\"BatchSize\\": 0,\\n \\"Concurrency\\": 0\\n }\\n }\\n ],\\n \\"MaxResults\\": 20,\\n \\"NextToken\\": \\"20\\",\\n \\"TotalCount\\": 32,\\n \\"RequestId\\": \\"963BD7F9-0C02-5594-9550-BCC6DD43E3C0\\"\\n}","type":"json"}]', 'title' => 'ListKnowledgeBaseJobs', ], 'UpdateKnowledgeBaseChunk' => [ 'summary' => '更新知识库切片', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasechunks/{KnowledgeBaseChunkId}', 'methods' => [ 'put', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'title' => '知识库ID', 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-ab****89', ], ], [ 'name' => 'KnowledgeBaseChunkId', 'in' => 'path', 'schema' => [ 'title' => '切片ID', 'description' => '', 'type' => 'string', 'required' => true, 'example' => '123e4567-e89b-12d3-a456-426655440000', ], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ 'title' => '请求体', 'description' => '', 'type' => 'object', 'properties' => [ 'ChunkStatus' => [ 'title' => '切片状态', 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'Enable', ], 'ChunkContent' => [ 'title' => '切片内容', 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'content', ], ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => '请求ID', 'description' => '', 'type' => 'string', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"963BD7F9-0C02-5594-9550-BCC6DD43E3C0\\"\\n}","type":"json"}]', ], 'ListKnowledgeBaseChunks' => [ 'summary' => '获取知识库切片列表', 'path' => '/api/v1/langstudio/knowledgebases/{KnowledgeBaseId}/knowledgebasechunks', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'consumes' => [ 'application/json', ], 'produces' => [ 'application/json', ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATURElearnBVWJJN', ], ], 'parameters' => [ [ 'name' => 'KnowledgeBaseId', 'in' => 'path', 'schema' => [ 'title' => '知识库ID', 'description' => '', 'type' => 'string', 'required' => true, 'example' => 'd-ab****89', ], ], [ 'name' => 'VersionName', 'in' => 'query', 'schema' => [ 'title' => '知识库版本', 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'v1', ], ], [ 'name' => 'MetaData', 'in' => 'query', 'schema' => [ 'title' => '原始文件信息', 'description' => '', 'type' => 'object', 'properties' => [ 'FileUri' => [ 'title' => '文件地址', 'description' => '文件地址', 'type' => 'string', 'required' => false, 'example' => 'oss://mybucketpath/file1.txt', 'readOnly' => true, ], 'FileMetaId' => [ 'title' => '文件元数据ID', 'description' => '文件元数据ID', 'type' => 'string', 'required' => false, 'example' => 'xd8e****79du', 'readOnly' => true, ], ], 'required' => false, 'example' => '1', ], ], [ 'name' => 'ChunkStatus', 'in' => 'query', 'schema' => [ 'title' => '切片状态', 'description' => '', 'type' => 'string', 'required' => false, 'example' => 'Enable', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'title' => '当前页数', 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'title' => '每页查询数量', 'description' => '', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'KnowledgeBaseChunks' => [ 'title' => '切片列表', 'description' => '切片列表', 'type' => 'array', 'items' => [ 'title' => '切片', 'description' => '切片', 'type' => 'object', 'properties' => [ 'KnowledgeBaseChunkId' => [ 'title' => '切片ID', 'description' => '切片ID', 'type' => 'string', 'example' => '123e4567-e89b-12d3-a456-426655440000', ], 'KnowledgeBaseId' => [ 'title' => '知识库ID', 'description' => '知识库ID', 'type' => 'string', 'example' => 'd-ix****o9', ], 'VersionName' => [ 'title' => '知识库版本', 'description' => '知识库版本', 'type' => 'string', 'example' => 'v1', ], 'ChunkStart' => [ 'title' => '切片起始位置', 'description' => '切片起始位置', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'ChunkEnd' => [ 'title' => '切片结束位置', 'description' => '切片结束位置', 'type' => 'integer', 'format' => 'int32', 'example' => '30000', ], 'ChunkSequence' => [ 'title' => '切片顺序', 'description' => '切片顺序', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'ChunkContent' => [ 'title' => '切片内容', 'description' => '切片内容', 'type' => 'string', 'example' => 'content', ], 'ChunkSize' => [ 'title' => '切片大小', 'description' => '切片大小', 'type' => 'integer', 'format' => 'int32', 'example' => '1873', ], 'ChunkStatus' => [ 'title' => '切片状态', 'description' => '切片状态', 'type' => 'string', 'example' => 'Enable', ], 'DownloadUrl' => [ 'title' => '切片下载地址', 'description' => '切片下载地址', 'type' => 'string', 'example' => 'https://mybucket.oss-cn-shanghai.aliyuncs.com/...', ], 'ThumbnailUrl' => [ 'title' => '切片缩略图', 'description' => '切片缩略图', 'type' => 'string', 'example' => 'https://mybucket.oss-cn-shanghai.aliyuncs.com/...', ], 'ChunkAttachment' => [ 'title' => '切片附属信息', 'description' => '切片附属信息', 'type' => 'array', 'items' => [ 'title' => '切片附件', 'description' => '切片附件', 'type' => 'object', 'properties' => [ 'PlaceholderId' => [ 'title' => '占位符ID', 'description' => '占位符ID', 'type' => 'string', 'example' => 'IMAGE_PLACEHOLDER_0', 'readOnly' => true, ], 'Type' => [ 'title' => '类型', 'description' => '类型', 'type' => 'string', 'example' => 'image', 'readOnly' => true, ], 'Uri' => [ 'title' => '路径', 'description' => '路径', 'type' => 'string', 'example' => 'oss://mybucket/path/file.txt', 'readOnly' => true, ], 'DownloadUrl' => [ 'title' => '下载地址', 'description' => '下载地址', 'type' => 'string', 'example' => 'https://mybucket.oss-cn-shanghai.aliyuncs.com/...', 'readOnly' => true, ], ], 'example' => '', ], 'example' => '', ], 'MetaData' => [ 'title' => '原始文件信息', 'description' => '原始文件信息', 'type' => 'object', 'properties' => [ 'FileName' => [ 'title' => '文件名', 'description' => '文件名', 'type' => 'string', 'example' => 'file1.txt', 'readOnly' => true, ], 'FileUri' => [ 'title' => '文件地址', 'description' => '文件地址', 'type' => 'string', 'example' => 'oss://mybucketpath/file1.txt', 'readOnly' => true, ], 'FileMetaId' => [ 'title' => '文件元数据ID', 'description' => '文件元数据ID', 'type' => 'string', 'example' => 'xd8e****79du', 'readOnly' => true, ], ], 'example' => '', ], ], 'example' => '', ], 'example' => '', ], 'MaxResults' => [ 'title' => '请求最大返回结果数', 'description' => '', 'type' => 'integer', 'format' => 'int32', 'example' => '10', ], 'TotalCount' => [ 'title' => '总量', 'description' => '', 'type' => 'integer', 'format' => 'int32', 'example' => '25', ], 'RequestId' => [ 'title' => '请求ID', 'description' => '', 'type' => 'string', 'example' => '963BD7F9-0C02-5594-9550-BCC6DD43E3C0', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"KnowledgeBaseChunks\\": [\\n {\\n \\"KnowledgeBaseChunkId\\": \\"123e4567-e89b-12d3-a456-426655440000\\",\\n \\"KnowledgeBaseId\\": \\"d-ix****o9\\",\\n \\"VersionName\\": \\"v1\\",\\n \\"ChunkStart\\": 0,\\n \\"ChunkEnd\\": 30000,\\n \\"ChunkSequence\\": 1,\\n \\"ChunkContent\\": \\"content\\",\\n \\"ChunkSize\\": 1873,\\n \\"ChunkStatus\\": \\"Enable\\",\\n \\"DownloadUrl\\": \\"https://mybucket.oss-cn-shanghai.aliyuncs.com/...\\",\\n \\"ThumbnailUrl\\": \\"https://mybucket.oss-cn-shanghai.aliyuncs.com/...\\",\\n \\"ChunkAttachment\\": [\\n {\\n \\"PlaceholderId\\": \\"IMAGE_PLACEHOLDER_0\\",\\n \\"Type\\": \\"image\\",\\n \\"Uri\\": \\"oss://mybucket/path/file.txt\\",\\n \\"DownloadUrl\\": \\"https://mybucket.oss-cn-shanghai.aliyuncs.com/...\\"\\n }\\n ],\\n \\"MetaData\\": {\\n \\"FileName\\": \\"file1.txt\\",\\n \\"FileUri\\": \\"oss://mybucketpath/file1.txt\\",\\n \\"FileMetaId\\": \\"xd8e****79du\\"\\n }\\n }\\n ],\\n \\"MaxResults\\": 10,\\n \\"TotalCount\\": 25,\\n \\"RequestId\\": \\"963BD7F9-0C02-5594-9550-BCC6DD43E3C0\\"\\n}","type":"json"}]', ], ], 'endpoints' => [ [ 'regionId' => 'eu-central-1', 'endpoint' => 'pailangstudio.eu-central-1.aliyuncs.com', ], [ 'regionId' => 'cn-beijing', 'endpoint' => 'pailangstudio.cn-beijing.aliyuncs.com', ], [ 'regionId' => 'cn-wulanchabu', 'endpoint' => 'pailangstudio.cn-wulanchabu.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou', 'endpoint' => 'pailangstudio.cn-hangzhou.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai', 'endpoint' => 'pailangstudio.cn-shanghai.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen', 'endpoint' => 'pailangstudio.cn-shenzhen.aliyuncs.com', ], [ 'regionId' => 'cn-hongkong', 'endpoint' => 'pailangstudio.cn-hongkong.aliyuncs.com', ], [ 'regionId' => 'ap-northeast-1', 'endpoint' => 'pailangstudio.ap-northeast-1.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-1', 'endpoint' => 'pailangstudio.ap-southeast-1.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-5', 'endpoint' => 'pailangstudio.ap-southeast-5.aliyuncs.com', ], [ 'regionId' => 'us-east-1', 'endpoint' => 'pailangstudio.us-east-1.aliyuncs.com', ], ], ];