arize-phoenix 5.5.2__py3-none-any.whl → 5.7.0__py3-none-any.whl

phoenix/server/api/helpers/playground_registry.py

@@ -0,0 +1,70 @@
+from typing import TYPE_CHECKING, Any, Callable, Optional, Union
+
+from phoenix.server.api.types.GenerativeProvider import GenerativeProviderKey
+
+if TYPE_CHECKING:
+    from phoenix.server.api.helpers.playground_clients import PlaygroundStreamingClient
+
+ModelName = Union[str, None]
+ModelKey = tuple[GenerativeProviderKey, ModelName]
+
+PROVIDER_DEFAULT = None
+
+
+class SingletonMeta(type):
+    _instances: dict[Any, Any] = dict()
+
+    def __call__(cls, *args: Any, **kwargs: Any) -> Any:
+        if cls not in cls._instances:
+            cls._instances[cls] = super(SingletonMeta, cls).__call__(*args, **kwargs)
+        return cls._instances[cls]
+
+
+class PlaygroundClientRegistry(metaclass=SingletonMeta):
+    def __init__(self) -> None:
+        self._registry: dict[
+            GenerativeProviderKey, dict[ModelName, Optional[type["PlaygroundStreamingClient"]]]
+        ] = {}
+
+    def get_client(
+        self,
+        provider_key: GenerativeProviderKey,
+        model_name: ModelName,
+    ) -> Optional[type["PlaygroundStreamingClient"]]:
+        provider_registry = self._registry.get(provider_key, {})
+        client_class = provider_registry.get(model_name)
+        if client_class is None and None in provider_registry:
+            client_class = provider_registry[PROVIDER_DEFAULT]  # Fallback to provider default
+        return client_class
+
+    def list_all_providers(
+        self,
+    ) -> list[GenerativeProviderKey]:
+        return [provider_key for provider_key in self._registry]
+
+    def list_models(self, provider_key: GenerativeProviderKey) -> list[str]:
+        provider_registry = self._registry.get(provider_key, {})
+        return [model_name for model_name in provider_registry.keys() if model_name is not None]
+
+    def list_all_models(self) -> list[ModelKey]:
+        return [
+            (provider_key, model_name)
+            for provider_key, provider_registry in self._registry.items()
+            for model_name in provider_registry.keys()
+        ]
+
+
+PLAYGROUND_CLIENT_REGISTRY: PlaygroundClientRegistry = PlaygroundClientRegistry()
+
+
+def register_llm_client(
+    provider_key: GenerativeProviderKey,
+    model_names: list[ModelName],
+) -> Callable[[type["PlaygroundStreamingClient"]], type["PlaygroundStreamingClient"]]:
+    def decorator(cls: type["PlaygroundStreamingClient"]) -> type["PlaygroundStreamingClient"]:
+        provider_registry = PLAYGROUND_CLIENT_REGISTRY._registry.setdefault(provider_key, {})
+        for model_name in model_names:
+            provider_registry[model_name] = cls
+        return cls
+
+    return decorator

phoenix/server/api/helpers/playground_spans.py

@@ -0,0 +1,325 @@
+import json
+from collections import defaultdict
+from collections.abc import Mapping
+from dataclasses import asdict
+from datetime import datetime, timezone
+from itertools import chain
+from traceback import format_exc
+from types import TracebackType
+from typing import (
+    Any,
+    Iterable,
+    Iterator,
+    Optional,
+    Union,
+    cast,
+)
+
+from openinference.instrumentation import safe_json_dumps
+from openinference.semconv.trace import (
+    MessageAttributes,
+    OpenInferenceMimeTypeValues,
+    OpenInferenceSpanKindValues,
+    SpanAttributes,
+    ToolAttributes,
+    ToolCallAttributes,
+)
+from opentelemetry.sdk.trace.id_generator import RandomIdGenerator as DefaultOTelIDGenerator
+from opentelemetry.trace import StatusCode
+from sqlalchemy.ext.asyncio import AsyncSession
+from strawberry.scalars import JSON as JSONScalarType
+from typing_extensions import Self, TypeAlias, assert_never
+
+from phoenix.datetime_utils import local_now, normalize_datetime
+from phoenix.db import models
+from phoenix.server.api.input_types.ChatCompletionInput import (
+    ChatCompletionInput,
+    ChatCompletionOverDatasetInput,
+)
+from phoenix.server.api.types.ChatCompletionMessageRole import ChatCompletionMessageRole
+from phoenix.server.api.types.ChatCompletionSubscriptionPayload import (
+    TextChunk,
+    ToolCallChunk,
+)
+from phoenix.trace.attributes import unflatten
+from phoenix.trace.schemas import (
+    SpanEvent,
+    SpanException,
+)
+from phoenix.utilities.json import jsonify
+
+ChatCompletionMessage: TypeAlias = tuple[
+    ChatCompletionMessageRole, str, Optional[str], Optional[list[str]]
+]
+ToolCallID: TypeAlias = str
+
+
+class streaming_llm_span:
+    """
+    Creates an LLM span for a streaming chat completion.
+    """
+
+    def __init__(
+        self,
+        *,
+        input: Union[ChatCompletionInput, ChatCompletionOverDatasetInput],
+        messages: list[ChatCompletionMessage],
+        invocation_parameters: Mapping[str, Any],
+        attributes: Optional[dict[str, Any]] = None,
+    ) -> None:
+        self._input = input
+        self._attributes: dict[str, Any] = attributes if attributes is not None else {}
+        self._attributes.update(
+            chain(
+                _llm_span_kind(),
+                _llm_model_name(input.model.name),
+                _llm_tools(input.tools or []),
+                _llm_input_messages(messages),
+                _llm_invocation_parameters(invocation_parameters),
+                _input_value_and_mime_type(input),
+            )
+        )
+        self._events: list[SpanEvent] = []
+        self._start_time: datetime
+        self._end_time: datetime
+        self._response_chunks: list[Union[TextChunk, ToolCallChunk]] = []
+        self._text_chunks: list[TextChunk] = []
+        self._tool_call_chunks: defaultdict[ToolCallID, list[ToolCallChunk]] = defaultdict(list)
+        self._status_code: StatusCode
+        self._status_message: str
+        self._db_span: models.Span
+        self._db_trace: models.Trace
+
+    async def __aenter__(self) -> Self:
+        self._start_time = cast(datetime, normalize_datetime(dt=local_now(), tz=timezone.utc))
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[type[BaseException]],
+        exc_value: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> bool:
+        self._end_time = cast(datetime, normalize_datetime(dt=local_now(), tz=timezone.utc))
+        self._status_code = StatusCode.OK
+        self._status_message = ""
+        if exc_type is not None:
+            self._status_code = StatusCode.ERROR
+            self._status_message = str(exc_value)
+            self._events.append(
+                SpanException(
+                    timestamp=self._end_time,
+                    message=self._status_message,
+                    exception_type=type(exc_value).__name__,
+                    exception_escaped=False,
+                    exception_stacktrace=format_exc(),
+                )
+            )
+        if self._response_chunks:
+            self._attributes.update(
+                chain(
+                    _output_value_and_mime_type(self._response_chunks),
+                    _llm_output_messages(self._text_chunks, self._tool_call_chunks),
+                )
+            )
+        return True
+
+    def set_attributes(self, attributes: Mapping[str, Any]) -> None:
+        self._attributes.update(attributes)
+
+    def add_to_session(
+        self,
+        session: AsyncSession,
+        project_id: int,
+    ) -> models.Span:
+        prompt_tokens = self._attributes.get(LLM_TOKEN_COUNT_PROMPT, 0)
+        completion_tokens = self._attributes.get(LLM_TOKEN_COUNT_COMPLETION, 0)
+        trace_id = _generate_trace_id()
+        span_id = _generate_span_id()
+        self._db_trace = models.Trace(
+            project_rowid=project_id,
+            trace_id=trace_id,
+            start_time=self._start_time,
+            end_time=self._end_time,
+        )
+        self._db_span = models.Span(
+            trace_rowid=self._db_trace.id,
+            span_id=span_id,
+            parent_id=None,
+            name="ChatCompletion",
+            span_kind=LLM,
+            start_time=self._start_time,
+            end_time=self._end_time,
+            attributes=unflatten(self._attributes.items()),
+            events=[_serialize_event(event) for event in self._events],
+            status_code=self._status_code.name,
+            status_message=self._status_message,
+            cumulative_error_count=int(self._status_code is StatusCode.ERROR),
+            cumulative_llm_token_count_prompt=prompt_tokens,
+            cumulative_llm_token_count_completion=completion_tokens,
+            llm_token_count_prompt=prompt_tokens,
+            llm_token_count_completion=completion_tokens,
+            trace=self._db_trace,
+        )
+        session.add(self._db_trace)
+        session.add(self._db_span)
+        return self._db_span
+
+    def add_response_chunk(self, chunk: Union[TextChunk, ToolCallChunk]) -> None:
+        self._response_chunks.append(chunk)
+        if isinstance(chunk, TextChunk):
+            self._text_chunks.append(chunk)
+        elif isinstance(chunk, ToolCallChunk):
+            self._tool_call_chunks[chunk.id].append(chunk)
+        else:
+            assert_never(chunk)
+
+    @property
+    def start_time(self) -> datetime:
+        return self._db_span.start_time
+
+    @property
+    def end_time(self) -> datetime:
+        return self._db_span.end_time
+
+    @property
+    def error_message(self) -> Optional[str]:
+        return self._status_message if self._status_code is StatusCode.ERROR else None
+
+    @property
+    def trace_id(self) -> str:
+        return self._db_trace.trace_id
+
+    @property
+    def attributes(self) -> dict[str, Any]:
+        return self._db_span.attributes
+
+
+def _llm_span_kind() -> Iterator[tuple[str, Any]]:
+    yield OPENINFERENCE_SPAN_KIND, LLM
+
+
+def _llm_model_name(model_name: str) -> Iterator[tuple[str, Any]]:
+    yield LLM_MODEL_NAME, model_name
+
+
+def _llm_invocation_parameters(
+    invocation_parameters: Mapping[str, Any],
+) -> Iterator[tuple[str, Any]]:
+    if invocation_parameters:
+        yield LLM_INVOCATION_PARAMETERS, safe_json_dumps(invocation_parameters)
+
+
+def _llm_tools(tools: list[JSONScalarType]) -> Iterator[tuple[str, Any]]:
+    for tool_index, tool in enumerate(tools):
+        yield f"{LLM_TOOLS}.{tool_index}.{TOOL_JSON_SCHEMA}", json.dumps(tool)
+
+
+def _input_value_and_mime_type(input: Any) -> Iterator[tuple[str, Any]]:
+    assert (api_key := "api_key") in (input_data := jsonify(input))
+    disallowed_keys = {"api_key", "invocation_parameters"}
+    input_data = {k: v for k, v in input_data.items() if k not in disallowed_keys}
+    assert api_key not in input_data
+    yield INPUT_MIME_TYPE, JSON
+    yield INPUT_VALUE, safe_json_dumps(input_data)
+
+
+def _output_value_and_mime_type(output: Any) -> Iterator[tuple[str, Any]]:
+    yield OUTPUT_MIME_TYPE, JSON
+    yield OUTPUT_VALUE, safe_json_dumps(jsonify(output))
+
+
+def _llm_input_messages(
+    messages: Iterable[
+        tuple[ChatCompletionMessageRole, str, Optional[str], Optional[list[JSONScalarType]]]
+    ],
+) -> Iterator[tuple[str, Any]]:
+    for i, (role, content, _tool_call_id, tool_calls) in enumerate(messages):
+        yield f"{LLM_INPUT_MESSAGES}.{i}.{MESSAGE_ROLE}", role.value.lower()
+        yield f"{LLM_INPUT_MESSAGES}.{i}.{MESSAGE_CONTENT}", content
+        if tool_calls is not None:
+            for tool_call_index, tool_call in enumerate(tool_calls):
+                yield (
+                    f"{LLM_INPUT_MESSAGES}.{i}.{MESSAGE_TOOL_CALLS}.{tool_call_index}.{TOOL_CALL_FUNCTION_NAME}",
+                    tool_call["function"]["name"],
+                )
+                if arguments := tool_call["function"]["arguments"]:
+                    yield (
+                        f"{LLM_INPUT_MESSAGES}.{i}.{MESSAGE_TOOL_CALLS}.{tool_call_index}.{TOOL_CALL_FUNCTION_ARGUMENTS_JSON}",
+                        safe_json_dumps(jsonify(arguments)),
+                    )
+
+
+def _llm_output_messages(
+    text_chunks: list[TextChunk],
+    tool_call_chunks: defaultdict[ToolCallID, list[ToolCallChunk]],
+) -> Iterator[tuple[str, Any]]:
+    yield f"{LLM_OUTPUT_MESSAGES}.0.{MESSAGE_ROLE}", "assistant"
+    if content := "".join(chunk.content for chunk in text_chunks):
+        yield f"{LLM_OUTPUT_MESSAGES}.0.{MESSAGE_CONTENT}", content
+    for tool_call_index, (_tool_call_id, tool_call_chunks_) in enumerate(tool_call_chunks.items()):
+        if tool_call_chunks_ and (name := tool_call_chunks_[0].function.name):
+            yield (
+                f"{LLM_OUTPUT_MESSAGES}.0.{MESSAGE_TOOL_CALLS}.{tool_call_index}.{TOOL_CALL_FUNCTION_NAME}",
+                name,
+            )
+        if arguments := "".join(chunk.function.arguments for chunk in tool_call_chunks_):
+            yield (
+                f"{LLM_OUTPUT_MESSAGES}.0.{MESSAGE_TOOL_CALLS}.{tool_call_index}.{TOOL_CALL_FUNCTION_ARGUMENTS_JSON}",
+                arguments,
+            )
+
+
+def _generate_trace_id() -> str:
+    """
+    Generates a random trace ID in hexadecimal format.
+    """
+    return _hex(DefaultOTelIDGenerator().generate_trace_id())
+
+
+def _generate_span_id() -> str:
+    """
+    Generates a random span ID in hexadecimal format.
+    """
+    return _hex(DefaultOTelIDGenerator().generate_span_id())
+
+
+def _hex(number: int) -> str:
+    """
+    Converts an integer to a hexadecimal string.
+    """
+    return hex(number)[2:]
+
+
+def _serialize_event(event: SpanEvent) -> dict[str, Any]:
+    """
+    Serializes a SpanEvent to a dictionary.
+    """
+    return {k: (v.isoformat() if isinstance(v, datetime) else v) for k, v in asdict(event).items()}
+
+
+JSON = OpenInferenceMimeTypeValues.JSON.value
+
+LLM = OpenInferenceSpanKindValues.LLM.value
+
+OPENINFERENCE_SPAN_KIND = SpanAttributes.OPENINFERENCE_SPAN_KIND
+INPUT_MIME_TYPE = SpanAttributes.INPUT_MIME_TYPE
+INPUT_VALUE = SpanAttributes.INPUT_VALUE
+OUTPUT_MIME_TYPE = SpanAttributes.OUTPUT_MIME_TYPE
+OUTPUT_VALUE = SpanAttributes.OUTPUT_VALUE
+LLM_INPUT_MESSAGES = SpanAttributes.LLM_INPUT_MESSAGES
+LLM_OUTPUT_MESSAGES = SpanAttributes.LLM_OUTPUT_MESSAGES
+LLM_MODEL_NAME = SpanAttributes.LLM_MODEL_NAME
+LLM_INVOCATION_PARAMETERS = SpanAttributes.LLM_INVOCATION_PARAMETERS
+LLM_TOOLS = SpanAttributes.LLM_TOOLS
+LLM_TOKEN_COUNT_PROMPT = SpanAttributes.LLM_TOKEN_COUNT_PROMPT
+LLM_TOKEN_COUNT_COMPLETION = SpanAttributes.LLM_TOKEN_COUNT_COMPLETION
+
+MESSAGE_CONTENT = MessageAttributes.MESSAGE_CONTENT
+MESSAGE_ROLE = MessageAttributes.MESSAGE_ROLE
+MESSAGE_TOOL_CALLS = MessageAttributes.MESSAGE_TOOL_CALLS
+
+TOOL_CALL_FUNCTION_NAME = ToolCallAttributes.TOOL_CALL_FUNCTION_NAME
+TOOL_CALL_FUNCTION_ARGUMENTS_JSON = ToolCallAttributes.TOOL_CALL_FUNCTION_ARGUMENTS_JSON
+
+TOOL_JSON_SCHEMA = ToolAttributes.TOOL_JSON_SCHEMA

phoenix/server/api/input_types/AddExamplesToDatasetInput.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import strawberry
 from strawberry import UNSET
@@ -11,6 +11,6 @@ from .DatasetExampleInput import DatasetExampleInput
 @strawberry.input
 class AddExamplesToDatasetInput:
     dataset_id: GlobalID
-    examples: List[DatasetExampleInput]
+    examples: list[DatasetExampleInput]
     dataset_version_description: Optional[str] = UNSET
     dataset_version_metadata: Optional[JSON] = UNSET

phoenix/server/api/input_types/AddSpansToDatasetInput.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import strawberry
 from strawberry import UNSET
@@ -9,6 +9,6 @@ from strawberry.scalars import JSON
 @strawberry.input
 class AddSpansToDatasetInput:
     dataset_id: GlobalID
-    span_ids: List[GlobalID]
+    span_ids: list[GlobalID]
     dataset_version_description: Optional[str] = UNSET
     dataset_version_metadata: Optional[JSON] = UNSET

phoenix/server/api/input_types/ChatCompletionInput.py

@@ -0,0 +1,38 @@
+from typing import Optional
+
+import strawberry
+from strawberry import UNSET
+from strawberry.relay.types import GlobalID
+from strawberry.scalars import JSON
+
+from phoenix.server.api.types.TemplateLanguage import TemplateLanguage
+
+from .ChatCompletionMessageInput import ChatCompletionMessageInput
+from .GenerativeModelInput import GenerativeModelInput
+from .InvocationParameters import InvocationParameterInput
+from .TemplateOptions import TemplateOptions
+
+
+@strawberry.input
+class ChatCompletionInput:
+    messages: list[ChatCompletionMessageInput]
+    model: GenerativeModelInput
+    invocation_parameters: list[InvocationParameterInput] = strawberry.field(default_factory=list)
+    tools: Optional[list[JSON]] = UNSET
+    api_key: Optional[str] = strawberry.field(default=None)
+    template: Optional[TemplateOptions] = UNSET
+
+
+@strawberry.input
+class ChatCompletionOverDatasetInput:
+    messages: list[ChatCompletionMessageInput]
+    model: GenerativeModelInput
+    invocation_parameters: list[InvocationParameterInput] = strawberry.field(default_factory=list)
+    tools: Optional[list[JSON]] = UNSET
+    api_key: Optional[str] = strawberry.field(default=None)
+    template_language: TemplateLanguage
+    dataset_id: GlobalID
+    dataset_version_id: Optional[GlobalID] = None
+    experiment_name: Optional[str] = None
+    experiment_description: Optional[str] = None
+    experiment_metadata: Optional[JSON] = strawberry.field(default_factory=dict)

phoenix/server/api/input_types/ChatCompletionMessageInput.py

@@ -1,4 +1,7 @@
+from typing import Optional
+
 import strawberry
+from strawberry import UNSET
 from strawberry.scalars import JSON
 
 from phoenix.server.api.types.ChatCompletionMessageRole import ChatCompletionMessageRole
@@ -8,5 +11,14 @@ from phoenix.server.api.types.ChatCompletionMessageRole import ChatCompletionMes
 class ChatCompletionMessageInput:
     role: ChatCompletionMessageRole
     content: JSON = strawberry.field(
-        description="The content of the message as JSON to support text and tools",
+        default="",
+        description="The content of the message as JSON to support various kinds of text",
+    )
+    tool_calls: Optional[list[JSON]] = strawberry.field(
+        description="The tool calls that were made in the message",
+        default=UNSET,
+    )
+    tool_call_id: Optional[str] = strawberry.field(
+        description="The ID that corresponds to a prior tool call. Used to link a tool message to a pre-existing tool call.",  # noqa: E501
+        default=UNSET,
     )

phoenix/server/api/input_types/ClusterInput.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import strawberry
 from strawberry import ID, UNSET
@@ -6,5 +6,5 @@ from strawberry import ID, UNSET
 
 @strawberry.input
 class ClusterInput:
-    event_ids: List[ID]
+    event_ids: list[ID]
     id: Optional[ID] = UNSET

phoenix/server/api/input_types/DeleteAnnotationsInput.py

@@ -1,9 +1,7 @@
-from typing import List
-
 import strawberry
 from strawberry.relay import GlobalID
 
 
 @strawberry.input
 class DeleteAnnotationsInput:
-    annotation_ids: List[GlobalID]
+    annotation_ids: list[GlobalID]

phoenix/server/api/input_types/DeleteDatasetExamplesInput.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import strawberry
 from strawberry import UNSET
@@ -8,6 +8,6 @@ from strawberry.scalars import JSON
 
 @strawberry.input
 class DeleteDatasetExamplesInput:
-    example_ids: List[GlobalID]
+    example_ids: list[GlobalID]
     dataset_version_description: Optional[str] = UNSET
     dataset_version_metadata: Optional[JSON] = UNSET

phoenix/server/api/input_types/DeleteExperimentsInput.py

@@ -1,9 +1,7 @@
-from typing import List
-
 import strawberry
 from strawberry.relay import GlobalID
 
 
 @strawberry.input
 class DeleteExperimentsInput:
-    experiment_ids: List[GlobalID]
+    experiment_ids: list[GlobalID]

phoenix/server/api/input_types/DimensionFilter.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import strawberry
 from strawberry import UNSET
@@ -52,9 +52,9 @@ class DimensionFilter:
 
     """
 
-    types: Optional[List[DimensionType]] = UNSET
-    shapes: Optional[List[DimensionShape]] = UNSET
-    data_types: Optional[List[DimensionDataType]] = UNSET
+    types: Optional[list[DimensionType]] = UNSET
+    shapes: Optional[list[DimensionShape]] = UNSET
+    data_types: Optional[list[DimensionDataType]] = UNSET
 
     def __post_init__(self) -> None:
         self.types = ensure_list(self.types)

phoenix/server/api/input_types/GenerativeModelInput.py

@@ -0,0 +1,17 @@
+from typing import Optional
+
+import strawberry
+from strawberry import UNSET
+
+from phoenix.server.api.types.GenerativeProvider import GenerativeProviderKey
+
+
+@strawberry.input
+class GenerativeModelInput:
+    provider_key: GenerativeProviderKey
+    name: str
+    """ The name of the model. Or the Deployment Name for Azure OpenAI models. """
+    endpoint: Optional[str] = UNSET
+    """ The endpoint to use for the model. Only required for Azure OpenAI models. """
+    api_version: Optional[str] = UNSET
+    """ The API version to use for the model. """

phoenix/server/api/input_types/Granularity.py

@@ -1,6 +1,6 @@
+from collections.abc import Iterator
 from datetime import datetime, timedelta
 from itertools import accumulate, repeat, takewhile
-from typing import Iterator
 
 import strawberry