API概览

本产品(大模型服务平台百炼/2023-12-29)的OpenAPI采用ROA签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(78410016550),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

应用数据

API标题API概述
ListFile文件列表获取指定类目下一个或多个文档的详细信息。
DeleteCategory删除类目永久性删除指定的类目。
ListCategory类目列表获取指定业务空间下一个或多个类目的详细信息。
AddCategory新增类目在指定的业务空间中创建一个类目,用于分类和管理文件。每个业务空间最多创建500个类目。
AddFile添加文件将存储于阿里云百炼临时存储空间内的文件导入至阿里云百炼应用数据。
AddFilesFromAuthorizedOss从已授权OSS Bucket中导入文件将已授权OSS Bucket中的文件导入阿里云百炼应用数据中。
ApplyFileUploadLease申请文件上传租约请求一个上传租约用于上传知识库文件,或智能体应用会话交互的文件。
DeleteFile删除文件永久删除应用数据中的指定文件。不支持通过API删除数据表,详见下方接口说明。
DescribeFile查询文件状态查询应用数据中文件的基本信息,包括文件名称、类型、状态等。
UpdateFileTag更新文件标签更新指定文件标签。
GetParseSettings获取类目解析设置查询指定类目的数据解析设置。
GetAvailableParserTypes获取文件支持的解析器类型根据输入的文件类型(文件扩展名),获取所有支持的解析器类型列表。
ChangeParseSetting修改类目解析设置配置特定文件类型的解析方式。例如,为 .pdf 文件指定使用大模型文档解析,为 .jpg 文件指定使用Qwen VL解析。

知识库

API标题API概述
CreateIndex创建知识库创建一个文档搜索类知识库。
GetIndexJobStatus查询知识库创建任务状态查询指定的知识库创建任务或知识库追加任务的当前状态。
SubmitIndexJob提交知识库创建任务提交指定的 CreateIndex 任务以完成知识库创建。
SubmitIndexAddDocumentsJob提交知识库追加任务向指定知识库中追加导入已解析的文件。
Retrieve检索知识库在指定的知识库中检索信息。
ListIndexDocuments查询知识库下的文档列表获取指定知识库中的文件,以及它们的概要信息。
ListIndexFileDetails查询知识库下的文档详情获取指定知识库中的文件,以及它们的详细信息。
DeleteIndexDocument删除知识库下的文档永久删除指定知识库中的文件。
ListIndices查询知识库列表获取指定业务空间下知识库列表。
DeleteIndex删除知识库永久性删除指定的知识库。
ListChunks查询索引下的分片列表查看文本切片列表及信息。
UpdateChunk修改切片修改知识库中指定文本切片的内容(content)和标题(title),并设置是否参与知识库检索。
DeleteChunk删除切片删除知识库中的指定文本切片,被删的文本切片将无法被检索和召回。

Prompt工程

API标题API概述
CreatePromptTemplate创建Prompt模板创建Prompt模板。
GetPromptTemplate获取Prompt模板基于模板Id获取Prompt模板。
UpdatePromptTemplate更新Prompt模板基于模板Id增量更新Prompt模板。
DeletePromptTemplate删除Prompt模板基于模板Id删除Prompt模板。
ListPromptTemplates获取Prompt模板列表获取Prompt模板列表。
ListPromptTemplates获取Prompt模板列表获取Prompt模板列表。

长期记忆

API标题API概述
CreateMemory创建长期记忆体创建一个长期记忆体。
GetMemory获取长期记忆体获取指定长期记忆体的描述信息。
UpdateMemory更新长期记忆体更新指定长期记忆体的描述信息。
DeleteMemory删除长期记忆体永久性删除指定的长期记忆体。
ListMemories获取长期记忆体列表获取指定业务空间下一个或多个长期记忆体的详细信息。
CreateMemoryNode创建记忆片段创建记忆片段。
GetMemoryNode获取记忆片段获取记忆片段。
UpdateMemoryNode更新记忆片段更新记忆片段。
DeleteMemoryNode删除记忆片段删除记忆片段。
ListMemoryNodes获取记忆片段列表获取记忆片段列表。