WOLFRAM

Wolfram Language & System Documentation Center

ChatSubmit[chat,prompt]

提交 prompt，将其后续内容异步附加到 ChatObject chat 中.

更多信息和选项
Details and Options Details and Options
范例  
基本范例  
范围  
选项  
Authentication  
HandlerFunctions  
HandlerFunctionsKeys  
LLMEvaluator  
应用  
工具调用  
参见
相关指南
历史
按以下格式引用：

ChatSubmit

ChatSubmit[chat,prompt]

提交 prompt，将其后续内容异步附加到 ChatObject chat 中.

更多信息和选项

  • ChatSubmit 用于在 ChatObject 中继续异步对话.
  • ChatSubmit 需要外部服务的身份验证、计费和互联网连接.
  • prompt 的可能值包括：
  • "text"静态文本
    LLMPrompt["name"]存储库提示
    StringTemplate[…]模板化文本
    TemplateObject[…]用于创建提示的模板
    Image[…]图像
    {prompt1,…}提示列表
  • 用 TemplateObject 创建的提示可以包含文本和图像. 并非所有 LLM 都支持图像输入.
  • ChatSubmit 返回 TaskObject[…].
  • 可指定以下选项：
  • Authentication Inherited显式用户 ID 和 API 密钥
    HandlerFunctions 定义如何处理生成的事件
    HandlerFunctionsKeys Automatic提供给处理函数的参数
    LLMEvaluator Inherited使用的 LLM 配置
  • 在异步执行 ChatSubmit 的过程中，可以生成各种事件.
  • 由 LLM 触发的事件：
  • "ContentChunkReceived"收到的增量消息内容
    "StoppingReasonReceived"停止接收生成的原因
    "MetadataReceived"收到的其他元数据
    "ToolRequestReceived"收到的 LLMToolRequest[…]
    "UsageInformationReceived"收到的增量使用信息
  • 本地处理触发的事件：
  • "ChatObjectGenerated"生成的最终 ChatObject[…]
    "ToolResponseGenerated"生成的 LLMToolResponse[…]
  • 任务框架触发的事件：
  • "FailureOccurred"计算过程中发生失败
    "TaskFinished"任务完全完成
    "TaskRemoved"任务被移除
    "TaskStarted"任务已启动
    "TaskStatusChanged"任务状态已更改
  • HandlerFunctionsf 使用 f 处理所有事件.
  • 通过规范 HandlerFunctions-><|…,"eventi"->fi,…|>，当 eventi 被生成时，将计算 fi[assoc]. assoc 的元素包含由 HandlerFunctionsKeys 设置的键.
  • 由 HandlerFunctionsKeys 指定的可能键包括：
  • "ChatObject"修改后的 ChatObject[…]
    "ContentChunk"消息部分
    "EventName"正在处理的事件名称
    "Failure"任务失败时生成的失败对象
    "Model"用于生成消息的模型
    "Role"消息作者的角色
    "StoppingReason"停止生成的原因
    "Task"由 ChatSubmit 生成的任务对象
    "TaskStatus"任务状态
    "TaskUUID"唯一任务标识符
    "Timestamp"消息的时间戳
    "ToolRequest"收到的 LLMToolRequest[…]
    "ToolResponse"最近生成的 LLMToolResponse[…]
    "UsageIncrement"令牌使用更新
    {key1,…}键列表
    All所有键
    Automatic在 HandlerFunctions 中按字面出现的键
  • 尚未接收到的值显示为 Missing["NotAvailable"].
  • 如果 LLMEvaluator 被设置为 Inherited，则使用 chat 中指定的 LLM 配置.
  • LLMEvaluator 可以设置为 LLMConfiguration 对象或与以下任意键的关联：
  • "MaxTokens"生成的最大令牌数
    "Model"基础模型
    "PromptDelimiter"提示之间插入的字符串
    "Prompts"初始提示或 LLMPromptGenerator 对象
    "StopTokens"停止生成的令牌
    "Temperature"采样温度
    "ToolMethod"用于工具调用的方法
    "Tools"可用的 LLMTool 对象列表
    "TopProbabilities"采样类的截断
    "TotalProbabilityCutoff"采样概率截断（核采样）
  • "Model" 的有效形式包括：
  • name命名模型
    {service,name}来自 service 的命名模型
    <|"Service"service,"Name"name|>完全指定的模型
  • 在 "Prompts" 中指定的提示会作为 "System" 角色的消息预先添加到 chat 中.
  • 多个提示通过 "PromptDelimiter" 属性分隔.
  • 生成的文本是从分布中采样的. 可以使用 LLMEvaluator 的以下属性来指定采样的详细信息：
  • "Temperature"tAutomatic使用正温度 t 进行采样
    "TopProbabilities"kAutomatic仅在概率最高的 k 个类别中采样
    "TotalProbabilityCutoff"pAutomatic在累计概率至少为 p 的最可能选择中采样（核采样）
  • 这些参数的 Automatic 值使用指定 "Model" 的默认值.
  • "ToolMethod" 的可能值包括：
  • "Service"依赖于 service 的工具机制
    "Textual"使用基于提示的工具调用
  • Authentication 的可能值有：
  • Automatic自动选择身份验证方案
    Inherited从 chat 中继承设置
    Environment检查环境变量中的密钥
    SystemCredential检查系统密钥链中的密钥
    ServiceObject[…]从服务对象继承身份验证
    assoc提供显式的密钥和用户 ID
  • 当 AuthenticationAutomatic 时，函数会检查 Environment 中的变量 ToUpperCase[service]<>"_API_KEY" 和 SystemCredential；否则，它会使用 ServiceConnect[service].
  • 当使用 Authenticationassoc 时，assoc 可以包含以下键：
  • "ID"用户身份
    "APIKey"用于身份验证的 API 密钥
  • ChatSubmit 使用机器学习. 其方法、训练集及其中包含的偏差可能会在不同版本的 Wolfram 语言中发生变化，并产生不同结果.

范例

打开所有单元 关闭所有单元

基本范例  (2)

创建新聊天：

向对话添加一条消息并提交以获取响应，将结果分配给 res：

检查生成的对话：

从多模态模型中检索生成的响应块：

显示所有生成步骤：

范围  (2)

异步开始新对话：

检查任务当前状态：

检查生成的对话：

异步继续现有对话：

检查生成的对话：

选项  (14)

Authentication  (4)

为 API 提供身份验证密钥：

在系统密钥链中查找密钥：

指定密钥的名称：

在系统环境中寻找密钥：

通过服务对象进行身份验证：

HandlerFunctions  (2)

在消息窗口中打印所有生成的事件名称：

捕获不存在模型的服务产生的故障：

HandlerFunctionsKeys  (3)

明确列出要传递给处理函数的处理函数键：

将 HandlerFunctionsKeys 的值设置为从处理函数中存在的槽位中按词法推断（默认）：

在处理函数参数中包含所有可用的处理函数键：

LLMEvaluator  (5)

指定用于生成答案的服务：

指定服务和模型：

默认情况下，文本生成会持续进行，直到生成终止令牌为止：

限制生成的样本数量（令牌）：

指定采样应在零温度下进行：

指定一个较高的温度，以获得更多的生成变异：

比较结果：

指定截止分布之前的最大累积概率：

指定自动添加到对话中的提示：

应用  (1)

工具调用  (1)

定义一个可以被LLM调用的工具：

使用该工具实例化一个聊天对象：

使用该工具提出一个可以获得精确答案的问题：

检查生成的对话：

Wolfram Research (2025)，ChatSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ChatSubmit.html.

文本

Wolfram Research (2025)，ChatSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ChatSubmit.html.

CMS

Wolfram 语言. 2025. "ChatSubmit." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/ChatSubmit.html.

APA

Wolfram 语言. (2025). ChatSubmit. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/ChatSubmit.html 年

BibTeX

@misc{reference.wolfram_2025_chatsubmit, author="Wolfram Research", title="{ChatSubmit}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/ChatSubmit.html}", note=[Accessed: 15-September-2025]}

BibLaTeX

@online{reference.wolfram_2025_chatsubmit, organization={Wolfram Research}, title={ChatSubmit}, year={2025}, url={https://reference.wolfram.com/language/ref/ChatSubmit.html}, note=[Accessed: 15-September-2025]}