Agent建设助手

数据源管理

创建数据源

1.进入目标工作空间,在知识库内,选择数据源进入后,点击创建数据源

2.填写数据源的表单

3.创建完成后,可以在数据源管理的页面列表中,看到该数据源

API接口类型配置

1.填写基本信息:填写数据源基本信息,并选择类型为API 接口

2.API接口参数配置:填写数据源API接口参数配置

3.API接口认证配置:填写数据源API接口分页配置

无认证类型:不需要认证

Basic类型:输入用户名和密码,需通过填写的用户名和密码才能认证访问

OAuth类型:输入用户名和密码,需通过填写的用户名和密码才能认证访问

配置项

说明

ClientID

•必填

•智能体在OAuth 提供者注册时获取的唯一标识

ClientSecret

•必填

•与ClientID 配对的密码,用于认证智能体并获取令牌

TokenURL

•非必填

•智能体的回调URL,授权码将发送到此 URL

Scope

•必填

•你的智能体希望访问的资源的范围或级别,可添加多行

EndpointParams

•非必填

•指定对令牌端点的请求的附加参数,可添加多行键名-值

○键名:必填,可填写令牌端点的请求的附加参数键名

○值:非必填,可填写键名对应的值

APIKey类型:需填写参数位置(包含请求头和请求Query)、参数名和参数值

4.API接口分页配置:填写数据源API接口分页配置

配置项

说明

每页结果数字段

•非必填

•下拉框,可在请求体里选择每页结果数字段,如:PageSize

•填写请求体后才能设置该参数

当前页码字段

•非必填

•下拉框,可在请求体里选择当前页码字段,如:PageNumber

•填写请求体后才能设置该参数

总页码字段

•非必填

•下拉框,可在请求体返回值里选择当前页码字段,如:PageTotal

•设置好接口参数,然后在API 接口调用测试里发起请求,成功后通过解析接口的返回值来设置该字段

5.API接口调用调试:测试API接口调用,点击测试后,可测试当前的API接口测试结果并展示返回值

6.提交表单:表单填写完成后,点击确定,即可完成数据源的创建

使用数据源

标准类型知识库使用数据源

1.在目标工作空间内,选择知识库,进入目标知识库文件列表详情页

2.导入文件时,选择JSON文件类型,再选择文件来源为API接口

3.可引用数据源信息

配置完成后,即可在知识库详情页的命中测试中测试是否命中数据源分段数据信息

API接口类型知识库使用数据源

1.在目标工作空间内,选择知识库,点击创建知识库

2.选择API接口类型,可引用数据源信息

配置项

说明

API接口参数设置

•当类型选择为API接口类型时,有该配置项

数据源

•必填

•可添加当前空间内已创建完成的数据源,不同的数据源会导致内部参数名不同

请求体参数映射

•必填

•调用API 接口时携带参数处理,内部参数为平台接口参数字段,外部参数为目标 API 接口参数字段

•可添加多个请求体参数映射

内部参数名

•必填

•可选项包含:必填Query、TopK、Score(不同的数据源会导致内部参数名不同)

•每个参数仅可选择一个,不允许重复

外部参数名

•必填

•可填写外部参数名

返回值参数映射

•调用API 接口后返回值处理,内部参数为平台接口返回值字段,外部参数为目标 API 接口返回值字段

•可添加多个返回值参数映射

内部参数名

•必填

•可选项包含:必填Content、Score(不同的数据源会导致内部参数名不同)

•每个参数仅可选择一个,不允许重复

外部参数名

•必填

•可填写外部参数名

配置完成后,即可在知识库详情页的命中测试中测试是否命中数据源分段数据信息