` | Table wrapper |
| `th` | `| ` | Header cell CSS |
| `td` | ` | ` | Data cell CSS |
| `img` | `![]() ` | Image CSS |
| `hr` | `
` | Horizontal rule CSS |
```typescript
blockquote: ({ children, className }) => (
{children}
),
inlineCode: ({ children, className }) => (
{children}
),
```
资料来源：[app/src/components/markdown/streamdownComponents.tsx:1-60]()
### Playground Components
#### PromptMenu
Tabbed interface for managing prompt versions and tags. Uses lazy-loaded tabs for performance.
```typescript
```
| Tab | Content |
|-----|---------|
| Versions | Prompt version history |
| Tags | Tag management |
资料来源：[app/src/pages/playground/PromptMenu.tsx:1-80]()
### Tool Components
#### DocsToolDetails
Renders documentation tool outputs with state-based display logic.
```typescript
function getOutputText(part: ToolInvocationPart): string {
if (part.state !== "output-available" || part.output == null) {
return "";
}
return stringifyToolValue(part.output);
}
// Preview truncation for long outputs
export function truncateDocsOutput(text: string): string {
if (text.length <= OUTPUT_PREVIEW_LENGTH) {
return text;
}
return text.slice(0, OUTPUT_PREVIEW_LENGTH) + "…";
}
```
资料来源：[app/src/components/agent/DocsToolDetails.tsx:1-100]()
### UI Components
#### Icons
SVG icon components using `currentColor` for theme compatibility.
```typescript
export const ArrowCompareOutline = () => (
);
```
Available icons include: `ArrowCompareOutline`, `TemplateOutline`, `FileOutline`, `CloseOutline`, and more.
资料来源：[app/src/components/core/icon/Icons.tsx:1-50]()
#### FileListItem
Reusable file upload item component with progress tracking and status indicators.
| Status | Description |
|--------|-------------|
| `uploading` | File transfer in progress |
| `parsing` | File content being processed |
| `complete` | Upload and parse successful |
| `error` | Upload or parse failed |
```typescript
const showProgress = status !== "complete" && progress !== undefined;
return (
);
```
资料来源：[app/src/components/core/dropzone/FileListItem.tsx:1-70]()
## Context Providers
### Provider Hierarchy
```mermaid
graph TD
A[TracingRoot] --> B[TracePaginationProvider]
B --> C[SpanFiltersProvider]
C --> D[TracesTabContent]
E[IsAuthenticated] --> F[IsAdmin]
F --> G[GenerateAPIKeyButton]
```
| Provider | Purpose |
|----------|---------|
| `TracingRoot` | Global tracing state |
| `TracePaginationProvider` | Pagination state for traces |
| `SpanFiltersProvider` | Filter state for span queries |
| `IsAuthenticated` | Authentication state check |
| `IsAdmin` | Authorization check |
## Environment Configuration
### Phoenix Environment Variables
The frontend reads configuration from environment variables via the `@arizeai/phoenix-config` package.
| Variable | Constant | Description |
|----------|----------|-------------|
| `PHOENIX_HOST` | `ENV_PHOENIX_HOST` | Phoenix server host URL |
| `PHOENIX_API_KEY` | `ENV_PHOENIX_API_KEY` | API key for authentication |
| `PHOENIX_CLIENT_HEADERS` | `ENV_PHOENIX_CLIENT_HEADERS` | JSON-encoded custom headers |
| `PHOENIX_COLLECTOR_ENDPOINT` | `ENV_PHOENIX_COLLECTOR_ENDPOINT` | OTel collector endpoint |
| `PHOENIX_PORT` | `ENV_PHOENIX_PORT` | Phoenix HTTP port |
| `PHOENIX_GRPC_PORT` | `ENV_PHOENIX_GRPC_PORT` | Phoenix gRPC port |
| `PHOENIX_PROJECT` | `ENV_PHOENIX_PROJECT` | Default project name |
资料来源：[js/packages/phoenix-config/README.md:1-50]()
### Runtime Configuration
```typescript
const isHosted = IS_HOSTED_DEPLOYMENT;
const isAuthEnabled = window.Config.authenticationEnabled;
```
## Data Flow
### Trace Navigation Flow
```mermaid
sequenceDiagram
participant User
participant TracesTable
participant ProjectTracesPage
participant API
User->>TracesTable: Click trace row
TracesTable->>TracesTable: Get row trace data
TracesTable->>User: Navigate to trace detail
User->>ProjectTracesPage: Load trace by ID
ProjectTracesPage->>API: Fetch trace data
API-->>ProjectTracesPage: Return trace
ProjectTracesPage-->>User: Render TraceTree
```
### Annotation Flow
```mermaid
graph LR
A[TraceView] --> B[AnnotationLabel]
B --> C[AnnotationTooltip]
C --> D[External Link]
D --> E[Trace Detail]
A --> F[AnnotationConfigList]
F --> G[Create Annotation]
```
## Package Dependencies
### Key Dependencies
| Package | Version Constraint | Purpose |
|---------|-------------------|---------|
| `react` | `>=18.0.0` | Core framework |
| `react-router-dom` | `>=6.0.0` | Routing |
| `@tanstack/react-table` | Latest | Data tables |
| `@adobe/react-spectrum` | Latest | UI components |
| `@arizeai/phoenix-evals` | Latest | Evaluation functions |
| `@arizeai/phoenix-config` | Latest | Config utilities |
资料来源：[app/package.json:1-50]()
## Best Practices
### Component Patterns
1. **Lazy Loading**: Use `Suspense` with lazy-loaded components for route-based code splitting
2. **Context Composition**: Wrap related state in dedicated providers
3. **Type Safety**: Use TypeScript interfaces for all component props
4. **CSS Organization**: Use CSS-in-JS with semantic class naming
### Performance Considerations
- Implement virtual scrolling for large trace lists
- Use `React.memo` for expensive component re-renders
- Lazy load tab panels in tabbed interfaces
- Truncate long outputs in preview contexts
```typescript
export function truncateDocsOutput(text: string): string {
if (text.length <= OUTPUT_PREVIEW_LENGTH) {
return text;
}
return text.slice(0, OUTPUT_PREVIEW_LENGTH) + "…";
}
---
## Server API and GraphQL
### 相关页面
相关主题：[System Architecture](#page-system-architecture), [Database Models and Migrations](#page-database-models)
相关源码文件
以下源码文件用于生成本页说明：
- [src/phoenix/server/__init__.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/server/__init__.py)
- [src/phoenix/server/api/context.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/server/api/context.py)
- [src/phoenix/server/api/auth.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/server/api/auth.py)
- [src/phoenix/server/api/dataloaders/__init__.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/server/api/dataloaders/__init__.py)
- [src/phoenix/server/api/routers/__init__.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/server/api/routers/__init__.py)
# Server API and GraphQL
Phoenix provides a comprehensive server API layer built on GraphQL (via Strawberry) and REST endpoints for managing traces, experiments, datasets, and evaluations. The API architecture is designed for observability, authentication, and efficient data loading.
## Architecture Overview
Phoenix's server API follows a layered architecture that separates concerns between request handling, authentication, data access, and response rendering.
```mermaid
graph TD
A[Client Request] --> B[API Router Layer]
B --> C[Authentication Middleware]
C --> D[Context Builder]
D --> E[GraphQL Executor / REST Handler]
E --> F[Data Loaders]
F --> G[Database / Storage]
G --> H[Response]
```
## Core Components
### Server Initialization
The main server module (`src/phoenix/server/__init__.py`) orchestrates the application lifecycle, including database initialization, API router setup, and background task management.
| Component | Purpose | Key Responsibilities |
|-----------|---------|---------------------|
| `Server` | Main application class | Initialize app, setup routes, manage lifecycle |
| `App` | ASGI application | Handle HTTP/WebSocket connections |
| `Database` | Data persistence | SQLite/PostgreSQL connection management |
资料来源：[src/phoenix/server/__init__.py:1-50]()
### Request Context
The context module (`src/phoenix/server/api/context.py`) provides request-scoped data access throughout the API layer. It manages database sessions, user authentication, and configuration access.
```python
class Context:
def __init__(
self,
db: Session,
user: User | None,
data_loaders: dict[str, DataLoader],
) -> None:
self.db = db
self.user = user
self.data_loaders = data_loaders
```
**Key Context Properties:**
| Property | Type | Description |
|----------|------|-------------|
| `db` | `Session` | SQLAlchemy database session |
| `user` | `User \| None` | Authenticated user or anonymous |
| `data_loaders` | `dict[str, DataLoader]` | Batch data loading utilities |
| `has_auth` | `bool` | Whether authentication is enabled |
资料来源：[src/phoenix/server/api/context.py:1-100]()
## Authentication System
The authentication module (`src/phoenix/server/api/auth.py`) implements token-based authentication for API access.
### Authentication Flow
```mermaid
sequenceDiagram
participant Client
participant API
participant Auth
participant DB
Client->>API: Request + API Key
API->>Auth: Validate Token
Auth->>DB: Lookup User
DB-->>Auth: User Record
Auth-->>API: Authenticated Context
API-->>Client: Response with Context
```
### Authentication Methods
| Method | Header | Description |
|--------|--------|-------------|
| API Key | `Authorization: Bearer ` | Token-based authentication |
| Session | Cookie-based | Web UI authentication |
| Anonymous | None | Read-only access when auth disabled |
### Permission Classes
Phoenix enforces permission checks on mutations and subscriptions:
- `IsNotReadOnly` - Prevents read-only users from modifying data
- `IsNotViewer` - Prevents viewer roles from write operations
资料来源：[src/phoenix/server/api/auth.py:1-80]()
## GraphQL Schema
Phoenix uses Strawberry GraphQL for its primary API surface, enabling type-safe queries and mutations with automatic documentation.
### Schema Structure
```
Query
├── datasets
│ ├── get_dataset
│ └── get_dataset_by_id
├── experiments
│ ├── experiments
│ └── experiment_by_id
├── projects
│ ├── projects
│ └── project_by_id
├── spans
│ └── get_spans
└── traces
└── get_traces
Mutation
├── datasets
│ ├── create_dataset
│ ├── upload_dataset
│ └── delete_dataset
├── experiments
│ ├── create_experiment
│ └── run_experiment
├── spans
│ └── create_span_annotation
└── traces
└── create_trace_annotation
```
### Data Loaders
Data loaders (`src/phoenix/server/api/dataloaders/`) implement the N+1 query problem solution through batch loading and caching within request scope.
```python
class DatasetLoader(DataLoader[int, Dataset]):
def batch_load(self, dataset_ids: list[int]) -> list[Dataset]:
# Single database query for all IDs
datasets = self.db.query(Dataset).filter(Dataset.id.in_(dataset_ids)).all()
return datasets
```
| DataLoader | Purpose |
|------------|---------|
| `DatasetLoader` | Batch load datasets by ID |
| `ProjectLoader` | Batch load projects by ID |
| `SpanLoader` | Batch load spans by ID |
| `AnnotationLoader` | Batch load annotations |
| `UserLoader` | Batch load user records |
资料来源：[src/phoenix/server/api/dataloaders/__init__.py:1-50]()
## REST API Endpoints
### API Router Structure
```python
# src/phoenix/server/api/routers/__init__.py
routers = [
datasets_router,
experiments_router,
spans_router,
traces_router,
evaluations_router,
]
```
### Dataset Endpoints
| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/v1/datasets` | List all datasets |
| `POST` | `/v1/datasets` | Create new dataset |
| `GET` | `/v1/datasets/{id}` | Get dataset by ID |
| `PUT` | `/v1/datasets/{id}` | Update dataset |
| `DELETE` | `/v1/datasets/{id}` | Delete dataset |
| `POST` | `/v1/datasets/{id}/upload` | Upload data to dataset |
### Experiment Endpoints
| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/v1/experiments` | List experiments |
| `POST` | `/v1/experiments` | Create experiment |
| `GET` | `/v1/experiments/{id}` | Get experiment details |
| `POST` | `/v1/experiments/{id}/run` | Run experiment evaluation |
### Span and Trace Endpoints
| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/v1/spans` | Query spans with filtering |
| `POST` | `/v1/spans/{id}/annotations` | Add span annotation |
| `GET` | `/v1/traces` | Query traces |
| `POST` | `/v1/traces/{id}/annotations` | Add trace annotation |
资料来源：[src/phoenix/server/api/routers/__init__.py:1-30]()
## OpenAPI Schema
Phoenix exposes its REST API through an OpenAPI schema that can be compiled for documentation and client generation:
```bash
python scripts/ci/compile_openapi_schema.py
```
This generates the schema at `openapi-schema.json` for validation and client SDK generation.
资料来源：[scripts/README.md:1-50]()
## Environment Variables
The API server recognizes the following configuration variables:
| Variable | Description | Default |
|----------|-------------|---------|
| `PHOENIX_HOST` | Server host URL | `http://localhost:6006` |
| `PHOENIX_PORT` | HTTP port | `6006` |
| `PHOENIX_GRPC_PORT` | gRPC port | `4317` |
| `PHOENIX_API_KEY` | Authentication key | None |
| `PHOENIXCollectorEndpoint` | OTEL collector endpoint | Internal |
## Client Integration
### Python Client
```python
from phoenix.client import Client
client = Client(
host="http://localhost:6006",
api_key="your-api-key"
)
# Query datasets
datasets = client.datasets.list()
# Get spans as DataFrame
spans = client.spans.get_spans_dataframe(
project_identifier="my-project",
limit=1000
)
```
### TypeScript Client
```typescript
import { Client } from "@arizeai/phoenix-client";
const client = new Client({
host: "http://localhost:6006",
apiKey: "your-api-key"
});
const datasets = await client.datasets.list();
```
## Request/Response Patterns
### GraphQL Query Example
```graphql
query GetDataset($id: GlobalID!) {
dataset(id: $id) {
id
name
version
createdAt
spanCount
traceCount
}
}
```
### REST Request with Filtering
```bash
curl -X GET "http://localhost:6006/v1/spans?project_id=abc123&limit=100" \
-H "Authorization: Bearer $PHOENIX_API_KEY"
```
## Summary
Phoenix's Server API and GraphQL layer provides a unified interface for observability operations:
- **GraphQL** via Strawberry for type-safe, self-documenting queries
- **REST** endpoints for compatibility and specialized operations
- **Authentication** via API keys with role-based permissions
- **Data Loaders** for efficient batch data loading
- **OpenAPI schema** for client SDK generation
---
## Python SDK (arize-phoenix-client)
### 相关页面
相关主题：[Evaluation System (Phoenix Evals)](#page-evals-system), [OpenTelemetry Integration](#page-otel-integration)
相关源码文件
以下源码文件用于生成本页说明：
- [packages/phoenix-client/src/phoenix/client/client.py](https://github.com/Arize-ai/phoenix/blob/main/packages/phoenix-client/src/phoenix/client/client.py)
- [packages/phoenix-client/src/phoenix/client/resources](https://github.com/Arize-ai/phoenix/blob/main/packages/phoenix-client/src/phoenix/client/resources)
- [packages/phoenix-client/src/phoenix/client/helpers/sdk](https://github.com/Arize-ai/phoenix/blob/main/packages/phoenix-client/src/phoenix/client/helpers/sdk)
- [packages/phoenix-client/README.md](https://github.com/Arize-ai/phoenix/blob/main/packages/phoenix-client/README.md)
- [src/phoenix/__init__.py](https://github.com/Arize-ai/phoenix/blob/main/src/phoenix/__init__.py)
# Python SDK (arize-phoenix-client)
The `arize-phoenix-client` is the official Python SDK for Arize Phoenix, providing a comprehensive interface for interacting with the Phoenix platform via its REST API. This SDK enables developers to programmatically manage datasets, run experiments, analyze traces, and collect feedback for LLM observability and evaluation workflows.
## Overview
Phoenix is an open-source AI observability platform designed for debugging, evaluating, and refining LLM applications. The Python SDK serves as the primary programmatic interface for:
- **REST API Integration** - Full access to Phoenix's OpenAPI REST interface
- **Prompt Management** - Create, version, and invoke prompt templates
- **Dataset Operations** - Create and append datasets from DataFrames, CSV files, or dictionaries
- **Experiment Tracking** - Run evaluations and track experiment results
- **Trace Analysis** - Query and analyze traces with powerful filtering capabilities
- **Annotation Workflows** - Add human feedback and automated evaluations to spans
资料来源：[packages/phoenix-client/README.md]()
## Installation
Install the SDK using pip:
```bash
pip install arize-phoenix-client
```
资料来源：[packages/phoenix-client/README.md]()
## Client Initialization
The SDK provides both synchronous and asynchronous client implementations.
### Synchronous Client
```python
from phoenix.client import Client
# Automatic configuration from environment variables
client = Client()
# Explicit configuration
client = Client(base_url="http://localhost:6006")
# Cloud instance with API key
client = Client(
base_url="https://app.phoenix.arize.com/s/your-space",
api_key="your-api-key"
)
```
### Asynchronous Client
```python
from phoenix.client import Client, AsyncClient
# Create async client with same configuration options
async_client = AsyncClient()
async_client = AsyncClient(base_url="http://localhost:6006")
async_client = AsyncClient(
base_url="https://app.phoenix.arize.com/s/your-space",
api_key="your-api-key"
)
```
资料来源：[packages/phoenix-client/README.md]()
## Configuration
### Environment Variables
The client automatically reads configuration from environment variables:
| Variable | Description | Example |
|----------|-------------|---------|
| `PHOENIX_BASE_URL` | Base URL of the Phoenix server | `http://localhost:6006` |
| `PHOENIX_API_KEY` | API key for authentication | `sk-xxxxx` |
| `PHOENIX_CLIENT_HEADERS` | Custom headers (JSON stringified) | `{"Authorization": "Bearer xxx"}` |
### Configuration Examples
```bash
# Local Phoenix server (default)
export PHOENIX_BASE_URL="http://localhost:6006"
# Cloud Instance
export PHOENIX_API_KEY="your-api-key"
export PHOENIX_BASE_URL="https://app.phoenix.arize.com/s/your-space"
# Custom Headers
export PHOENIX_CLIENT_HEADERS="Authorization=Bearer your-api-key,custom-header=value"
```
资料来源：[packages/phoenix-client/README.md]()
### Custom Authentication Headers
For custom authentication scenarios:
```python
from phoenix.client import Client
client = Client(
base_url="https://your-phoenix-instance.com",
headers={"Authorization": "Bearer your-api-key"}
)
```
## Architecture
### Client Structure
The SDK follows a resource-based architecture where the main `Client` provides access to specialized resource objects:
```mermaid
graph TD
A[Client] --> B[prompts]
A --> C[datasets]
A --> D[experiments]
A --> E[spans]
A --> F[annotations]
B --> B1[create, get, list, format]
C --> C1[create, append, get, list]
D --> D1[run, track, evaluate]
E --> E1[query, filter, export]
F --> F1[add, update, evaluate]
```
### SDK Package Structure
```
phoenix/
└── client/
├── client.py # Main Client and AsyncClient classes
├── resources/ # Resource implementations
│ ├── prompts.py
│ ├── datasets.py
│ ├── experiments.py
│ ├── spans.py
│ └── annotations.py
└── helpers/
└── sdk/ # SDK utilities and helpers
```
资料来源：[packages/phoenix-client/src/phoenix/client/client.py]()
资料来源：[packages/phoenix-client/src/phoenix/client/resources]()
## Core Resources
### Prompts Resource
Manage prompt templates and versions with versioning support:
```python
from phoenix.client import Client
from phoenix.client.types import PromptVersion
client = Client()
content = """
You're an expert educator in {{ topic }}. Summarize the following article
in a few concise bullet points that are easy for beginners to understand.
{{ article }}
"""
prompt = client.prompts.create(
name="article-bullet-summarizer",
version=PromptVersion(
messages=[{"role": "user", "content": content}],
model_name="gpt-4o-mini",
),
prompt_description="Summarize an article in a few bullet points"
)
# Retrieve and use prompts
prompt = client.prompts.get(prompt_identifier="article-bullet-summarizer")
# Format the prompt with variables
prompt_vars = {
"topic": "Sports",
"article": "Moises Henriques has signed to play for Surrey..."
}
formatted_prompt = prompt.format(variables=prompt_vars)
```
**Prompt Version Type:**
| Parameter | Type | Description |
|-----------|------|-------------|
| `messages` | `List[dict]` | Message array with role and content |
| `model_name` | `str` | LLM model to use for the prompt |
| ` temperature` | `float` | Sampling temperature (optional) |
资料来源：[packages/phoenix-client/README.md]()
### Datasets Resource
Create and manage datasets from various data sources:
```python
from phoenix.client import Client
import pandas as pd
client = Client()
# Create from DataFrame
dataset = client.datasets.create(
name="my-dataset",
dataframe=df,
description="Training data for sentiment analysis"
)
# Append additional data
client.datasets.append(
dataset_id=dataset.id,
dataframe=additional_df
)
# Get dataset
dataset = client.datasets.get(
dataset_name="my-dataset",
version_id="optional-version-id"
)
```
**Supported Input Formats:**
| Format | Method | Example |
|--------|--------|---------|
| DataFrame | `dataframe` parameter | `dataframe=pd.DataFrame(...)` |
| CSV | `csv_path` parameter | `csv_path="/path/to/data.csv"` |
| Dictionary | `dictionary` parameter | `dictionary=[{"col": "value"}]` |
资料来源：[packages/phoenix-client/README.md]()
### Experiments Resource
Run evaluations and track experiment results:
```python
from phoenix.client import Client
client = Client()
# Run an experiment
experiment = client.experiments.run(
name="sentiment-analysis-v1",
dataset_id="dataset-uuid",
evaluator_config={
"model": "gpt-4",
"metrics": ["accuracy", "f1"]
}
)
# Track results
client.experiments.track(
experiment_id=experiment.id,
results={"accuracy": 0.95, "f1": 0.93}
)
```
资料来源：[packages/phoenix-client/README.md]()
### Spans Resource
Query and analyze traces with powerful filtering:
```python
from phoenix.client import Client
client = Client()
# Query spans with filters
spans = client.spans.query(
project_name="my-project",
filter_conditions={
"trace_id": "optional-trace-id",
"start_time": "2024-01-01T00:00:00Z",
"end_time": "2024-01-02T00:00:00Z"
},
limit=100
)
# Get span details
span = client.spans.get(span_id="span-uuid")
```
**Query Parameters:**
| Parameter | Type | Description |
|-----------|------|-------------|
| `project_name` | `str` | Phoenix project name |
| `filter_conditions` | `dict` | Filtering conditions |
| `limit` | `int` | Maximum results to return |
| `start_time` | `datetime` | Start of time range |
| `end_time` | `datetime` | End of time range |
资料来源：[packages/phoenix-client/src/phoenix/client/resources]()
### Annotations Resource
Add human feedback and automated evaluations:
```python
from phoenix.client import Client
client = Client()
# Add annotation to span
annotation = client.annotations.add(
span_id="span-uuid",
label="correct",
score=1.0,
metadata={"reviewer": "human"}
)
# Bulk add annotations
client.annotations.bulk_add(
annotations=[
{"span_id": "span-1", "label": "correct", "score": 1.0},
{"span_id": "span-2", "label": "incorrect", "score": 0.0}
]
)
```
资料来源：[packages/phoenix-client/README.md]()
## Migration from Legacy Client
The legacy `phoenix.session.client.Client` has been removed. Users must migrate to the new SDK:
```python
# Old (deprecated)
from phoenix.session.client import Client
# New
from phoenix.client import Client
```
资料来源：[src/phoenix/__init__.py]()
## Data Flow Diagram
```mermaid
graph LR
A[Python Application] -->|arize-phoenix-client| B[Phoenix REST API]
B --> C[Phoenix Server]
C --> D[(Database)]
A --> E[Prompts]
A --> F[Datasets]
A --> G[Experiments]
A --> H[Traces/Spans]
A --> I[Annotations]
E --> B
F --> B
G --> B
H --> B
I --> B
```
## Use Cases
### RAG Evaluation Workflow
```python
from phoenix.client import Client
client = Client()
# 1. Create dataset
dataset = client.datasets.create(
name="rag-evaluation-set",
dataframe=evaluation_df
)
# 2. Run evaluation experiment
experiment = client.experiments.run(
name="rag-faithfulness-eval",
dataset_id=dataset.id,
evaluator_config={
"model": "gpt-4",
"metrics": ["faithfulness", "answer_relevance"]
}
)
# 3. Query results
results = client.experiments.get_results(experiment_id=experiment.id)
# 4. Add annotations to spans
for span_id, score in results.items():
client.annotations.add(
span_id=span_id,
label="faithful" if score > 0.8 else "unfaithful",
score=score
)
```
### Prompt Versioning and Management
```python
from phoenix.client import Client
from phoenix.client.types import PromptVersion
client = Client()
# Create initial prompt version
prompt_v1 = client.prompts.create(
name="customer-support-assistant",
version=PromptVersion(
messages=[{"role": "system", "content": "You are a helpful assistant."}],
model_name="gpt-4"
)
)
# Create new version
prompt_v2 = client.prompts.create(
name="customer-support-assistant",
version=PromptVersion(
messages=[{"role": "system", "content": "You are a helpful support agent trained to be concise."}],
model_name="gpt-4"
)
)
# Compare versions
current = client.prompts.get(prompt_identifier="customer-support-assistant")
```
## Summary
The `arize-phoenix-client` Python SDK provides a comprehensive, Pythonic interface for interacting with the Phoenix observability platform. Key capabilities include:
- **Unified Client Interface** - Single entry point for all Phoenix operations
- **Resource-Based Design** - Organized access to prompts, datasets, experiments, spans, and annotations
- **Environment-Based Configuration** - Zero-config setup via environment variables
- **Async Support** - Built-in async client for asynchronous applications
- **Type Safety** - Full type hints and Pydantic models for validation
资料来源：[packages/phoenix-client/src/phoenix/client/client.py]()
资料来源：[packages/phoenix-client/README.md]()
---
---
## Doramagic 踩坑日志
项目：Arize-ai/phoenix
摘要：发现 38 个潜在踩坑项，其中 3 个为 high/blocking；最高优先级：安装坑 - 来源证据：Docs proposal: RAG failure mode checklist for observability and eval workflows。
## 1. 安装坑 · 来源证据：Docs proposal: RAG failure mode checklist for observability and eval workflows
- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Docs proposal: RAG failure mode checklist for observability and eval workflows
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_43a673bd0a9947d3a8758a608e7a5a15 | https://github.com/Arize-ai/phoenix/issues/11472 | 来源类型 github_issue 暴露的待验证使用条件。
## 2. 安装坑 · 来源证据：[BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with App…
- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with Apple Hypervisor VM
- 对用户的影响：可能阻塞安装或首次运行。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_beadd6130d804f29b2f261a0194d2262 | https://github.com/Arize-ai/phoenix/issues/12941 | 来源讨论提到 python 相关条件，需在安装/试用前复核。
## 3. 安装坑 · 来源证据：[agents] investigate clientside tracing for external tools
- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[agents] investigate clientside tracing for external tools
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_2e2fc634da044ed9a177a6dd85a78b23 | https://github.com/Arize-ai/phoenix/issues/13173 | 来源类型 github_issue 暴露的待验证使用条件。
## 4. 安装坑 · 失败模式：installation: [BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47...
- 严重度：medium
- 证据强度：source_linked
- 发现：Developers should check this installation risk before relying on the project: [BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with Apple Hypervisor VM
- 对用户的影响：Developers may fail before the first successful local run: [BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with Apple Hypervisor VM
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: [BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with Apple Hypervisor VM. Context: Observed when using python, docker, linux
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_b3db5f930ac5e7b7f85e47ff9693c190 | https://github.com/Arize-ai/phoenix/issues/12941 | [BUG]: Docker image exits immediately (SIGILL) on Apple Silicon with podman — cryptography 47.0.0 incompatible with Apple Hypervisor VM
## 5. 配置坑 · 失败模式：configuration: [sandboxes] per-execute timeout enforcement is incomplete across backends
- 严重度：medium
- 证据强度：source_linked
- 发现：Developers should check this configuration risk before relying on the project: [sandboxes] per-execute timeout enforcement is incomplete across backends
- 对用户的影响：Developers may misconfigure credentials, environment, or host setup: [sandboxes] per-execute timeout enforcement is incomplete across backends
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: [sandboxes] per-execute timeout enforcement is incomplete across backends. Context: Observed when using python
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_5978fbc9db2aea6762b2ab2f9e8d0205 | https://github.com/Arize-ai/phoenix/issues/13313 | [sandboxes] per-execute timeout enforcement is incomplete across backends
## 6. 配置坑 · 来源证据：[sandboxes] per-execute timeout enforcement is incomplete across backends
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：[sandboxes] per-execute timeout enforcement is incomplete across backends
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_7e0ad954523449959675c0433a0ff80b | https://github.com/Arize-ai/phoenix/issues/13313 | 来源讨论提到 python 相关条件，需在安装/试用前复核。
## 7. 能力坑 · 能力判断依赖假设
- 严重度：medium
- 证据强度：source_linked
- 发现：README/documentation is current enough for a first validation pass.
- 对用户的影响：假设不成立时，用户拿不到承诺的能力。
- 建议检查：将假设转成下游验证清单。
- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。
- 证据：capability.assumptions | github_repo:564072810 | https://github.com/Arize-ai/phoenix | README/documentation is current enough for a first validation pass.
## 8. 运行坑 · 失败模式：runtime: arize-phoenix: v15.5.0
- 严重度：medium
- 证据强度：source_linked
- 发现：Developers should check this runtime risk before relying on the project: arize-phoenix: v15.5.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.5.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.5.0. Context: Observed when using docker
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_77bc9f7097156e71a699d05abced2916 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.5.0 | arize-phoenix: v15.5.0
## 9. 运行坑 · 来源证据：arize-phoenix: v15.3.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.3.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_d364a0a28a14428baff5ca692cb00578 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.3.0 | 来源类型 github_release 暴露的待验证使用条件。
## 10. 运行坑 · 来源证据：arize-phoenix: v15.5.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.5.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_ad2696a72e314b52b79d157bf261f7bd | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.5.0 | 来源类型 github_release 暴露的待验证使用条件。
## 11. 运行坑 · 来源证据：arize-phoenix: v15.5.1
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.5.1
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_b75368026b414d1bbe31d7d3e90b2731 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.5.1 | 来源类型 github_release 暴露的待验证使用条件。
## 12. 运行坑 · 来源证据：arize-phoenix: v15.6.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.6.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_49d41c4c92f24db2b382ebd014f9bd14 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.6.0 | 来源类型 github_release 暴露的待验证使用条件。
## 13. 运行坑 · 来源证据：arize-phoenix: v15.7.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.7.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_826b7f8e0d2342cabfedab3cabb1a2dc | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.7.0 | 来源类型 github_release 暴露的待验证使用条件。
## 14. 运行坑 · 来源证据：arize-phoenix: v15.9.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：arize-phoenix: v15.9.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_0d47708aa40b4b99b3f132751181cf43 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.9.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
## 15. 维护坑 · 失败模式：migration: [agents] investigate clientside tracing for external tools
- 严重度：medium
- 证据强度：source_linked
- 发现：Developers should check this migration risk before relying on the project: [agents] investigate clientside tracing for external tools
- 对用户的影响：Developers may hit a documented source-backed failure mode: [agents] investigate clientside tracing for external tools
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: [agents] investigate clientside tracing for external tools. Context: Observed when using python
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_f8117a9bb9f5654b2e4f54cc2b4f7fe3 | https://github.com/Arize-ai/phoenix/issues/13173 | [agents] investigate clientside tracing for external tools
## 16. 维护坑 · 来源证据：[BUG]: playground experiment UI rendering issue
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：[BUG]: playground experiment UI rendering issue
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_610a50542f75479b953fd6a15a55776f | https://github.com/Arize-ai/phoenix/issues/13308 | 来源类型 github_issue 暴露的待验证使用条件。
## 17. 维护坑 · 维护活跃度未知
- 严重度：medium
- 证据强度：source_linked
- 发现：未记录 last_activity_observed。
- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。
- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。
- 证据：evidence.maintainer_signals | github_repo:564072810 | https://github.com/Arize-ai/phoenix | last_activity_observed missing
## 18. 安全/权限坑 · 下游验证发现风险项
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：下游已经要求复核，不能在页面中弱化。
- 建议检查：进入安全/权限治理复核队列。
- 防护动作：下游风险存在时必须保持 review/recommendation 降级。
- 证据：downstream_validation.risk_items | github_repo:564072810 | https://github.com/Arize-ai/phoenix | no_demo; severity=medium
## 19. 安全/权限坑 · 存在评分风险
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：风险会影响是否适合普通用户安装。
- 建议检查：把风险写入边界卡，并确认是否需要人工复核。
- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。
- 证据：risks.scoring_risks | github_repo:564072810 | https://github.com/Arize-ai/phoenix | no_demo; severity=medium
## 20. 安全/权限坑 · 来源证据：GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_547816d87273465a88a09397fc2c4ab1 | https://github.com/Arize-ai/phoenix/issues/13241 | 来源讨论提到 python 相关条件，需在安装/试用前复核。
## 21. 安全/权限坑 · 来源证据：[security] setup deepsec
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[security] setup deepsec
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_153e6ddc8487493e893542da4c348bbe | https://github.com/Arize-ai/phoenix/issues/13275 | 来源类型 github_issue 暴露的待验证使用条件。
## 22. 安全/权限坑 · 来源证据：arize-phoenix: v15.10.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：arize-phoenix: v15.10.0
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_1ce89c62b10a43288f4c6394276bc97c | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.10.0 | 来源类型 github_release 暴露的待验证使用条件。
## 23. 安全/权限坑 · 来源证据：arize-phoenix: v15.4.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：arize-phoenix: v15.4.0
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_fea401ed7b774dc7885c245774e87cce | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.4.0 | 来源类型 github_release 暴露的待验证使用条件。
## 24. 安全/权限坑 · 来源证据：arize-phoenix: v15.8.0
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：arize-phoenix: v15.8.0
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_2ecb08e3e7e04b60ac87fab18439546d | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.8.0 | 来源类型 github_release 暴露的待验证使用条件。
## 25. 能力坑 · 失败模式：capability: [BUG]: playground experiment UI rendering issue
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this capability risk before relying on the project: [BUG]: playground experiment UI rendering issue
- 对用户的影响：Developers may hit a documented source-backed failure mode: [BUG]: playground experiment UI rendering issue
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: [BUG]: playground experiment UI rendering issue. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_3c24e5ce6d42a5e1a0e0230aecb92e81 | https://github.com/Arize-ai/phoenix/issues/13308 | [BUG]: playground experiment UI rendering issue
## 26. 能力坑 · 失败模式：capability: [security] setup deepsec
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this capability risk before relying on the project: [security] setup deepsec
- 对用户的影响：Developers may hit a documented source-backed failure mode: [security] setup deepsec
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: [security] setup deepsec. Context: Observed during installation or first-run setup.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_d37b8a28ea2b1ff0c52a5ae60c624e97 | https://github.com/Arize-ai/phoenix/issues/13275 | [security] setup deepsec
## 27. 能力坑 · 失败模式：conceptual: Docs proposal: RAG failure mode checklist for observability and eval workflows
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this conceptual risk before relying on the project: Docs proposal: RAG failure mode checklist for observability and eval workflows
- 对用户的影响：Developers may hit a documented source-backed failure mode: Docs proposal: RAG failure mode checklist for observability and eval workflows
- 建议检查：复核 source-backed failure mode cluster，并把适用版本和验证路径写入资产。
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_6c4658bbeb1e5baa04ed96cfad5079aa | https://github.com/Arize-ai/phoenix/issues/11472 | Docs proposal: RAG failure mode checklist for observability and eval workflows
## 28. 运行坑 · 失败模式：performance: GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this performance risk before relying on the project: GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
- 对用户的影响：Developers may hit a documented source-backed failure mode: GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch. Context: Observed when using python
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_issue | fmev_23b7285d4fadfe700afa410a8950e461 | https://github.com/Arize-ai/phoenix/issues/13241 | GenerativeModelStore: _last_fetch_id can regress and defeat incremental fetch
## 29. 维护坑 · issue/PR 响应质量未知
- 严重度：low
- 证据强度：source_linked
- 发现：issue_or_pr_quality=unknown。
- 对用户的影响：用户无法判断遇到问题后是否有人维护。
- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。
- 防护动作：issue/PR 响应未知时，必须提示维护风险。
- 证据：evidence.maintainer_signals | github_repo:564072810 | https://github.com/Arize-ai/phoenix | issue_or_pr_quality=unknown
## 30. 维护坑 · 发布节奏不明确
- 严重度：low
- 证据强度：source_linked
- 发现：release_recency=unknown。
- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。
- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。
- 证据：evidence.maintainer_signals | github_repo:564072810 | https://github.com/Arize-ai/phoenix | release_recency=unknown
## 31. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.10.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.10.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.10.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.10.0. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_e4788bb4f329f5cc3023bb09f9cd7813 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.10.0 | arize-phoenix: v15.10.0
## 32. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.10.1
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.10.1
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.10.1
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.10.1. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_8400f06faab947c42c1ebe0b7884772b | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.10.1 | arize-phoenix: v15.10.1
## 33. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.4.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.4.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.4.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.4.0. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_653c077d0085ffa005a084fd3ca970fa | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.4.0 | arize-phoenix: v15.4.0
## 34. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.5.1
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.5.1
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.5.1
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.5.1. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_bc2b79f0aa2ad5b7394adb522e327c95 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.5.1 | arize-phoenix: v15.5.1
## 35. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.6.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.6.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.6.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.6.0. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_362d0c49630790947fb31ce598711670 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.6.0 | arize-phoenix: v15.6.0
## 36. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.7.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.7.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.7.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.7.0. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_cf7af51ba96b7aae5b7f6e9fe76d3a80 | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.7.0 | arize-phoenix: v15.7.0
## 37. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.8.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.8.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.8.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.8.0. Context: Source discussion did not expose a precise runtime context.
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_cb667f7181256aff35598629d537411d | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.8.0 | arize-phoenix: v15.8.0
## 38. 维护坑 · 失败模式：maintenance: arize-phoenix: v15.9.0
- 严重度：low
- 证据强度：source_linked
- 发现：Developers should check this maintenance risk before relying on the project: arize-phoenix: v15.9.0
- 对用户的影响：Upgrade or migration may change expected behavior: arize-phoenix: v15.9.0
- 建议检查：Before packaging this project, run the relevant install/config/quickstart check for: arize-phoenix: v15.9.0. Context: Observed when using node
- 防护动作：State this as source-backed community evidence, not as Doramagic reproduction.
- 证据：failure_mode_cluster:github_release | fmev_3f5a219a80efa7ef7afa6caf0db5a21c | https://github.com/Arize-ai/phoenix/releases/tag/arize-phoenix-v15.9.0 | arize-phoenix: v15.9.0
|