一个 run 可以表示一个 trace(根 run)或一个子 run(~span)。

interface RunCreate {
    inputs: KVMap;
    name: string;
    run_type: string;
    attachments?: Attachments;
    child_runs?: RunCreate[];
    dotted_order?: string;
    end_time?: number;
    error?: string;
    events?: KVMap[];
    extra?: KVMap;
    id?: string;
    outputs?: KVMap;
    parent_run_id?: string;
    reference_example_id?: string;
    revision_id?: string;
    serialized?: object;
    session_name?: string;
    start_time?: number;
    tags?: string[];
    trace_id?: string;
}

层级结构 (查看摘要)

属性

inputs: KVMap

用于启动 run 的输入。

name: string

run 的人类可读名称。

run_type: string

指定 run 的类型(工具、链、llm 等)。

attachments?: Attachments

与 run 关联的附件。每个条目都是 [mime_type, bytes] 的元组

child_runs?: RunCreate[]
dotted_order?: string

run 的点状顺序。

这是一个由 {time}{run-uuid}.* 组成的字符串,以便 trace 可以按执行顺序排序。

示例

  • 父级: 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8
  • 子级
    • 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155649Z809ed3a2-0172-4f4d-8a02-a64e9b7a0f8a
    • 20230915T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155650Zc8d9f4c5-6c5a-4b2d-9b1c-3d9d7a7c5c7c
end_time?: number

run 结束时的 epoch 时间(如果适用)。

error?: string

错误消息,在 run 遇到任何问题时捕获。

events?: KVMap[]

与 run 关联的事件,如 'start'、'end'。

extra?: KVMap

run 的任何其他元数据或设置。

id?: string

可选地,run 的唯一标识符。

outputs?: KVMap

run 生成的输出(如果有)。

parent_run_id?: string

父级 run 的 ID(如果此 run 是较大操作的一部分)。

reference_example_id?: string

可能与此 run 相关的示例的 ID。

revision_id?: string
serialized?: object

run 的序列化状态,供未来潜在使用。

session_name?: string
start_time?: number

run 开始时的 epoch 时间(如果可用)。

tags?: string[]

用于进一步分类或注释 run 的标签。

trace_id?: string

分配给此嵌套 trace 中每个 run 的唯一 ID。 *