跳到主要内容

AI 交互对话

打开流式 AI 对话窗口,在动作运行期间继续追问,并由用户明确选择是否采用当前回答。

使用前,请先在 Quicker 的 设置 → AI 中配置服务、模型和文本任务场景。配置方式见统一 AI 服务与模型设置

当前模块定义

sys:aiChat网络服务Action
标准模块
输入 10 · 输出 11 · 枚举 3

输入参数

  • 会话方式modeEnum必填

    新建本机会话,或继续当前设备上已有的会话。会话 ID 不会随动作分享。

    填写 固定输入默认 new
    新建会话默认new
    继续指定会话continue
  • 会话 IDconversationIdText必填

    要继续的本机会话 ID;不存在时明确失败,不会创建空会话。

    填写 输入或变量条件 仅:continue
  • 初始问题initialQuestionText必填

    打开窗口后立即发送的问题;之后可在窗口中继续追问。

    填写 输入或变量
  • 完整系统提示词systemPromptText可选

    新建会话的完整系统规则;继续会话时使用原会话记录。

    填写 输入或变量条件 仅:new
  • AI 任务场景useCaseIdText可选

    选择“模型分配”中的文本任务场景。每轮追问都会重新解析当前可用模型。

    填写 输入或变量默认 text.general
    日常文本处理与翻译默认text.general
  • 窗口标题windowTitleText可选

    对话窗口和新会话的标题。

    填写 输入或变量默认 AI 对话
  • 最大对话轮数maxRoundsInteger可选

    首轮回答计为 1;达到上限后只能采用或取消。

    填写 输入或变量默认 10
  • 最大输出 TokenmaxOutputTokensInteger可选

    每轮输出限制;0 表示不由本步骤设置。

    填写 输入或变量默认 0
  • 任务场景缺失时missingUseCaseBehaviorEnum可选

    自定义任务场景不存在时,使用内置文本任务场景或直接失败。

    填写 输入或变量默认 UseBaseUseCase
    使用基础场景默认UseBaseUseCase
    执行失败Fail
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 采用的回答resultText

    用户明确点击“采用当前回答”时最后一条完整 Assistant 文本。

  • 会话 IDresultConversationIdText

    当前设备上的本地会话 ID。

  • 完整消息历史 JSONhistoryJsonText

    版本化的本地消息历史,Reasoning 与 Text 分开。

  • 对话轮数roundCountInteger
  • 实际模型modelText
  • 输入 TokeninputTokensInteger
  • 缓存输入 TokencachedInputTokensInteger
  • 输出 TokenoutputTokensInteger
  • 总 TokentotalTokensInteger
  • 调用标识列表 JSONinvocationIdsJsonText

新建会话

  1. 将“会话方式”设为“新建会话”。
  2. 填写初始问题;如需固定角色或回答规则,再填写完整系统提示词。
  3. 运行时在窗口中查看流式回答,并按需继续追问。
  4. 点击“采用当前回答”,把最后一条完整回答写入“采用的回答”。关闭或取消窗口会按用户取消结束。

“最大对话轮数”包含首次回答。达到上限后不能继续发送问题,只能采用当前回答或取消。

继续已有会话

将“会话方式”设为“继续指定会话”,并传入此前输出的“会话 ID”。指定会话必须存在于当前设备;不存在时步骤会明确失败,不会自动创建空会话。继续会话时沿用原会话的系统提示词,本步骤填写的系统提示词不生效。

每轮追问都会按当前 AI 设置重新解析可用模型,因此调整候选顺序、停用服务或修改凭据后,后续轮次可能使用不同模型。

输出与存储

  • “采用的回答”是用户点击采用时最后一条完整 Assistant 文本。
  • “完整消息历史 JSON”包含本地保存的版本化消息历史,推理内容与回答文本分开记录。
  • “调用标识列表 JSON”可用于关联本次交互中的多轮请求。

会话保存在本机,动作分享不会携带会话 ID 对应的历史记录,也不会同步 API Key。跨设备运行时应新建会话,或由动作自行传递所需上下文。

注意事项

  • 本模块必须显示交互窗口,不适合无人值守或后台执行。只需一次自动处理时,使用 AI 文本处理 的“直接返回”模式。
  • 关闭或取消窗口不会输出尚未采用的回答。需要区分取消和请求失败时,请结合步骤结果与“遇到错误时停止动作”设置处理。
  • 对话内容会发送给每轮实际选中的 AI 服务商;本地历史也可能包含敏感信息,请按数据要求决定是否使用持续会话。