Skip to main content

状态

机器翻译译自英文(docs.typesafe.ai)本页 16 段已全部译完

文档索引

在以下地址获取完整的文档索引:https://docs.typesafe.ai/llms.txt 使用此文件可以在进一步探索之前发现所有可用页面。

状态

状态是什么,如何对其进行结构化,以及如何为 System One 模型提供它所需的上下文。

状态 是你要求 System One 模型评估的内容。它可以是一条支持消息、一段文本或应用程序的当前状态。它在 API 请求的 state 字段中传递,与你希望回答的问题一起。

每次请求针对一个或多个问题评估一个状态。所有问题看到相同的状态并独立评估。你可以在一次请求中混合使用 Choice、Score 和 Noul 问题。

状态可以是简单字符串或结构化 JSON 值

最简单的状态是一个纯字符串:

state = "My card was charged twice."

状态也可以是包含相关上下文、示例和其他有助于模型回答相关问题信息的 JSON 对象或数组。将状态视为你在请专家小组做出判断之前会向他们展示的材料。在 Python 中,将相应的字符串、字典或列表直接传递给 client.system_one(state=...)。

格式用途示例
字符串消息、文章或段落"My card was charged twice."
对象命名字段、相关记录或应用程序状态{"message": "My card was charged twice.", "order_id": "A-104"}
数组消息或记录的序列["Hi", "My customer number is TS1337.", "My card was charged twice."]

大多数请求应使用对象,以便状态的每个部分都有描述性名称,且其关系保持清晰。当用例简单且只需要一段文本时,字符串是合适的选择。

Note

Jev 仅接受文本。状态必须是字符串、JSON 对象或文本值数组。图片、音频和视频不受支持(目前)。Jev 的主要训练语言是英语;其他语言,包括中日韩文,虽被接受但目前准确率较低——参见 模型。

A support conversation as state
{
  "ticket": {
    "subject": "Duplicate charge",
    "messages": [
      {"from": "customer", "text": "I was charged twice for order A-104. Please refund the duplicate."},
      {"from": "support", "text": "We are checking the charges."}
    ]
  },
  "order": {
    "id": "A-104",
    "charges": [
      {"amount_usd": 49, "status": "captured"},
      {"amount_usd": 49, "status": "captured"}
    ]
  },
  "refund_policy": "Duplicate charges are eligible for a refund."
}

此对象是一个状态,尽管它包含对话、订单和政策。当决策需要比较这些部分时,将相关信息放在一起。

将内容和问题分开

状态包含内容和支持事实。问题 定义了模型应针对该材料做出的判断。例如,将退款请求和政策保存在状态中,然后询问客户是否请求了退款以及政策是否支持退款。

参见 原语(问题) 了解关于指令、标准、问题类型以及对同一状态提出多个问题的指导。

参见 API 参考 了解请求模式,以及 客户端 SDK 了解安装、类型化输入和响应处理。