RunBase#

class langsmith.schemas.RunBase(
*,
id: UUID,
name: str,
start_time: datetime,
run_type: str,
end_time: datetime | None = None,
extra: dict | None = None,
error: str | None = None,
serialized: dict | None = None,
events: list[dict] | None = None,
inputs: dict = None,
outputs: dict | None = None,
reference_example_id: UUID | None = None,
parent_run_id: UUID | None = None,
tags: list[str] | None = None,
attachments: dict[str, tuple[str, bytes] | Attachment | tuple[str, Path]] | dict[str, AttachmentInfo] = None,
)[源代码]#

基础运行模式。

运行（Run）是指在您的 LLM 应用中代表单一工作单元或操作的 span。这可能是一个对 LLM 或链的单次调用、一个提示格式化调用或一个可运行的 lambda 调用。如果您熟悉 OpenTelemetry，可以将运行视为一个 span。

通过解析和验证来自关键字参数的输入数据来创建新模型。

如果输入数据无法解析为有效模型，则会引发 ValidationError。

属性

metadata

检索元数据（如果有）。

revision_id

检索修订 ID（如果有）。

方法

__init__(**data)

通过解析和验证来自关键字参数的输入数据来创建新模型。

construct([_fields_set])

从受信任或预验证的数据创建新模型，并设置 __dict__ 和 __fields_set__。

copy(*[, include, exclude, update, deep])

复制模型，可选地选择要包含、排除和更改的字段。

dict(*[, include, exclude, by_alias, ...])

生成模型的字典表示，可选地指定要包含或排除的字段。

from_orm(obj)

json(*[, include, exclude, by_alias, ...])

生成模型的 JSON 表示，参数 include 和 exclude 的用法与 dict() 相同。

parse_file(path, *[, content_type, ...])

parse_obj(obj)

parse_raw(b, *[, content_type, encoding, ...])

schema([by_alias, ref_template])

schema_json(*[, by_alias, ref_template])

update_forward_refs(**localns)

尝试根据此模型、globalns 和 localns 的字段更新 ForwardRefs。

validate(value)

参数:

  • id (UUID)

  • name (str)

  • start_time (datetime)

  • run_type (str)

  • end_time (datetime | None)

  • extra (dict | None)

  • error (str | None)

  • serialized (dict | None)

  • events (list[dict] | None)

  • inputs (dict)

  • outputs (dict | None)

  • reference_example_id (UUID | None)

  • parent_run_id (UUID | None)

  • tags (list[str] | None)

  • attachments (dict[str, tuple[str, bytes] | Attachment | tuple[str, Path]] | dict[str, AttachmentInfo])

__init__(**data: Any) → None#

通过解析和验证来自关键字参数的输入数据来创建新模型。

如果输入数据无法解析为有效模型，则会引发 ValidationError。

参数:

data (Any)

返回类型:

None

classmethod construct(
_fields_set: SetStr | None = None,
**values: Any,
) → Model#

从受信任或预验证的数据创建新模型，并设置 __dict__ 和 __fields_set__。默认值会被遵守，但不会执行其他验证。其行为类似于设置了 Config.extra = ‘allow’，因为它会添加所有传入的值。

参数:

  • _fields_set (SetStr | None)

  • values (Any)

返回类型:

Model

copy(
*,
include: AbstractSetIntStr | MappingIntStrAny | None = None,
exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
update: DictStrAny | None = None,
deep: bool = False,
) → Model#

复制模型，可选地选择要包含、排除和更改的字段。

参数:

  • include (AbstractSetIntStr | MappingIntStrAny | None) – 要在新模型中包含的字段

  • exclude (AbstractSetIntStr | MappingIntStrAny | None) – 要从新模型中排除的字段，与值一样，这优先于包含

  • update (DictStrAny | None) – 要在新模型中更改/添加的值。注意：在创建新模型之前不会验证数据：您应该信任此数据

  • deep (bool) – 设置为 True 以对模型进行深拷贝

  • self (Model)

返回:

新模型实例

返回类型:

Model

dict(
*,
include: AbstractSetIntStr | MappingIntStrAny | None = None,
exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
by_alias: bool = False,
skip_defaults: bool | None = None,
exclude_unset: bool = False,
exclude_defaults: bool = False,
exclude_none: bool = False,
) → DictStrAny#

生成模型的字典表示，可选地指定要包含或排除的字段。

参数:

  • include (AbstractSetIntStr | MappingIntStrAny | None)

  • exclude (AbstractSetIntStr | MappingIntStrAny | None)

  • by_alias (bool)

  • skip_defaults (bool | None)

  • exclude_unset (bool)

  • exclude_defaults (bool)

  • exclude_none (bool)

返回类型:

DictStrAny

classmethod from_orm(obj: Any) → Model#
参数:

obj (Any)

返回类型:

Model

json(
*,
include: AbstractSetIntStr | MappingIntStrAny | None = None,
exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
by_alias: bool = False,
skip_defaults: bool | None = None,
exclude_unset: bool = False,
exclude_defaults: bool = False,
exclude_none: bool = False,
encoder: Callable[[Any], Any] | None = None,
models_as_dict: bool = True,
**dumps_kwargs: Any,
) → str#

生成模型的 JSON 表示，参数 include 和 exclude 的用法与 dict() 相同。

encoder 是一个可选函数，用作 json.dumps() 的 default 参数；其他参数与 json.dumps() 相同。

参数:

  • include (AbstractSetIntStr | MappingIntStrAny | None)

  • exclude (AbstractSetIntStr | MappingIntStrAny | None)

  • by_alias (bool)

  • skip_defaults (bool | None)

  • exclude_unset (bool)

  • exclude_defaults (bool)

  • exclude_none (bool)

  • encoder (Callable[[Any], Any] | None)

  • models_as_dict (bool)

  • dumps_kwargs (Any)

返回类型:

str

classmethod parse_file(
path: str | Path,
*,
content_type: str = None,
encoding: str = 'utf8',
proto: Protocol = None,
allow_pickle: bool = False,
) → Model#
参数:

  • path (str | Path)

  • content_type (str)

  • encoding (str)

  • proto (Protocol)

  • allow_pickle (bool)

返回类型:

Model

classmethod parse_obj(obj: Any) → Model#
参数:

obj (Any)

返回类型:

Model

classmethod parse_raw(
b: str | bytes,
*,
content_type: str = None,
encoding: str = 'utf8',
proto: Protocol = None,
allow_pickle: bool = False,
) → Model#
参数:

  • b (str | bytes)

  • content_type (str)

  • encoding (str)

  • proto (Protocol)

  • allow_pickle (bool)

返回类型:

Model

classmethod schema(
by_alias: bool = True,
ref_template: str = '#/definitions/{model}',
) → DictStrAny#
参数:

  • by_alias (bool)

  • ref_template (str)

返回类型:

DictStrAny

classmethod schema_json(
*,
by_alias: bool = True,
ref_template: str = '#/definitions/{model}',
**dumps_kwargs: Any,
) → str#
参数:

  • by_alias (bool)

  • ref_template (str)

  • dumps_kwargs (Any)

返回类型:

str

classmethod update_forward_refs(**localns: Any) → None#

尝试根据此模型、globalns 和 localns 的字段更新 ForwardRefs。

参数:

localns (Any)

返回类型:

None

classmethod validate(value: Any) → Model#
参数:

value (Any)

返回类型:

Model