一次运行可以表示一个跟踪(根运行)或一个子运行(~span)。

接口 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

用于启动运行的输入。

name: string

运行的人类可读名称。

run_type: string

指定运行的类型(工具、链、LLM 等)。

attachments?: Attachments

与运行关联的附件。每个条目是一个 [mime_type, bytes] 元组

child_runs?: RunCreate[]
dotted_order?: string

运行的点序。

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

示例

  • 父级: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

如果适用,运行结束时的纪元时间。

error?: string

错误消息,如果运行遇到任何问题则捕获。

events?: KVMap[]

与运行关联的事件,例如“开始”、“结束”。

extra?: KVMap

运行的任何额外元数据或设置。

id?: string

可选地,运行的唯一标识符。

outputs?: KVMap

运行产生的输出(如果有)。

parent_run_id?: string

父运行的 ID,如果此运行是更大操作的一部分。

reference_example_id?: string

可能与此运行相关的示例 ID。

revision_id?: string
serialized?: object

运行的序列化状态,用于未来潜在使用。

session_name?: string
start_time?: number

如果可用,运行开始时的纪元时间。

tags?: string[]

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

trace_id?: string

分配给此嵌套跟踪中每次运行的唯一 ID。*