langfuse.api

 9class AccessDeniedError(ApiError):
10    def __init__(self, body: typing.Any):
11        super().__init__(status_code=403, body=body)

11class BaseEvent(pydantic_v1.BaseModel):
12    id: str = pydantic_v1.Field()
13    """
14    UUID v4 that identifies the event
15    """
16
17    timestamp: str = pydantic_v1.Field()
18    """
19    Datetime (ISO 8601) of event creation in client. Should be as close to actual event creation in client as possible, this timestamp will be used for ordering of events in future release. Resolution: milliseconds (required), microseconds (optimal).
20    """
21
22    metadata: typing.Optional[typing.Any] = pydantic_v1.Field(default=None)
23    """
24    Optional. Metadata field used by the Langfuse SDKs for debugging.
25    """
26
27    def json(self, **kwargs: typing.Any) -> str:
28        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
29        return super().json(**kwargs_with_defaults)
30
31    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
32        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
33        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
34
35        return deep_union_pydantic_dicts(
36            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
37        )
38
39    class Config:
40        frozen = True
41        smart_union = True
42        extra = pydantic_v1.Extra.allow
43        json_encoders = {dt.datetime: serialize_datetime}

39    class Config:
40        frozen = True
41        smart_union = True
42        extra = pydantic_v1.Extra.allow
43        json_encoders = {dt.datetime: serialize_datetime}

11class BasePrompt(pydantic_v1.BaseModel):
12    name: str
13    version: int
14    config: typing.Any
15    labels: typing.List[str] = pydantic_v1.Field()
16    """
17    List of deployment labels of this prompt version.
18    """
19
20    tags: typing.List[str] = pydantic_v1.Field()
21    """
22    List of tags. Used to filter via UI and API. The same across versions of a prompt.
23    """
24
25    def json(self, **kwargs: typing.Any) -> str:
26        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
27        return super().json(**kwargs_with_defaults)
28
29    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
30        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
31        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
32
33        return deep_union_pydantic_dicts(
34            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
35        )
36
37    class Config:
38        frozen = True
39        smart_union = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

37    class Config:
38        frozen = True
39        smart_union = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

12class BaseScore(pydantic_v1.BaseModel):
13    id: str
14    trace_id: str = pydantic_v1.Field(alias="traceId")
15    name: str
16    source: ScoreSource
17    observation_id: typing.Optional[str] = pydantic_v1.Field(alias="observationId", default=None)
18    timestamp: dt.datetime
19    created_at: dt.datetime = pydantic_v1.Field(alias="createdAt")
20    updated_at: dt.datetime = pydantic_v1.Field(alias="updatedAt")
21    author_user_id: typing.Optional[str] = pydantic_v1.Field(alias="authorUserId", default=None)
22    comment: typing.Optional[str] = None
23    config_id: typing.Optional[str] = pydantic_v1.Field(alias="configId", default=None)
24    """
25    Reference a score config on a score. When set, config and score name must be equal and value must comply to optionally defined numerical range
26    """
27
28    def json(self, **kwargs: typing.Any) -> str:
29        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
30        return super().json(**kwargs_with_defaults)
31
32    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
33        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
34        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
35
36        return deep_union_pydantic_dicts(
37            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
38        )
39
40    class Config:
41        frozen = True
42        smart_union = True
43        allow_population_by_field_name = True
44        populate_by_name = True
45        extra = pydantic_v1.Extra.allow
46        json_encoders = {dt.datetime: serialize_datetime}

40    class Config:
41        frozen = True
42        smart_union = True
43        allow_population_by_field_name = True
44        populate_by_name = True
45        extra = pydantic_v1.Extra.allow
46        json_encoders = {dt.datetime: serialize_datetime}

12class BooleanScore(BaseScore):
13    value: float = pydantic_v1.Field()
14    """
15    The numeric value of the score. Equals 1 for "True" and 0 for "False"
16    """
17
18    string_value: str = pydantic_v1.Field(alias="stringValue")
19    """
20    The string representation of the score value. Is inferred from the numeric value and equals "True" or "False"
21    """
22
23    def json(self, **kwargs: typing.Any) -> str:
24        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
25        return super().json(**kwargs_with_defaults)
26
27    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
28        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
29        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
30
31        return deep_union_pydantic_dicts(
32            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
33        )
34
35    class Config:
36        frozen = True
37        smart_union = True
38        allow_population_by_field_name = True
39        populate_by_name = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

35    class Config:
36        frozen = True
37        smart_union = True
38        allow_population_by_field_name = True
39        populate_by_name = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

12class CategoricalScore(BaseScore):
13    value: typing.Optional[float] = pydantic_v1.Field(default=None)
14    """
15    Only defined if a config is linked. Represents the numeric category mapping of the stringValue
16    """
17
18    string_value: str = pydantic_v1.Field(alias="stringValue")
19    """
20    The string representation of the score value. If no config is linked, can be any string. Otherwise, must map to a config category
21    """
22
23    def json(self, **kwargs: typing.Any) -> str:
24        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
25        return super().json(**kwargs_with_defaults)
26
27    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
28        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
29        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
30
31        return deep_union_pydantic_dicts(
32            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
33        )
34
35    class Config:
36        frozen = True
37        smart_union = True
38        allow_population_by_field_name = True
39        populate_by_name = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

35    class Config:
36        frozen = True
37        smart_union = True
38        allow_population_by_field_name = True
39        populate_by_name = True
40        extra = pydantic_v1.Extra.allow
41        json_encoders = {dt.datetime: serialize_datetime}

11class ChatMessage(pydantic_v1.BaseModel):
12    role: str
13    content: str
14
15    def json(self, **kwargs: typing.Any) -> str:
16        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
17        return super().json(**kwargs_with_defaults)
18
19    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
20        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
21        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
22
23        return deep_union_pydantic_dicts(
24            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
25        )
26
27    class Config:
28        frozen = True
29        smart_union = True
30        extra = pydantic_v1.Extra.allow
31        json_encoders = {dt.datetime: serialize_datetime}

27    class Config:
28        frozen = True
29        smart_union = True
30        extra = pydantic_v1.Extra.allow
31        json_encoders = {dt.datetime: serialize_datetime}

13class ChatPrompt(BasePrompt):
14    prompt: typing.List[ChatMessage]
15
16    def json(self, **kwargs: typing.Any) -> str:
17        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
18        return super().json(**kwargs_with_defaults)
19
20    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
21        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
22        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
23
24        return deep_union_pydantic_dicts(
25            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
26        )
27
28    class Config:
29        frozen = True
30        smart_union = True
31        allow_population_by_field_name = True
32        populate_by_name = True
33        extra = pydantic_v1.Extra.allow
34        json_encoders = {dt.datetime: serialize_datetime}

28    class Config:
29        frozen = True
30        smart_union = True
31        allow_population_by_field_name = True
32        populate_by_name = True
33        extra = pydantic_v1.Extra.allow
34        json_encoders = {dt.datetime: serialize_datetime}

11class ConfigCategory(pydantic_v1.BaseModel):
12    value: float
13    label: str
14
15    def json(self, **kwargs: typing.Any) -> str:
16        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
17        return super().json(**kwargs_with_defaults)
18
19    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
20        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
21        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
22
23        return deep_union_pydantic_dicts(
24            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
25        )
26
27    class Config:
28        frozen = True
29        smart_union = True
30        extra = pydantic_v1.Extra.allow
31        json_encoders = {dt.datetime: serialize_datetime}

27    class Config:
28        frozen = True
29        smart_union = True
30        extra = pydantic_v1.Extra.allow
31        json_encoders = {dt.datetime: serialize_datetime}

12class CreateChatPromptRequest(pydantic_v1.BaseModel):
13    name: str
14    prompt: typing.List[ChatMessage]
15    config: typing.Optional[typing.Any] = None
16    labels: typing.Optional[typing.List[str]] = pydantic_v1.Field(default=None)
17    """
18    List of deployment labels of this prompt version.
19    """
20
21    tags: typing.Optional[typing.List[str]] = pydantic_v1.Field(default=None)
22    """
23    List of tags to apply to all versions of this prompt.
24    """
25
26    def json(self, **kwargs: typing.Any) -> str:
27        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
28        return super().json(**kwargs_with_defaults)
29
30    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
31        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
32        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
33
34        return deep_union_pydantic_dicts(
35            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
36        )
37
38    class Config:
39        frozen = True
40        smart_union = True
41        extra = pydantic_v1.Extra.allow
42        json_encoders = {dt.datetime: serialize_datetime}

38    class Config:
39        frozen = True
40        smart_union = True
41        extra = pydantic_v1.Extra.allow
42        json_encoders = {dt.datetime: serialize_datetime}

12class CreateDatasetItemRequest(pydantic_v1.BaseModel):
13    dataset_name: str = pydantic_v1.Field(alias="datasetName")
14    input: typing.Optional[typing.Any] = None
15    expected_output: typing.Optional[typing.Any] = pydantic_v1.Field(alias="expectedOutput", default=None)
16    metadata: typing.Optional[typing.Any] = None
17    source_trace_id: typing.Optional[str] = pydantic_v1.Field(alias="sourceTraceId", default=None)
18    source_observation_id: typing.Optional[str] = pydantic_v1.Field(alias="sourceObservationId", default=None)
19    id: typing.Optional[str] = pydantic_v1.Field(default=None)
20    """
21    Dataset items are upserted on their id. Id needs to be unique (project-level) and cannot be reused across datasets.
22    """
23
24    status: typing.Optional[DatasetStatus] = pydantic_v1.Field(default=None)
25    """
26    Defaults to ACTIVE for newly created items
27    """
28
29    def json(self, **kwargs: typing.Any) -> str:
30        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
31        return super().json(**kwargs_with_defaults)
32
33    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
34        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
35        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
36
37        return deep_union_pydantic_dicts(
38            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
39        )
40
41    class Config:
42        frozen = True
43        smart_union = True
44        allow_population_by_field_name = True
45        populate_by_name = True
46        extra = pydantic_v1.Extra.allow
47        json_encoders = {dt.datetime: serialize_datetime}

41    class Config:
42        frozen = True
43        smart_union = True
44        allow_population_by_field_name = True
45        populate_by_name = True
46        extra = pydantic_v1.Extra.allow
47        json_encoders = {dt.datetime: serialize_datetime}

11class CreateDatasetRequest(pydantic_v1.BaseModel):
12    name: str
13    description: typing.Optional[str] = None
14    metadata: typing.Optional[typing.Any] = None
15
16    def json(self, **kwargs: typing.Any) -> str:
17        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
18        return super().json(**kwargs_with_defaults)
19
20    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
21        kwargs_with_defaults_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
22        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
23
24        return deep_union_pydantic_dicts(
25            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
26        )
27
28    class Config:
29        frozen = True
30        smart_union = True
31        extra = pydantic_v1.Extra.allow
32        json_encoders = {dt.datetime: serialize_datetime}