@doubao-apps/ai 0.0.32 → 0.0.33

package/dist/skills/doubao-apps-dev/references/reference/open-api/09-/345/274/200/346/224/276/350/203/275/345/212/233-/344/270/232/345/212/241/350/203/275/345/212/233.md

@@ -1,1238 +0,0 @@
-# Open API: 开放能力 / 业务能力
-
-开放业务能力、支付、隐私设置、上下文和外部应用打开。
-
-[返回目录](./README.md) | [返回速查](../open-api.md)
-
-## 速查
-
-| API | 说明 |
-| --- | --- |
-| [dispatchActionDirective](#dispatchactiondirective) | 描述用户行为，约束模型行为并指定后续执行路径。<br><br>适用于卡片交互后向模型补充结构化动作上下文，例如按钮点击、选项选择或表单提交。 |
-| [expiredWidget](#expiredwidget) | 更新过期的 widget 为固定卡片。 |
-| [loginWithDoubaoWidget](#loginwithdoubaowidget) | 发起豆包 Widget 登录。 |
-| [login](#login) | 发起登录并获取登录凭证。 |
-| [postLoginResult](#postloginresult) | 回传 MCP 授权登录凭证。 |
-| [createSignOrder](#createsignorder) | 创建签约订单。 |
-| [getOrderPaymentWithSign](#getorderpaymentwithsign) | 使用签名信息拉起收银台完成订单支付。 |
-| [getOrderPayment](#getorderpayment) | 拉起收银台完成订单支付。 |
-| [requestCombineOrder](#requestcombineorder) | 请求创建合单订单。 |
-| [requestOrder](#requestorder) | 发起订单支付流程。 |
-| [sign](#sign) | 拉起签约流程。 |
-| [getPrivacySetting](#getprivacysetting) | 获取隐私设置状态。 |
-| [sendQueryMessage](#sendquerymessage) | 以用户身份发送一条消息。<br><br>返回 void，不是 Promise。 |
-| [setAdditionalContext](#setadditionalcontext) | 设置全局上下文供大模型理解。<br><br>设置全局上下文。 |
-| [createTask](#createtask) | 创建任务。<br><br>创建任务时需要传入开发者侧唯一任务标识、任务模板、任务详情和任务类型。开发者侧唯一任务标识 可用于幂等创建和后续业务关联。远端任务创建成功后，返回的 taskId 可用于查询或更新任务。 |
-| [updateTask](#updatetask) | 更新任务状态或任务详情。<br><br>更新任务时至少传入 taskStatus 或 taskDetail 中的一个。更新远端任务成功后，旧 token 会失效， 如返回 nextToken，后续需要使用新的 token 继续更新远端任务。 |
-| [getTask](#gettask) | 查询任务。<br><br>根据任务 ID 查询任务的模板、详情、状态和类型。若返回 token，可在后续远端任务更新中继续使用。 |
-| [updateModelContext](#updatemodelcontext) | 向 Agent 捐赠上下文。 |
-| [updateWidget](#updatewidget) | 更新指定卡片。 |
-| [openApp](#openapp) | 通过 deep link 等方式打开外部应用。 |
-
-## API 详情
-
-<a id="dispatchactiondirective"></a>
-### dispatchActionDirective()
-
-> **dispatchActionDirective**(`params`): `Promise`\<`object`\>
-
-描述用户行为，约束模型行为并指定后续执行路径。
-
-#### Parameters
-
-• **params**: [`DispatchActionDirectiveParams`](#dispatchactiondirectiveparams)
-
-动作描述、预期行为及工具调用约束参数。
-
-#### Returns
-
-`Promise`\<`object`\>
-
-返回一个 Promise，在动作指令成功下发时解析。
-
-#### Remarks
-
-适用于卡片交互后向模型补充结构化动作上下文，例如按钮点击、选项选择或表单提交。
-
-<a id="expiredwidget"></a>
-### expiredWidget()
-
-> **expiredWidget**(`__namedParameters`): `Promise`\<`object`\>
-
-更新过期的 widget 为固定卡片
-
-#### Parameters
-
-• **\_\_namedParameters**: [`ExpiredWidgetParams`](#expiredwidgetparams)
-
-#### Returns
-
-`Promise`\<`object`\>
-
-#### Description
-
-用于将状态已经过期的 widget 实例转换为固定的卡片
-
-#### Example
-
-```ts
-expiredWidget({
-  widgetInstanceId: 'instance_123',
-  url: '${pageId}?key=value'
-});
-```
-
-<a id="loginwithdoubaowidget"></a>
-### loginWithDoubaoWidget()
-
-> **loginWithDoubaoWidget**(`params`): `Promise`\<[`LoginWithWidgetResult`](#loginwithwidgetresult)\>
-
-发起豆包 Widget 登录。
-
-#### Parameters
-
-• **params**: [`LoginWithWidgetRequest`](#loginwithwidgetrequest)
-
-Widget 登录参数。
-
-#### Returns
-
-`Promise`\<[`LoginWithWidgetResult`](#loginwithwidgetresult)\>
-
-返回登录结果。
-
-<a id="login"></a>
-### login()
-
-> **login**(`params`?): `Promise`\<[`LoginResult`](#loginresult)\>
-
-发起登录并获取登录凭证。
-
-#### Parameters
-
-• **params?**: [`LoginRequest`](#loginrequest)
-
-登录参数。
-
-#### Returns
-
-`Promise`\<[`LoginResult`](#loginresult)\>
-
-返回包含登录凭证 code 的 Promise。
-
-<a id="postloginresult"></a>
-### postLoginResult()
-
-> **postLoginResult**(`params`): `Promise`\<`object`\>
-
-回传 MCP 授权登录凭证。
-
-#### Parameters
-
-• **params**: [`PostLoginResultRequest`](#postloginresultrequest)
-
-登录结果回传参数。
-
-#### Returns
-
-`Promise`\<`object`\>
-
-返回回传完成的 Promise。
-
-<a id="createsignorder"></a>
-### createSignOrder()
-
-> **createSignOrder**(`params`): `Promise`\<[`CreateSignOrderResult`](#createsignorderresult)\>
-
-创建签约订单。
-
-#### Parameters
-
-• **params**: [`CreateSignOrderParams`](#createsignorderparams)
-
-签约订单参数
-
-#### Returns
-
-`Promise`\<[`CreateSignOrderResult`](#createsignorderresult)\>
-
-返回一个 Promise，解析为签约订单结果。
-
-<a id="getorderpaymentwithsign"></a>
-### getOrderPaymentWithSign()
-
-> **getOrderPaymentWithSign**(`params`): `Promise`\<[`GetOrderPaymentResult`](#getorderpaymentresult)\>
-
-使用签名信息拉起收银台完成订单支付。
-
-#### Parameters
-
-• **params**: [`GetOrderPaymentWithSignParams`](#getorderpaymentwithsignparams)
-
-签名支付参数
-
-#### Returns
-
-`Promise`\<[`GetOrderPaymentResult`](#getorderpaymentresult)\>
-
-返回一个 Promise，成功时解析为订单支付结果。
-
-<a id="getorderpayment"></a>
-### getOrderPayment()
-
-> **getOrderPayment**(`params`): `Promise`\<[`GetOrderPaymentResult`](#getorderpaymentresult)\>
-
-拉起收银台完成订单支付。
-
-#### Parameters
-
-• **params**: [`GetOrderPaymentParams`](#getorderpaymentparams)
-
-支付参数
-
-#### Returns
-
-`Promise`\<[`GetOrderPaymentResult`](#getorderpaymentresult)\>
-
-返回一个 Promise，成功时解析为订单支付结果。
-
-<a id="requestcombineorder"></a>
-### requestCombineOrder()
-
-> **requestCombineOrder**(`params`): `Promise`\<[`RequestCombineOrderResult`](#requestcombineorderresult)\>
-
-请求创建合单订单。
-
-#### Parameters
-
-• **params**: [`RequestCombineOrderParams`](#requestcombineorderparams)
-
-合单订单参数
-
-#### Returns
-
-`Promise`\<[`RequestCombineOrderResult`](#requestcombineorderresult)\>
-
-返回一个 Promise，解析为合单订单结果。
-
-<a id="requestorder"></a>
-### requestOrder()
-
-> **requestOrder**(`params`): `Promise`\<[`RequestOrderResult`](#requestorderresult)\>
-
-发起订单支付流程。
-
-#### Parameters
-
-• **params**: [`RequestOrderParams`](#requestorderparams)
-
-订单支付请求参数。
-
-#### Returns
-
-`Promise`\<[`RequestOrderResult`](#requestorderresult)\>
-
-返回订单支付请求结果。
-
-<a id="sign"></a>
-### sign()
-
-> **sign**(`params`): `Promise`\<[`SignResult`](#signresult)\>
-
-拉起签约流程。
-
-#### Parameters
-
-• **params**: [`SignParams`](#signparams)
-
-签约参数
-
-#### Returns
-
-`Promise`\<[`SignResult`](#signresult)\>
-
-返回一个 Promise，解析为签约结果。
-
-<a id="getprivacysetting"></a>
-### getPrivacySetting()
-
-> **getPrivacySetting**(`params`?): `Promise`\<[`PrivacySettingResult`](#privacysettingresult)\>
-
-获取隐私设置状态。
-
-#### Parameters
-
-• **params?**
-
-#### Returns
-
-`Promise`\<[`PrivacySettingResult`](#privacysettingresult)\>
-
-返回隐私设置状态。
-
-<a id="sendquerymessage"></a>
-### sendQueryMessage()
-
-> **sendQueryMessage**(`params`): `void`
-
-以用户身份发送一条消息
-
-由于会自动获取页面上下文来确定向哪个 bot 发送消息，因此只能在卡片或页面中调用
-
-#### Parameters
-
-• **params**: [`SendQueryMessageParams`](#sendquerymessageparams)
-
-#### Returns
-
-`void`
-
-#### Example
-
-```ts
-await sendQueryMessage({ content: '订阅消息', type: 'text' })
-```
-
-<a id="setadditionalcontext"></a>
-### setAdditionalContext()
-
-> **setAdditionalContext**(`params`): `Promise`\<`object`\>
-
-设置全局上下文供大模型理解
-
-#### Parameters
-
-• **params**: [`SetAdditionalContextParams`](#setadditionalcontextparams)
-
-#### Returns
-
-`Promise`\<`object`\>
-
-#### Remarks
-
-设置全局上下文。
-
-<a id="createtask"></a>
-### createTask()
-
-> **createTask**(`params`): `Promise`\<[`CreateTaskResult`](#createtaskresult)\>
-
-创建任务。
-
-#### Parameters
-
-• **params**: [`CreateTaskParams`](#createtaskparams)
-
-任务创建参数。
-
-#### Returns
-
-`Promise`\<[`CreateTaskResult`](#createtaskresult)\>
-
-返回创建后的任务 ID、远端任务 token 和过期时间。
-
-#### Remarks
-
-创建任务时需要传入开发者侧唯一任务标识、任务模板、任务详情和任务类型。开发者侧唯一任务标识
-可用于幂等创建和后续业务关联。远端任务创建成功后，返回的 taskId 可用于查询或更新任务。
-
-#### Example
-
-```typescript
-import { createTask } from '@doubao-apps/framework/api';
-
-const result = await createTask({
-  outTaskId: 'order-20260529-001',
-  taskTemplate: 'remote_normal_v1',
-  taskType: 'remote',
-  taskDetail: JSON.stringify({
-    title: '订单处理中',
-    description: '正在为你处理订单，请稍候'
-  })
-});
-
-console.log(result.taskId, result.token, result.expiresIn);
-```
-
-<a id="updatetask"></a>
-### updateTask()
-
-> **updateTask**(`params`): `Promise`\<[`UpdateTaskResult`](#updatetaskresult)\>
-
-更新任务状态或任务详情。
-
-#### Parameters
-
-• **params**: [`UpdateTaskParams`](#updatetaskparams)
-
-任务更新参数，taskStatus 与 taskDetail 二选一。
-
-#### Returns
-
-`Promise`\<[`UpdateTaskResult`](#updatetaskresult)\>
-
-返回任务 ID、新 token 和过期时间。
-
-#### Remarks
-
-更新任务时至少传入 taskStatus 或 taskDetail 中的一个。更新远端任务成功后，旧 token 会失效，
-如返回 nextToken，后续需要使用新的 token 继续更新远端任务。
-
-#### Example
-
-```typescript
-import { updateTask } from '@doubao-apps/framework/api';
-
-const result = await updateTask({
-  taskId: 'task_123',
-  taskStatus: 'completed',
-  taskDetail: JSON.stringify({
-    title: '订单已完成',
-    description: '订单处理完成'
-  })
-});
-
-console.log(result.taskId, result.nextToken, result.expiresIn);
-```
-
-<a id="gettask"></a>
-### getTask()
-
-> **getTask**(`params`): `Promise`\<[`GetTaskResult`](#gettaskresult)\>
-
-查询任务。
-
-#### Parameters
-
-• **params**: [`GetTaskParams`](#gettaskparams)
-
-任务查询参数。
-
-#### Returns
-
-`Promise`\<[`GetTaskResult`](#gettaskresult)\>
-
-返回任务详情、状态、类型和 token 信息。
-
-#### Remarks
-
-根据任务 ID 查询任务的模板、详情、状态和类型。若返回 token，可在后续远端任务更新中继续使用。
-
-#### Example
-
-```typescript
-import { getTask } from '@doubao-apps/framework/api';
-
-const task = await getTask({ taskId: 'task_123' });
-
-if (task.taskStatus === 'running') {
-  console.log('任务仍在运行', task.taskDetail);
-}
-```
-
-<a id="updatemodelcontext"></a>
-### updateModelContext()
-
-> **updateModelContext**(`params`): `Promise`\<`object`\>
-
-向 Agent 捐赠上下文
-
-#### Parameters
-
-• **params**: [`UpdateModelContextParams`](#updatemodelcontextparams)
-
-#### Returns
-
-`Promise`\<`object`\>
-
-<a id="updatewidget"></a>
-### updateWidget()
-
-> **updateWidget**(`params`): `Promise`\<`object`\>
-
-更新指定卡片
-
-#### Parameters
-
-• **params**: [`UpdateWidgetParams`](#updatewidgetparams)
-
-#### Returns
-
-`Promise`\<`object`\>
-
-<a id="openapp"></a>
-### openApp()
-
-> **openApp**(`params`): `Promise`\<[`OpenAppResult`](#openappresult)\>
-
-通过 deep link 等方式打开外部应用。
-
-#### Parameters
-
-• **params**: [`OpenAppRequest`](#openapprequest)
-
-外部应用打开参数。
-
-#### Returns
-
-`Promise`\<[`OpenAppResult`](#openappresult)\>
-
-返回外部应用打开结果。
-
-## 相关类型
-
-<a id="dispatchactiondirectiveparams"></a>
-### DispatchActionDirectiveParams
-
-下发动作指令的请求参数。
-
-#### Properties
-
-##### actionDescribe
-
-> **actionDescribe**: `string`
-
-自然语言描述，例如：用户点击支付按钮并完成话费支付
-
-##### actionType
-
-> **actionType**: [`ActionDirectiveType`](#actiondirectivetype)
-
-动作类型，参见 [ActionDirectiveType](#actiondirectivetype)
-
-##### expectedAction
-
-> **expectedAction**: `string`
-
-自然语言描述，例如：调用话费账单查询工具，基于工具返回回复用户。如果有卡片需要引用卡片
-
-##### responseHint?
-
-> `optional` **responseHint**: `string`
-
-自然语言描述，例如：严格参照提供的工具入参来调用工具，不要调用除bill_check以外的其他工具，只能严格基于bill_check工具返回结果进行回复
-
-##### toolName?
-
-> `optional` **toolName**: `string`
-
-mcp名称，如果expectedAction里预期要调用工具，需要在这里写明调用工具的mcp name
-
-##### toolParams?
-
-> `optional` **toolParams**: `Record`\<`string`, `string`\>
-
-mcp入参，如果expectedAction里预期要调用工具，需要在这里写明调用工具的入参
-
-##### widgetInstanceId
-
-> **widgetInstanceId**: `string`
-
-会话消息关联的卡片ID
-
-<a id="actiondirectivetype"></a>
-### ActionDirectiveType
-
-用户动作指令类型。
-
-#### Enumeration Members
-
-##### BUTTON\_CLICK
-
-> **BUTTON\_CLICK**: `"button_click"`
-
-按钮点击
-
-##### FORM\_SUBMIT
-
-> **FORM\_SUBMIT**: `"form_submit"`
-
-表单提交（复杂的信息提交场景）
-
-##### OPTION\_SELECT
-
-> **OPTION\_SELECT**: `"option_select"`
-
-选择（下拉列表场景）
-
-<a id="expiredwidgetparams"></a>
-### ExpiredWidgetParams
-
-#### Properties
-
-##### detailText?
-
-> `optional` **detailText**: `string`
-
-点击失效卡要跳转的页面 detailText
-
-##### ~~schema?~~
-
-> `optional` **schema**: `string`
-
-点击失效卡要跳转的页面 schema，格式与 navigateTo 的 url 相同
-
-###### Deprecated
-
-使用 url 字段替代 schema 字段，后续版本将移除 schema 字段，请尽快迁移到 url 字段
-
-##### title?
-
-> `optional` **title**: `string`
-
-点击失效卡要跳转的页面 title
-
-##### url?
-
-> `optional` **url**: `string`
-
-点击失效卡要跳转的页面 url 或 sslocal schema
-
-##### widgetInstanceId
-
-> **widgetInstanceId**: `string`
-
-卡片实例 ID，在卡片环境通过getWidgetInstanceId来获取，其他环境（比如页面）需要通过传参或通信的方式传递过去
-
-<a id="loginwithwidgetrequest"></a>
-### LoginWithWidgetRequest
-
-#### Properties
-
-##### loginType
-
-> **loginType**: [`LoginType`](#logintype-1)
-
-Login type identifier
-
-<a id="loginwithwidgetresult"></a>
-### LoginWithWidgetResult
-
-#### Properties
-
-##### result
-
-> **result**: `boolean`
-
-Whether the login is successful
-
-<a id="logintype-1"></a>
-<a id="logintype"></a>
-### LoginType
-
-> **LoginType**: `0` \| `1` \| `2` \| `3`
-
-Widget 登录类型。
-
-- `0`: 隐私协议登录
-- `1`: 仅登录
-- `2`: 先登录再隐私协议，两次弹窗
-- `3`: 登录和隐私协议合并，一次弹窗
-
-<a id="loginrequest"></a>
-### LoginRequest
-
-#### Properties
-
-##### timeout?
-
-> `optional` **timeout**: `number`
-
-Timeout in milliseconds
-
-<a id="loginresult"></a>
-### LoginResult
-
-#### Properties
-
-##### code
-
-> **code**: `string`
-
-Login credential code
-
-<a id="postloginresultrequest"></a>
-### PostLoginResultRequest
-
-#### Properties
-
-##### code?
-
-> `optional` **code**: `string`
-
-Authorization login credential, valid when login result is true
-
-##### result
-
-> **result**: `boolean`
-
-Login result, true means success, false means failure
-
-<a id="createsignorderparams"></a>
-### CreateSignOrderParams
-
-#### Properties
-
-##### data
-
-> **data**: `string`
-
-签约订单请求数据。
-
-##### dbAuthorization
-
-> **dbAuthorization**: `string`
-
-签约订单授权信息。
-
-<a id="createsignorderresult"></a>
-### CreateSignOrderResult
-
-> **CreateSignOrderResult**: [`CreateSignOrderSuccessResult`](#createsignordersuccessresult) \| [`CreateSignOrderFailResult`](#createsignorderfailresult)
-
-<a id="createsignorderfailresult"></a>
-### CreateSignOrderFailResult
-
-#### Properties
-
-##### errLogId?
-
-> `optional` **errLogId**: `string`
-
-用于问题排查的错误日志 ID。
-
-##### errMsg
-
-> **errMsg**: `string`
-
-错误信息。
-
-##### errNo
-
-> **errNo**: `string`
-
-错误码。
-
-<a id="createsignordersuccessresult"></a>
-### CreateSignOrderSuccessResult
-
-#### Properties
-
-##### authOrderId
-
-> **authOrderId**: `string`
-
-签约订单 ID。
-
-##### logId
-
-> **logId**: `string`
-
-用于问题排查的日志 ID。
-
-<a id="getorderpaymentresult"></a>
-### GetOrderPaymentResult
-
-#### Properties
-
-##### logId
-
-> **logId**: `string`
-
-用于问题排查的日志 ID。
-
-##### orderId
-
-> **orderId**: `string`
-
-订单 ID。
-
-<a id="getorderpaymentwithsignparams"></a>
-### GetOrderPaymentWithSignParams
-
-#### Properties
-
-##### orderId
-
-> **orderId**: `string`
-
-订单 ID。
-
-##### signData
-
-> **signData**: `string`
-
-支付签名数据。
-
-##### signDbAuthorization
-
-> **signDbAuthorization**: `string`
-
-签名支付授权信息。
-
-<a id="getorderpaymentparams"></a>
-### GetOrderPaymentParams
-
-#### Properties
-
-##### orderId
-
-> **orderId**: `string`
-
-订单 ID。
-
-<a id="requestcombineorderparams"></a>
-### RequestCombineOrderParams
-
-#### Properties
-
-##### data
-
-> **data**: `string`
-
-合单订单请求数据。
-
-##### dbAuthorization
-
-> **dbAuthorization**: `string`
-
-合单订单授权信息。
-
-<a id="requestcombineorderresult"></a>
-### RequestCombineOrderResult
-
-> **RequestCombineOrderResult**: [`RequestCombineOrderSuccessResult`](#requestcombineordersuccessresult) \| [`RequestCombineOrderFailResult`](#requestcombineorderfailresult)
-
-<a id="requestcombineorderfailresult"></a>
-### RequestCombineOrderFailResult
-
-#### Properties
-
-##### errLogId?
-
-> `optional` **errLogId**: `string`
-
-用于问题排查的错误日志 ID。
-
-##### errMsg
-
-> **errMsg**: `string`
-
-错误信息。
-
-##### errNo
-
-> **errNo**: `string`
-
-错误码。
-
-<a id="requestcombineordersuccessresult"></a>
-### RequestCombineOrderSuccessResult
-
-#### Properties
-
-##### combineOrderId
-
-> **combineOrderId**: `string`
-
-合单订单 ID。
-
-##### logId
-
-> **logId**: `string`
-
-用于问题排查的日志 ID。
-
-<a id="requestorderparams"></a>
-### RequestOrderParams
-
-#### Properties
-
-##### data
-
-> **data**: `string`
-
-##### dbAuthorization
-
-> **dbAuthorization**: `string`
-
-<a id="requestorderresult"></a>
-### RequestOrderResult
-
-#### Properties
-
-##### logId
-
-> **logId**: `string`
-
-##### orderId
-
-> **orderId**: `string`
-
-<a id="signparams"></a>
-### SignParams
-
-#### Properties
-
-##### orderId
-
-> **orderId**: `string`
-
-签约订单 ID。
-
-<a id="signresult"></a>
-### SignResult
-
-> **SignResult**: [`SignSuccessResult`](#signsuccessresult) \| [`SignFailResult`](#signfailresult)
-
-<a id="signfailresult"></a>
-### SignFailResult
-
-#### Properties
-
-##### code
-
-> **code**: `number`
-
-错误码。
-
-##### errLogId?
-
-> `optional` **errLogId**: `string`
-
-用于问题排查的错误日志 ID。
-
-##### errMsg
-
-> **errMsg**: `string`
-
-错误信息。
-
-##### errNo
-
-> **errNo**: `string`
-
-错误编号。
-
-<a id="signsuccessresult"></a>
-### SignSuccessResult
-
-> **SignSuccessResult**: `Record`\<`string`, `never`\>
-
-<a id="privacysettingresult"></a>
-### PrivacySettingResult
-
-#### Properties
-
-##### needAuthorization
-
-> **needAuthorization**: `boolean`
-
-Whether user authorization for privacy agreement is required
-
-<a id="sendquerymessageparams"></a>
-### SendQueryMessageParams
-
-#### Properties
-
-##### content
-
-> **content**: `string`
-
-要发送的消息。根据类型不同，序列化方式可能不同
-
-##### type
-
-> **type**: `"text"`
-
-消息类型，目前仅支持 text
-
-<a id="setadditionalcontextparams"></a>
-### SetAdditionalContextParams
-
-#### Properties
-
-##### additionalContext
-
-> **additionalContext**: `string`
-
-上下文内容
-
-##### botId?
-
-> `optional` **botId**: `string`
-
-指定 bot id
-
-<a id="createtaskparams"></a>
-### CreateTaskParams
-
-创建任务的请求参数。
-
-#### Properties
-
-##### outTaskId
-
-> **outTaskId**: `string`
-
-开发者侧任务唯一标识，用于幂等和关联
-
-##### taskDetail
-
-> **taskDetail**: `string`
-
-模板对应的数据的 JSON 字符串
-
-##### taskTemplate
-
-> **taskTemplate**: `"remote_normal_v1"`
-
-任务样式模板，当前仅支持 remote_normal_v1
-
-##### taskType
-
-> **taskType**: [`TaskType`](#tasktype-2)
-
-任务类型，当前支持 local 和 remote
-
-<a id="createtaskresult"></a>
-### CreateTaskResult
-
-创建任务的返回结果。
-
-#### Properties
-
-##### expiresIn?
-
-> `optional` **expiresIn**: `number`
-
-任务超时过期时间
-
-##### taskId
-
-> **taskId**: `string`
-
-任务 ID，后续可以使用这个 ID 更新任务
-
-##### token?
-
-> `optional` **token**: `string`
-
-远端任务 token，后续使用 token 通过 OpenAPI 更新远端任务
-
-<a id="tasktype-2"></a>
-<a id="tasktype"></a>
-### TaskType
-
-> **TaskType**: `"local"` \| `"remote"`
-
-任务类型。
-
-local 表示本地任务，remote 表示远端任务。
-
-<a id="updatetaskparams"></a>
-### UpdateTaskParams
-
-更新任务的请求参数。
-
-#### Properties
-
-##### taskDetail?
-
-> `optional` **taskDetail**: `string`
-
-模板对应的数据的 JSON 字符串，与 taskStatus 二选一
-
-##### taskId
-
-> **taskId**: `string`
-
-任务 ID
-
-##### taskStatus?
-
-> `optional` **taskStatus**: [`TaskStatus`](#taskstatus-2)
-
-任务状态，与 taskDetail 二选一
-
-<a id="updatetaskresult"></a>
-### UpdateTaskResult
-
-更新任务的返回结果。
-
-#### Properties
-
-##### expiresIn?
-
-> `optional` **expiresIn**: `number`
-
-任务超时过期时间
-
-##### nextToken?
-
-> `optional` **nextToken**: `string`
-
-每次更新后旧的 token 失效，必须使用新返回的 token
-
-##### taskId
-
-> **taskId**: `string`
-
-任务 ID，更新后任务 ID 不变
-
-<a id="taskstatus-2"></a>
-<a id="taskstatus"></a>
-### TaskStatus
-
-> **TaskStatus**: `"running"` \| `"completed"`
-
-任务状态。
-
-running 表示任务运行中，completed 表示任务已完成。
-
-<a id="gettaskparams"></a>
-### GetTaskParams
-
-查询任务的请求参数。
-
-#### Properties
-
-##### taskId
-
-> **taskId**: `string`
-
-任务 ID
-
-<a id="gettaskresult"></a>
-### GetTaskResult
-
-查询任务的返回结果。
-
-#### Properties
-
-##### expiresIn?
-
-> `optional` **expiresIn**: `number`
-
-任务超时过期时间
-
-##### taskDetail
-
-> **taskDetail**: `string`
-
-模板对应的数据的 JSON 字符串
-
-##### taskId
-
-> **taskId**: `string`
-
-任务 ID
-
-##### taskStatus
-
-> **taskStatus**: [`TaskStatus`](#taskstatus-2)
-
-任务状态，运行中或已完成
-
-##### taskTemplate
-
-> **taskTemplate**: `"remote_normal_v1"`
-
-任务样式模板，当前仅支持 remote_normal_v1
-
-##### taskType
-
-> **taskType**: [`TaskType`](#tasktype-2)
-
-任务类型，local 或 remote
-
-##### token?
-
-> `optional` **token**: `string`
-
-每次更新后旧的 token 失效，必须使用新返回的 token
-
-<a id="updatemodelcontextparams"></a>
-### UpdateModelContextParams
-
-#### Properties
-
-##### content
-
-> **content**: `string`
-
-上下文内容，格式无约束，可以与 MCP 服务下发的上下文格式保持一致
-
-##### entityId?
-
-> `optional` **entityId**: `string`
-
-上下文所属的 entityID，业务侧管理
-
-##### taskId?
-
-> `optional` **taskId**: `string`
-
-上下文所属任务 ID，业务侧定义
-
-<a id="updatewidgetparams"></a>
-### UpdateWidgetParams
-
-#### Properties
-
-##### widgetData
-
-> **widgetData**: `string`
-
-卡片渲染的数据
-
-##### widgetId?
-
-> `optional` **widgetId**: `string`
-
-卡片更新的为新的widgetId
-
-##### widgetInstanceId
-
-> **widgetInstanceId**: `string`
-
-需要更新的widget 实例 ID
-
-<a id="openapprequest"></a>
-### OpenAppRequest
-
-#### Properties
-
-##### fallbackUrl?
-
-> `optional` **fallbackUrl**: `string`
-
-Optional fallback URL when deep link fails
-
-##### targetPackage?
-
-> `optional` **targetPackage**: `string`
-
-Optional target package name for Android
-
-##### uri
-
-> **uri**: `string`
-
-Target URI to open, e.g. scheme://path?query
-
-<a id="openappresult"></a>
-### OpenAppResult
-
-#### Properties
-
-##### status
-
-> **status**: [`OpenAppStatus`](#openappstatus)
-
-Execution status from client
-
-<a id="openappstatus"></a>
-### OpenAppStatus
-
-> **OpenAppStatus**: `"deep_link"` \| `"market"` \| `"browser"`