chore: replace all cn comments to en version by volc api (#313)

This commit is contained in:
tecvan
2025-07-31 15:18:11 +08:00
committed by GitHub
parent 91d6cdb430
commit 5abc63fba6
254 changed files with 5899 additions and 5844 deletions

View File

@@ -6,59 +6,59 @@ namespace go ocean.cloud.plugin_develop
service PluginDevelopService {
GetOAuthSchemaResponse GetOAuthSchema(1: GetOAuthSchemaRequest request)(api.post='/api/plugin/get_oauth_schema', api.category="plugin", api.gen_path="plugin")
GetOAuthSchemaResponse GetOAuthSchemaAPI(1: GetOAuthSchemaRequest request)(api.post='/api/plugin_api/get_oauth_schema', api.category="plugin", api.gen_path='plugin')
// 获取已发布 workflowplugin 列表,或者多个插件的详情
// Get a list of published workflows, plugins, or details of multiple plugins
GetPlaygroundPluginListResponse GetPlaygroundPluginList(1: GetPlaygroundPluginListRequest request) (api.post = '/api/plugin_api/get_playground_plugin_list', api.category = "plugin")
// 通过 code 创建插件
// Creating plugins with code
RegisterPluginResponse RegisterPlugin(1: RegisterPluginRequest request)(api.post='/api/plugin_api/register', api.category="plugin", api.gen_path="plugin", agw.preserve_base="true")
// 通过 UI 创建插件
// Create plugins through UI
RegisterPluginMetaResponse RegisterPluginMeta(1: RegisterPluginMetaRequest request) (api.post = '/api/plugin_api/register_plugin_meta', api.category = "plugin")
// 获取插件工具列表,或者多个工具详情
// Get a list of plug-in tools, or multiple tool details
GetPluginAPIsResponse GetPluginAPIs(1: GetPluginAPIsRequest request) (api.post = '/api/plugin_api/get_plugin_apis', api.category = "plugin")
// 获取插件详情
// Get plugin details
GetPluginInfoResponse GetPluginInfo(1: GetPluginInfoRequest request) (api.post = '/api/plugin_api/get_plugin_info', api.category = "plugin")
// 与最近一次发布版本相比,更新的工具列表
// Updated list of tools compared to the most recent release
GetUpdatedAPIsResponse GetUpdatedAPIs(1: GetUpdatedAPIsRequest request) (api.post = '/api/plugin_api/get_updated_apis', api.category = "plugin")
GetOAuthStatusResponse GetOAuthStatus(1: GetOAuthStatusRequest request)(api.post='/api/plugin_api/get_oauth_status', api.category="plugin", api.gen_path="plugin")
CheckAndLockPluginEditResponse CheckAndLockPluginEdit(1: CheckAndLockPluginEditRequest request)(api.post='/api/plugin_api/check_and_lock_plugin_edit', api.category="plugin", api.gen_path="plugin", )
UnlockPluginEditResponse UnlockPluginEdit(1: UnlockPluginEditRequest request)(api.post='/api/plugin_api/unlock_plugin_edit', api.category="plugin", api.gen_path="plugin")
// 通过 code 更新插件
// Update plugins via code
UpdatePluginResponse UpdatePlugin(1: UpdatePluginRequest request) (api.post = '/api/plugin_api/update', api.category = "plugin")
// 删除工具
// removal tool
DeleteAPIResponse DeleteAPI(1: DeleteAPIRequest request) (api.post = '/api/plugin_api/delete_api', api.category = "plugin", api.gen_path = 'plugin')
// 删除插件
// Remove plugin
DelPluginResponse DelPlugin(1: DelPluginRequest request) (api.post = '/api/plugin_api/del_plugin', api.category = "plugin", api.gen_path = 'plugin')
// 发布插件
// publishing plugin
PublishPluginResponse PublishPlugin(1: PublishPluginRequest request) (api.post = '/api/plugin_api/publish_plugin', api.category = "plugin")
// 通过UI更新插件
// Update plugins via UI
UpdatePluginMetaResponse UpdatePluginMeta(1: UpdatePluginMetaRequest request) (api.post = '/api/plugin_api/update_plugin_meta', api.category = "plugin")
GetBotDefaultParamsResponse GetBotDefaultParams(1: GetBotDefaultParamsRequest request) (api.post = '/api/plugin_api/get_bot_default_params', api.category = "plugin")
UpdateBotDefaultParamsResponse UpdateBotDefaultParams(1: UpdateBotDefaultParamsRequest request) (api.post = '/api/plugin_api/update_bot_default_params', api.category = "plugin")
// 创建工具
// creation tool
CreateAPIResponse CreateAPI(1: CreateAPIRequest request) (api.post = '/api/plugin_api/create_api', api.category = "plugin", api.gen_path = 'plugin')
// 更新工具
// update tool
UpdateAPIResponse UpdateAPI(1: UpdateAPIRequest request) (api.post = '/api/plugin_api/update_api', api.category = "plugin", api.gen_path = 'plugin')
GetUserAuthorityResponse GetUserAuthority(1: GetUserAuthorityRequest request)(api.post='/api/plugin_api/get_user_authority', api.category="plugin", api.gen_path="plugin")
DebugAPIResponse DebugAPI(1: DebugAPIRequest request)(api.post='/api/plugin_api/debug_api', api.category="plugin", api.gen_path='plugin')
GetPluginNextVersionResponse GetPluginNextVersion(1: GetPluginNextVersionRequest request)(api.post='/api/plugin_api/get_plugin_next_version', api.category="plugin", api.gen_path='plugin')
GetDevPluginListResponse GetDevPluginList(1: GetDevPluginListRequest request)(api.post='/api/plugin_api/get_dev_plugin_list', api.category="plugin", api.gen_path='plugin', agw.preserve_base="true")
// 协议转换,如将 curl 、postman collection 协议转换为 openapi3 协议
// Protocol conversion, such as converting curl and mail carrier collection protocols to openapi3 protocols
Convert2OpenAPIResponse Convert2OpenAPI(1: Convert2OpenAPIRequest request)(api.post='/api/plugin_api/convert_to_openapi', api.category="plugin", api.gen_path="plugin", agw.preserve_base="true")
// 批量创建工具,目前是配合 Convert2OpenAPI 接口使用
// Batch creation tool, currently used with the Convert2 OpenAPI interface
BatchCreateAPIResponse BatchCreateAPI(1: BatchCreateAPIRequest request)(api.post='/api/plugin_api/batch_create_api', api.category="plugin", api.gen_path="plugin", agw.preserve_base="true")
RevokeAuthTokenResponse RevokeAuthToken(1: RevokeAuthTokenRequest request)(api.post='/api/plugin_api/revoke_auth_token', api.category="plugin", api.gen_path="plugin", agw.preserve_base="true")
GetQueriedOAuthPluginListResponse GetQueriedOAuthPluginList(1: GetQueriedOAuthPluginListRequest request)(api.post='/api/plugin_api/get_queried_oauth_plugins', api.category="plugin", api.gen_path="plugin", agw.preserve_base="true")
}
struct GetPlaygroundPluginListRequest {
1: optional i32 page (api.body = "page") // 页码
2: optional i32 size (api.body = "size") // 每页大小
1: optional i32 page (api.body = "page") // page number
2: optional i32 size (api.body = "size") // page size
4: optional string name (api.body = "name") // ignore
5: optional i64 space_id (api.body = "space_id" api.js_conv = "str") // 空间id
6: list<string> plugin_ids (api.body = "plugin_ids") // 如果存在则根据插件id查询无分页逻辑
7: list<i32> plugin_types (api.body = "plugin_types") // 长度为1 且为workflow时返回已发布的workflow列表默认返回已发布的plugin列表
5: optional i64 space_id (api.body = "space_id" api.js_conv = "str") // Space ID
6: list<string> plugin_ids (api.body = "plugin_ids") // If present, query according to plug-in id, no paging logic
7: list<i32> plugin_types (api.body = "plugin_types") // When the length is 1 and it is a workflow, return the list of published workflows, and return the list of published plugins by default
8: optional i32 channel_id (api.body = "channel_id") // ignore
9: optional bool self_created (api.body = "self_created") // ignore
10: optional i32 order_by (api.body = "order_by") // 排序
10: optional i32 order_by (api.body = "order_by") // sort
11: optional bool is_get_offline (api.body = "is_get_offline") // ignore
99: string referer (api.header = "Referer") // ignore
255: optional base.Base Base
@@ -72,10 +72,10 @@ struct GetPlaygroundPluginListResponse {
}
struct GetPluginAPIsRequest {
1 : required i64 plugin_id (api.js_conv = "str"), // 插件id
2 : list<string> api_ids , // 如果存在则根据工具id查询无分页逻辑
3 : i32 page , // 页码
4 : i32 size , // 每页大小
1 : required i64 plugin_id (api.js_conv = "str"), // Plugin ID
2 : list<string> api_ids , // If present, query according to tool id, no paging logic
3 : i32 page , // page number
4 : i32 size , // page size
5 : plugin_develop_common.APIListOrder order , // ignore
6 : optional string preview_version_ts, // ignore
255: optional base.Base Base ,
@@ -91,21 +91,21 @@ struct GetPluginAPIsResponse {
}
struct GetUpdatedAPIsRequest {
1 : required i64 plugin_id (api.js_conv = "str"), // 插件id
1 : required i64 plugin_id (api.js_conv = "str"), // Plugin ID
255: optional base.Base Base ,
}
struct GetUpdatedAPIsResponse {
1 : i64 code ,
2 : string msg ,
3 : list<string> created_api_names, // 新创建的工具名
4 : list<string> deleted_api_names, // 被删除的工具名
5 : list<string> updated_api_names, // 被更新的工具名
3 : list<string> created_api_names, // Newly created tool name
4 : list<string> deleted_api_names, // Deleted tool name
5 : list<string> updated_api_names, // updated tool name
255: optional base.BaseResp BaseResp ,
}
struct GetPluginInfoRequest {
1 : required i64 plugin_id (api.js_conv = "str"), // 目前只支持插件openapi插件的信息
1 : required i64 plugin_id (api.js_conv = "str"), // Currently only plugins are supported OpenAPI plugin information
2 : optional string preview_version_tsx // ignore
255: optional base.Base Base ,
}
@@ -115,9 +115,9 @@ struct GetPluginInfoResponse {
2 : string msg ,
3 : plugin_develop_common.PluginMetaInfo meta_info ,
4 : plugin_develop_common.CodeInfo code_info ,
5 : bool status , // 0 无更新 1 有更新未发布
6 : bool published , // 是否已发布
7 : plugin_develop_common.Creator creator , // 创建人信息
5 : bool status , // 0 No updates 1 Yes updates Not released
6 : bool published , // Has it been published?
7 : plugin_develop_common.Creator creator , // creator information
8 : plugin_develop_common.PluginStatisticData statistic_data , // ignore
9 : plugin_develop_common.ProductStatus plugin_product_status, // ignore
10 : bool privacy_status , // ignore
@@ -150,22 +150,22 @@ struct UpdatePluginResponse {
}
struct RegisterPluginMetaRequest {
1 : required string name , // 插件名
2 : required string desc , // 插件描述
3 : optional string url , // 插件服务地址前缀
4 : required plugin_develop_common.PluginIcon icon , // 插件图标
5 : optional plugin_develop_common.AuthorizationType auth_type , // 插件授权类型
6 : optional plugin_develop_common.AuthorizationServiceLocation location , // 子授权类型为api/token时token参数位置
7 : optional string key , // 子授权类型为api/token时token参数key
8 : optional string service_token , // 子授权类型为api/token时token参数value
9 : optional string oauth_info , // 授权类型为oauth是oauth信息GetOAuthSchema返回值
10 : required i64 space_id (api.js_conv = "str") , // 空间id
11 : optional map<plugin_develop_common.ParameterLocation,list<plugin_develop_common.commonParamSchema>> common_params , // 插件公共参数key为参数位置value为参数列表
1 : required string name , // plugin name
2 : required string desc , // Plugin description
3 : optional string url , // Plugin service address prefix
4 : required plugin_develop_common.PluginIcon icon , // plugin icon
5 : optional plugin_develop_common.AuthorizationType auth_type , // plug-in authorization type
6 : optional plugin_develop_common.AuthorizationServiceLocation location , // When the sub-authorization type is api/token, the token parameter position
7 : optional string key , // When the sub-authorization type is api/token, the token parameter key
8 : optional string service_token , // When the sub-authorization type is api/token, the token parameter value
9 : optional string oauth_info , // The authorization type is oauth Yes, oauth information, see GetOAuthSchema return value
10 : required i64 space_id (api.js_conv = "str") , // Space ID
11 : optional map<plugin_develop_common.ParameterLocation,list<plugin_develop_common.commonParamSchema>> common_params , // Plugin public parameters, key is the parameter position, value is the parameter list
12 : optional plugin_develop_common.CreationMethod creation_method , // ignore
13 : optional string ide_code_runtime, // ignore
14 : optional plugin_develop_common.PluginType plugin_type , // ignore
15 : optional i64 project_id (api.js_conv = "str") , // 应用id
16 : optional i32 sub_auth_type , // 二级授权类型0api/token of service10client credentials of oauth
15 : optional i64 project_id (api.js_conv = "str") , // App ID
16 : optional i32 sub_auth_type , // Level 2 authorization type, 0: api/token of service, 10: client credentials of oauth
17 : optional string auth_payload , // ignore
18 : optional bool fixed_export_ip , // ignore
255: optional base.Base Base ,
@@ -185,15 +185,15 @@ struct UpdatePluginMetaRequest {
4 : optional string url , // plugin service url
5 : optional plugin_develop_common.PluginIcon icon ,
6 : optional plugin_develop_common.AuthorizationType auth_type ,
7 : optional plugin_develop_common.AuthorizationServiceLocation location , // 子授权类型为api/token时token参数位置
8 : optional string key , // 子授权类型为api/token时token参数key
9 : optional string service_token , // 子授权类型为api/token时token参数value
10 : optional string oauth_info , // 子授权类型为oauth时oauth信息GetOAuthSchema返回值
11 : optional map<plugin_develop_common.ParameterLocation,list<plugin_develop_common.commonParamSchema>> common_params , // json序列化
7 : optional plugin_develop_common.AuthorizationServiceLocation location , // When the sub-authorization type is api/token, the token parameter position
8 : optional string key , // When the sub-authorization type is api/token, the token parameter key
9 : optional string service_token , // When the sub-authorization type is api/token, the token parameter value
10 : optional string oauth_info , // When the sub-authorization type is oauth, for oauth information, see GetOAuthSchema return value
11 : optional map<plugin_develop_common.ParameterLocation,list<plugin_develop_common.commonParamSchema>> common_params , // JSON serialization
12 : optional plugin_develop_common.CreationMethod creation_method, // ignore
13 : optional i32 edit_version , // ignore
14 : optional plugin_develop_common.PluginType plugin_type ,
15 : optional i32 sub_auth_type , // 二级授权类型
15 : optional i32 sub_auth_type , // Level 2 authorization type
16 : optional string auth_payload , // ignore
17 : optional bool fixed_export_ip, // ignore
@@ -209,8 +209,8 @@ struct UpdatePluginMetaResponse {
struct PublishPluginRequest {
1 : required i64 plugin_id (api.js_conv = "str") ,
2 : bool privacy_status, // 隐私声明状态
3 : string privacy_info , // 隐私声明内容
2 : bool privacy_status, // Privacy Statement Status
3 : string privacy_info , // Privacy Statement Content
4 : string version_name ,
5 : string version_desc ,
255: optional base.Base Base ,
@@ -223,7 +223,7 @@ struct PublishPluginResponse {
255: optional base.BaseResp BaseResp ,
}
// bot引用plugin
// Bot reference plugin
struct GetBotDefaultParamsRequest {
1 : i64 space_id (api.js_conv = "str") ,
2 : i64 bot_id (api.js_conv = "str") ,
@@ -273,8 +273,8 @@ struct DeleteBotDefaultParamsRequest {
2 : string dev_id ,
3 : i64 plugin_id (api.js_conv = "str") ,
4 : string api_name ,
// bot删除工具时: DeleteBot = false , APIName要设置
// 删除bot时 : DeleteBot = true , APIName为空
// Bot removal tool when: DeleteBot = false, APIName to set
// Delete bot: DeleteBot = true, APIName is empty
5 : bool delete_bot ,
6 : i64 space_id (api.js_conv = "str") ,
7 : string plugin_referrer_id ,
@@ -373,7 +373,7 @@ struct GetOAuthSchemaResponse {
2 : string msg ,
3 : string oauth_schema,
4 : string ide_conf ,
255: optional base.BaseResp BaseResp , // 约定的json
255: optional base.BaseResp BaseResp , // The agreed json
}
struct GetUserAuthorityRequest {
@@ -392,7 +392,7 @@ struct GetUserAuthorityResponse {
255: optional base.BaseResp BaseResp ,
}
// 获取授权状态--plugin debug
// Get authorization status--plugin debug area
struct GetOAuthStatusRequest {
1 : required i64 plugin_id (api.js_conv = "str"),
@@ -400,9 +400,9 @@ struct GetOAuthStatusRequest {
}
struct GetOAuthStatusResponse {
1 : bool is_oauth, // 是否为授权插件
2 : plugin_develop_common.OAuthStatus status , // 用户授权状态
3 : string content , // 未授权,返回授权url
1 : bool is_oauth, // Is it an authorized plugin?
2 : plugin_develop_common.OAuthStatus status , // user authorization status
3 : string content , // Unauthorized, return the authorized url.
253: i64 code
254: string msg
@@ -426,8 +426,8 @@ struct CheckAndLockPluginEditResponse {
struct GetPluginPublishHistoryRequest {
1 : required i64 plugin_id (api.js_conv = "str"),
2 : required i64 space_id (api.js_conv = "str"),
3 : optional i32 page , // 翻页,第几页
4 : optional i32 size , // 翻页,每页几条
3 : optional i32 page , // Turn the page, what page?
4 : optional i32 size , // Flip pages, a few entries per page
255: optional base.Base Base ,
}
@@ -435,8 +435,8 @@ struct GetPluginPublishHistoryRequest {
struct GetPluginPublishHistoryResponse {
1 : i64 code ,
2 : string msg ,
3 : list<plugin_develop_common.PluginPublishInfo> plugin_publish_info_list, // 时间倒序
4 : i32 total , // 总共多少条,大于 page x size 说明还有下一页
3 : list<plugin_develop_common.PluginPublishInfo> plugin_publish_info_list, // reverse time
4 : i32 total , // How many in total, greater than page x size description and next page
255: base.BaseResp BaseResp ,
}
@@ -521,11 +521,11 @@ struct GetDevPluginListRequest {
5 : i64 space_id (api.body = "space_id", api.js_conv="str", agw.js_conv="str", agw.cli_conv="str", agw.key="space_id") ,
6 : optional plugin_develop_common.ScopeType scope_type ,
7 : optional plugin_develop_common.OrderBy order_by ,
8 : optional bool publish_status , // 发布状态筛选true:已发布, false:未发布
9 : optional string name , // 插件名或工具名
10 : optional plugin_develop_common.PluginTypeForFilter plugin_type_for_filter , // 插件种类筛选 端/云
8 : optional bool publish_status , // Release status filter: true: published, false: not published
9 : optional string name , // Plugin name or tool name
10 : optional plugin_develop_common.PluginTypeForFilter plugin_type_for_filter , // Plugin Type Filter, End/Cloud
11 : i64 project_id (api.body = "project_id", api.js_conv="str", agw.js_conv="str", agw.cli_conv="str", agw.key="project_id"),
12 : list<i64> plugin_ids (api.body = "plugin_ids", agw.js_conv="str", agw.cli_conv="str", agw.key="plugin_ids"), // 插件id列表
12 : list<i64> plugin_ids (api.body = "plugin_ids", agw.js_conv="str", agw.cli_conv="str", agw.key="plugin_ids"), // plugin id list
255: optional base.Base Base ,
}
@@ -559,8 +559,8 @@ struct Convert2OpenAPIResponse {
6 : list<plugin_develop_common.DuplicateAPIInfo> duplicate_api_infos, // ignore
// BaseResp.StatusCode
// DuplicateAPIPath: 导入的文件中有重复的API Path request.MergeSamePaths = false
// InvalidParam: 其他错误
// DuplicateAPIPath: Duplicate API Path in imported file with request. MergeSamePaths = false
// InvalidParam: Other errors
255: optional base.BaseResp BaseResp ,
}
@@ -580,21 +580,21 @@ struct BatchCreateAPIRequest {
struct BatchCreateAPIResponse {
1 : i64 code ,
2 : string msg ,
// PathsToReplace表示要覆盖的tools
// 如果BaseResp.StatusCode = DuplicateAPIPath,那么PathsToReplace不为空
// PathsToReplace represents the tools to override,
// If BaseResp. StatusCode = DuplicateAPIPath, then PathsToReplace is not empty
3 : optional list<plugin_develop_common.PluginAPIInfo> paths_duplicated,
4 : optional list<plugin_develop_common.PluginAPIInfo> paths_created ,
5 : i32 edit_version ,
// BaseResp.StatusCode
// DuplicateAPIPath: 有重复的API Path,且 request.ReplaceDupPath = false
// InvalidParam: 其他错误
// DuplicateAPIPath: There is a duplicate API Path with request. ReplaceDupPath = false
// InvalidParam: Other errors
255: required base.BaseResp BaseResp ,
}
struct RevokeAuthTokenRequest {
1 : required i64 plugin_id (api.js_conv = "str", api.body = "plugin_id"),
2 : optional i64 bot_id (api.js_conv = "str", api.body = "bot_id"), // 如果不传使用uid赋值 bot_id = connector_uid
2 : optional i64 bot_id (api.js_conv = "str", api.body = "bot_id"), // If not passed using uid assignment bot_id = connector_uid
3 : optional i32 context_type (api.body = "context_type"),
255: base.Base Base ,
}
@@ -605,9 +605,9 @@ struct RevokeAuthTokenResponse {
struct OAuthPluginInfo {
1: i64 plugin_id (api.js_conv = "str") ,
2: plugin_develop_common.OAuthStatus status , // 用户授权状态
3: string name , // 插件name
4: string plugin_icon, // 插件头像
2: plugin_develop_common.OAuthStatus status , // user authorization status
3: string name , // Plugin name
4: string plugin_icon, // plugin avatar
}
struct GetQueriedOAuthPluginListRequest {

View File

@@ -17,7 +17,7 @@ enum ParameterLocation{
Header = 4
}
//plugin枚举值
//plugin enumeration value
enum PluginParamTypeFormat{
FileUrl = 0
ImageUrl = 1
@@ -53,13 +53,13 @@ enum ParameterType{
Bool = 6,
}
// 默认入参的设置来源
// Default imported parameter settings source
enum DefaultParamSource {
Input = 0, // 默认用户输入
Variable = 1, // 引用变量
Input = 0, // default user input
Variable = 1, // reference variable
}
// 针对File类型参数的细分类型
// Subdivision types for File type parameters
enum AssistParameterType {
DEFAULT = 1,
IMAGE = 2,
@@ -71,19 +71,19 @@ enum AssistParameterType {
AUDIO = 8,
ZIP = 9,
VIDEO = 10,
VOICE = 12, // 语音
VOICE = 12, // voice
}
enum PluginToolAuthType {
Required = 0, // 强授权
Supported = 1, // 半匿名授权
Disable = 2, // 不授权
Required = 0, // strong authorization
Supported = 1, // semi-anonymous authorization
Disable = 2, // not authorized
}
enum PluginCardStatus {
Latest = 1,
NeedUpdate = 2, // 主卡片版本有升级
ParamMisMatch = 3, // 插件工具出参不匹配
NeedUpdate = 2, // The main card version has been upgraded.
ParamMisMatch = 3, // Plugin tool exported parameters do not match
}
enum PluginType {
@@ -101,8 +101,8 @@ enum PluginStatus {
PREPARED = 3,
PUBLISHED = 4,
OFFLINE = 5,
Draft = 0, // 默认值
BANNED = 6, // 禁用
Draft = 0, // default value
BANNED = 6, // disable
}
enum ProductStatus {
@@ -127,10 +127,10 @@ enum APIListOrderBy {
}
enum SpaceRoleType {
Default = 0, // 默认
Default = 0, // default
Owner = 1, // owner
Admin = 2, // 管理员
Member = 3, // 普通成员
Admin = 2, // administrator
Member = 3, // ordinary member
}
enum RunMode {
@@ -165,8 +165,8 @@ enum PluginReferrerScene {
}
enum WorkflowResponseMode {
UseLLM = 0, // 模型总结
SkipLLM = 1, // 不使用模型总结
UseLLM = 0, // model summary
SkipLLM = 1, // Do not use model summaries
}
struct ResponseStyle {
@@ -195,19 +195,19 @@ struct UserLabel {
}
struct PluginMetaInfo{
1 : string name , // 插件名
2 : string desc , // 插件描述
3 : string url , // 插件服务地址前缀
4 : PluginIcon icon , // 插件图标
5 : list<AuthorizationType> auth_type , // 插件授权类型0无授权1service3oauth
6 : optional AuthorizationServiceLocation location , // 子授权类型为api/token时token参数位置
7 : optional string key , // 子授权类型为api/token时token参数key
8 : optional string service_token, // 子授权类型为api/token时token参数值
9 : optional string oauth_info , // 子授权类型为oauth时oauth信息
10: optional map<ParameterLocation,list<commonParamSchema>> common_params, // 插件公共参数key为参数位置value为参数列表
11: optional i32 sub_auth_type, // 子授权类型,0: api/token of service, 10: client credentials of oauth
12: optional string auth_payload , // 可忽略
13: bool fixed_export_ip, // 可忽略
1 : string name , // plugin name
2 : string desc , // Plugin description
3 : string url , // Plugin service address prefix
4 : PluginIcon icon , // plugin icon
5 : list<AuthorizationType> auth_type , // Plugin authorization type, 0: no authorization, 1: service, 3: oauth
6 : optional AuthorizationServiceLocation location , // When the sub-authorization type is api/token, the token parameter position
7 : optional string key , // When the sub-authorization type is api/token, the token parameter key
8 : optional string service_token, // When the sub-authorization type is api/token, the token parameter value
9 : optional string oauth_info , // When the sub-authorization type is oauth, the oauth information
10: optional map<ParameterLocation,list<commonParamSchema>> common_params, // Plugin public parameters, key is the parameter position, value is the parameter list
11: optional i32 sub_auth_type, // Sub-authorization type, 0: api/token of service, 10: client credentials of oauth
12: optional string auth_payload , // negligible
13: bool fixed_export_ip, // negligible
}
struct PluginIcon {
@@ -231,22 +231,22 @@ struct PluginInfoForPlayground {
10: string client_id
11: string client_secret
15: list<PluginApi> plugin_apis
16: i64 tag // 插件标签
16: i64 tag // plugin tag
17: string create_time
18: string update_time
22: Creator creator // 创建人信息
23: string space_id // 空间id
24: PluginStatisticData statistic_data // 插件统计数据
22: Creator creator // creator information
23: string space_id // Space ID
24: PluginStatisticData statistic_data // plugin statistics
25: optional map<ParameterLocation, list<commonParamSchema>> common_params
26: ProductStatus plugin_product_status // plugin的商品状态
27: ProductUnlistType plugin_product_unlist_type // plugin商品下架类型
28: string material_id // 素材id
29: i32 channel_id // 渠道id
30: CreationMethod creation_method // 插件创建方式
31: bool is_official // 是否为官方插件
32: string project_id // 项目id
33: string version_ts // 版本号,毫秒时间戳
34: string version_name // 版本名称
26: ProductStatus plugin_product_status // Product status of the plugin
27: ProductUnlistType plugin_product_unlist_type // Plugin product removal type
28: string material_id // Material ID
29: i32 channel_id // Channel ID
30: CreationMethod creation_method // Plugin creation method
31: bool is_official // Is it an official plugin?
32: string project_id // Project ID
33: string version_ts // Version number, millisecond timestamp
34: string version_name // version name
}
struct PluginApi {
@@ -255,22 +255,22 @@ struct PluginApi {
3 : list<PluginParameter> parameters
4 : string plugin_id
5 : string plugin_name
7 : string api_id // 序号和playground保持一致
7 : string api_id // The serial number is the same as the playground
8 : string record_id
9 : optional PresetCardBindingInfo card_binding_info // 卡片绑定信息未绑定则为nil
10: optional DebugExample debug_example // 调试api示例
9 : optional PresetCardBindingInfo card_binding_info // Card binding information, nil if not bound.
10: optional DebugExample debug_example // Debug API example
11: optional string function_name
12: RunMode run_mode // 运行模式
12: RunMode run_mode // operating mode
}
struct Creator {
1: string id ,
2: string name ,
3: string avatar_url ,
4: bool self , // 是否是自己创建的
4: bool self , // Did you create it yourself?
5: SpaceRoleType space_roly_type ,
6: string user_unique_name, // 用户名
7: UserLabel user_label , // 用户标签
6: string user_unique_name, // user name
7: UserLabel user_label , // user tag
}
struct commonParamSchema{
@@ -284,11 +284,11 @@ struct PluginParameter {
3 : bool required
4 : string type
5 : list<PluginParameter> sub_parameters
6 : string sub_type // 如果Type是数组,则有subtype
7 : optional string from_node_id // 如果入参的值是引用的则有fromNodeId
8 : optional list<string> from_output // 具体引用哪个节点的key
9 : optional string value // 如果入参是用户手输 就放这里
10: optional PluginParamTypeFormat format // 格式化参数
6 : string sub_type // If Type is an array, there is a subtype
7 : optional string from_node_id // fromNodeId if the value of the imported parameter is a reference
8 : optional list<string> from_output // Which node's key is specifically referenced?
9 : optional string value // If the imported parameter is the user's hand input, put it here
10: optional PluginParamTypeFormat format // Format parameter
}
struct PluginAPIInfo{
@@ -307,43 +307,43 @@ struct PluginAPIInfo{
13: OnlineStatus online_status , // if tool has been published, online_status is Online
14: APIExtend api_extend , // ignore
15: optional PresetCardBindingInfo card_binding_info , // ignore
16: optional DebugExample debug_example , // 调试示例
17: DebugExampleStatus debug_example_status, // 调试示例状态
16: optional DebugExample debug_example , // Debugging example
17: DebugExampleStatus debug_example_status, // Debug sample state
18: string function_name , // ignore
}
struct APIParameter {
1 : string id , // for前端无实际意义
1 : string id , // For the front end, no practical significance
2 : string name , // parameter name
3 : string desc , // parameter desc
4 : ParameterType type , // parameter type
5 : optional ParameterType sub_type , // 可忽略
6 : ParameterLocation location , // 参数位置
7 : bool is_required , // 是否必填
8 : list<APIParameter> sub_parameters , // 子参数
9 : optional string global_default , // 全局默认值
10: bool global_disable , // 全局是否启用
11: optional string local_default , // 智能体内设置的默认值
12: bool local_disable , // 智能体内是否启用
13: optional DefaultParamSource default_param_source , // 可忽略
14: optional string variable_ref , // 引用variablekey
15: optional AssistParameterType assist_type , // 多模态辅助参数类型
5 : optional ParameterType sub_type , // negligible
6 : ParameterLocation location , // parameter location
7 : bool is_required , // Is it required?
8 : list<APIParameter> sub_parameters , // sub-parameter
9 : optional string global_default , // global default
10: bool global_disable , // Is it enabled globally?
11: optional string local_default , // Default value set in the smart body
12: bool local_disable , // Is it enabled in the smart body?
13: optional DefaultParamSource default_param_source , // negligible
14: optional string variable_ref , // Reference variable key
15: optional AssistParameterType assist_type , // Multimodal auxiliary parameter types
}
struct PluginStatisticData {
1: optional i32 bot_quote, // 为空就不展示
1: optional i32 bot_quote, // If it is empty, it will not be displayed.
}
struct APIExtend {
1: PluginToolAuthType auth_mode, // tool维度授权类型
1: PluginToolAuthType auth_mode, // Tool dimension authorization type
}
// 插件预置卡片绑定信息
// Plugin preset card binding information
struct PresetCardBindingInfo{
1: string card_id ,
2: string card_version_num,
3: PluginCardStatus status ,
4: string thumbnail , // 缩略图
4: string thumbnail , // thumbnail
}
struct DebugExample {
@@ -365,28 +365,28 @@ struct GetUserAuthorityData {
6: bool can_read_changelog
}
// 授权状态
// authorization status
enum OAuthStatus {
Authorized = 1,
Unauthorized = 2,
}
struct CheckAndLockPluginEditData {
1: bool Occupied, // 是否已被占用
2: Creator user , // 如果已经被占用了,返回用户ID
3: bool Seized , // 是否强占成功
1: bool Occupied, // Is it occupied?
2: Creator user , // If it is already occupied, return the user ID.
3: bool Seized , // Was it successful?
}
struct PluginPublishInfo {
1 : i64 publisher_id (api.js_conv = "str"), // 发布人
2 : i64 version_ts , // 版本,毫秒时间戳
3 : string version_name, // 版本名称
4 : string version_desc, // 版本描述
1 : i64 publisher_id (api.js_conv = "str"), // publisher
2 : i64 version_ts , // Version, millisecond timestamp
3 : string version_name, // version name
4 : string version_desc, // version description
}
enum DebugOperation{
Debug = 1, // 调试,会保存调试状态,会校验返回值
Parse = 2, // 仅解析返回值结构
Debug = 1, // Debugging, the debugging state will be saved, and the return value will be checked.
Parse = 2, // Parse only the return value structure
}
struct RegisterPluginData {
@@ -395,8 +395,8 @@ struct RegisterPluginData {
}
enum ScopeType {
All = 0, // 所有
Self = 1, // 自己
All = 0, // all
Self = 1, // self
}
enum OrderBy {
@@ -407,9 +407,9 @@ enum OrderBy {
}
enum PluginTypeForFilter {
CloudPlugin = 1, // 包含PLUGINAPP
LocalPlugin = 2, // 包含LOCAL
WorkflowPlugin = 3, // 包含WORKFLOWIMAGEFLOW
CloudPlugin = 1, // Includes PLUGIN and APP.
LocalPlugin = 2, // Include LOCAL
WorkflowPlugin = 3, // Includes WORKFLOW and IMAGEFLOW
}
enum PluginDataFormat {