[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MAR5P4ZPPFN23J0T66R8MA":3,"skill-same:01M6MAR5P4ZPPFN23J0T66R8MA":86},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":57,"ownerHtmlUrl":58,"ownerBlogUrl":59,"ownerDescription":60,"updatedAt":61,"install":62,"resources":75},"01M6MAR5P4ZPPFN23J0T66R8MA","phoenix-observability",null,"Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fphoenix-observability\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"observability","Phoenix","phoenix observability","running","debugging","when","source","for","insights","LLM Applications","platform","time","observability platform","use","ops","open","applications","real-time","OpenTelemetry","Evaluation","monitoring","tracing","2026-11-10 10:12:30",false,"---\nname: phoenix-observability\ndescription: Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.\nlicense: MIT\nmetadata:\n  version: 1.0.0\n  category: ml-inference-and-ops\n  maintainer: Kalaris Labs\n  tags: Observability, Phoenix, Arize, Tracing, Evaluation, Monitoring, LLM Ops, OpenTelemetry\n  dependencies: arize-phoenix>=12.0.0\n---\n\n# Phoenix - AI Observability Platform\n\nOpen-source AI observability and evaluation platform for LLM applications with tracing, evaluation, datasets, experiments, and real-time monitoring.\n\n## When to use Phoenix\n\n**Use Phoenix when:**\n- Debugging LLM application issues with detailed traces\n- Running systematic evaluations on datasets\n- Monitoring production LLM systems in real-time\n- Building experiment pipelines for prompt\u002Fmodel comparison\n- Self-hosted observability without vendor lock-in\n\n**Key features:**\n- **Tracing**: OpenTelemetry-based trace collection for any LLM framework\n- **Evaluation**: LLM-as-judge evaluators for quality assessment\n- **Datasets**: Versioned test sets for regression testing\n- **Experiments**: Compare prompts, models, and configurations\n- **Playground**: Interactive prompt testing with multiple models\n- **Open-source**: Self-hosted with PostgreSQL or SQLite\n\n**Use alternatives instead:**\n- **LangSmith**: Managed platform with LangChain-first integration\n- **Weights & Biases**: Deep learning experiment tracking focus\n- **Arize Cloud**: Managed Phoenix with enterprise features\n- **MLflow**: General ML lifecycle, model registry focus\n\n## Quick start\n\n### Installation\n\n```bash\npip install arize-phoenix\n\n# With specific backends\npip install arize-phoenix[embeddings]  # Embedding analysis\npip install arize-phoenix-otel         # OpenTelemetry config\npip install arize-phoenix-evals        # Evaluation framework\npip install arize-phoenix-client       # Lightweight REST client\n```\n\n### Launch Phoenix server\n\n```python\nimport phoenix as px\n\n# Launch in notebook (ThreadServer mode)\nsession = px.launch_app()\n\n# View UI\nsession.view()  # Embedded iframe\nprint(session.url)  # http:\u002F\u002Flocalhost:6006\n```\n\n### Command-line server (production)\n\n```bash\n# Start Phoenix server\nphoenix serve\n\n# With PostgreSQL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host\u002Fdb\"\nphoenix serve --port 6006\n```\n\n### Basic tracing\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\n# Configure OpenTelemetry with Phoenix\ntracer_provider = register(\n    project_name=\"my-llm-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"\n)\n\n# Instrument OpenAI SDK\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All OpenAI calls are now traced\nfrom openai import OpenAI\nclient = OpenAI()\nresponse = client.chat.completions.create(\n    model=\"gpt-4o\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n)\n```\n\n## Core concepts\n\n### Traces and spans\n\nA **trace** represents a complete execution flow, while **spans** are individual operations within that trace.\n\n```python\nfrom phoenix.otel import register\nfrom opentelemetry import trace\n\n# Setup tracing\ntracer_provider = register(project_name=\"my-app\")\ntracer = trace.get_tracer(__name__)\n\n# Create custom spans\nwith tracer.start_as_current_span(\"process_query\") as span:\n    span.set_attribute(\"input.value\", query)\n\n    # Child spans are automatically nested\n    with tracer.start_as_current_span(\"retrieve_context\"):\n        context = retriever.search(query)\n\n    with tracer.start_as_current_span(\"generate_response\"):\n        response = llm.generate(query, context)\n\n    span.set_attribute(\"output.value\", response)\n```\n\n### Projects\n\nProjects organize related traces:\n\n```python\nimport os\nos.environ[\"PHOENIX_PROJECT_NAME\"] = \"production-chatbot\"\n\n# Or per-trace\nfrom phoenix.otel import register\ntracer_provider = register(project_name=\"experiment-v2\")\n```\n\n## Framework instrumentation\n\n### OpenAI\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\ntracer_provider = register()\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### LangChain\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.langchain import LangChainInstrumentor\n\ntracer_provider = register()\nLangChainInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All LangChain operations traced\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI(model=\"gpt-4o\")\nresponse = llm.invoke(\"Hello!\")\n```\n\n### LlamaIndex\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.llama_index import LlamaIndexInstrumentor\n\ntracer_provider = register()\nLlamaIndexInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### Anthropic\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.anthropic import AnthropicInstrumentor\n\ntracer_provider = register()\nAnthropicInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n## Evaluation framework\n\n### Built-in evaluators\n\n```python\nfrom phoenix.evals import (\n    OpenAIModel,\n    HallucinationEvaluator,\n    RelevanceEvaluator,\n    ToxicityEvaluator,\n    llm_classify\n)\n\n# Setup model for evaluation\neval_model = OpenAIModel(model=\"gpt-4o\")\n\n# Evaluate hallucination\nhallucination_eval = HallucinationEvaluator(eval_model)\nresults = hallucination_eval.evaluate(\n    input=\"What is the capital of France?\",\n    output=\"The capital of France is Paris.\",\n    reference=\"Paris is the capital of France.\"\n)\n```\n\n### Custom evaluators\n\n```python\nfrom phoenix.evals import llm_classify\n\n# Define custom evaluation\ndef evaluate_helpfulness(input_text, output_text):\n    template = \"\"\"\n    Evaluate if the response is helpful for the given question.\n\n    Question: {input}\n    Response: {output}\n\n    Is this response helpful? Answer 'helpful' or 'not_helpful'.\n    \"\"\"\n\n    result = llm_classify(\n        model=eval_model,\n        template=template,\n        input=input_text,\n        output=output_text,\n        rails=[\"helpful\", \"not_helpful\"]\n    )\n    return result\n```\n\n### Run evaluations on dataset\n\n```python\nfrom phoenix import Client\nfrom phoenix.evals import run_evals\n\nclient = Client()\n\n# Get spans to evaluate\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\"\n)\n\n# Run evaluations\neval_results = run_evals(\n    dataframe=spans_df,\n    evaluators=[\n        HallucinationEvaluator(eval_model),\n        RelevanceEvaluator(eval_model)\n    ],\n    provide_explanation=True\n)\n\n# Log results back to Phoenix\nclient.log_evaluations(eval_results)\n```\n\n## Datasets and experiments\n\n### Create dataset\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Create dataset\ndataset = client.create_dataset(\n    name=\"qa-test-set\",\n    description=\"QA evaluation dataset\"\n)\n\n# Add examples\nclient.add_examples_to_dataset(\n    dataset_name=\"qa-test-set\",\n    examples=[\n        {\n            \"input\": {\"question\": \"What is Python?\"},\n            \"output\": {\"answer\": \"A programming language\"}\n        },\n        {\n            \"input\": {\"question\": \"What is ML?\"},\n            \"output\": {\"answer\": \"Machine learning\"}\n        }\n    ]\n)\n```\n\n### Run experiment\n\n```python\nfrom phoenix import Client\nfrom phoenix.experiments import run_experiment\n\nclient = Client()\n\ndef my_model(input_data):\n    \"\"\"Your model function.\"\"\"\n    question = input_data[\"question\"]\n    return {\"answer\": generate_answer(question)}\n\ndef accuracy_evaluator(input_data, output, expected):\n    \"\"\"Custom evaluator.\"\"\"\n    return {\n        \"score\": 1.0 if expected[\"answer\"].lower() in output[\"answer\"].lower() else 0.0,\n        \"label\": \"correct\" if expected[\"answer\"].lower() in output[\"answer\"].lower() else \"incorrect\"\n    }\n\n# Run experiment\nresults = run_experiment(\n    dataset_name=\"qa-test-set\",\n    task=my_model,\n    evaluators=[accuracy_evaluator],\n    experiment_name=\"baseline-v1\"\n)\n\nprint(f\"Average accuracy: {results.aggregate_metrics['accuracy']}\")\n```\n\n## Client API\n\n### Query traces and spans\n\n```python\nfrom phoenix import Client\n\nclient = Client(endpoint=\"http:\u002F\u002Flocalhost:6006\")\n\n# Get spans as DataFrame\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\",\n    limit=1000\n)\n\n# Get specific span\nspan = client.get_span(span_id=\"abc123\")\n\n# Get trace\ntrace = client.get_trace(trace_id=\"xyz789\")\n```\n\n### Log feedback\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Log user feedback\nclient.log_annotation(\n    span_id=\"abc123\",\n    name=\"user_rating\",\n    annotator_kind=\"HUMAN\",\n    score=0.8,\n    label=\"helpful\",\n    metadata={\"comment\": \"Good response\"}\n)\n```\n\n### Export data\n\n```python\n# Export to pandas\ndf = client.get_spans_dataframe(project_name=\"my-app\")\n\n# Export traces\ntraces = client.list_traces(project_name=\"my-app\")\n```\n\n## Production deployment\n\n### Docker\n\n```bash\ndocker run -p 6006:6006 arizephoenix\u002Fphoenix:latest\n```\n\n### With PostgreSQL\n\n```bash\n# Set database URL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host:5432\u002Fphoenix\"\n\n# Start server\nphoenix serve --host 0.0.0.0 --port 6006\n```\n\n### Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PHOENIX_PORT` | HTTP server port | `6006` |\n| `PHOENIX_HOST` | Server bind address | `127.0.0.1` |\n| `PHOENIX_GRPC_PORT` | gRPC\u002FOTLP port | `4317` |\n| `PHOENIX_SQL_DATABASE_URL` | Database connection | SQLite temp |\n| `PHOENIX_WORKING_DIR` | Data storage directory | OS temp |\n| `PHOENIX_ENABLE_AUTH` | Enable authentication | `false` |\n| `PHOENIX_SECRET` | JWT signing secret | Required if auth enabled |\n\n### With authentication\n\n```bash\nexport PHOENIX_ENABLE_AUTH=true\nexport PHOENIX_SECRET=\"your-secret-key-min-32-chars\"\nexport PHOENIX_ADMIN_SECRET=\"admin-bootstrap-token\"\n\nphoenix serve\n```\n\n## Best practices\n\n1. **Use projects**: Separate traces by environment (dev\u002Fstaging\u002Fprod)\n2. **Add metadata**: Include user IDs, session IDs for debugging\n3. **Evaluate regularly**: Run automated evaluations in CI\u002FCD\n4. **Version datasets**: Track test set changes over time\n5. **Monitor costs**: Track token usage via Phoenix dashboards\n6. **Self-host**: Use PostgreSQL for production deployments\n\n## Common issues\n\n**Traces not appearing:**\n```python\nfrom phoenix.otel import register\n\n# Verify endpoint\ntracer_provider = register(\n    project_name=\"my-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"  # Correct endpoint\n)\n\n# Force flush\nfrom opentelemetry import trace\ntrace.get_tracer_provider().force_flush()\n```\n\n**High memory in notebook:**\n```python\n# Close session when done\nsession = px.launch_app()\n# ... do work ...\nsession.close()\npx.close_app()\n```\n\n**Database connection issues:**\n```bash\n# Verify PostgreSQL connection\npsql $PHOENIX_SQL_DATABASE_URL -c \"SELECT 1\"\n\n# Check Phoenix logs\nphoenix serve --log-level debug\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom evaluators, experiments, production setup\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdocs.arize.com\u002Fphoenix\n- **Repository**: https:\u002F\u002Fgithub.com\u002FArize-ai\u002Fphoenix\n- **Docker Hub**: https:\u002F\u002Fhub.docker.com\u002Fr\u002Farizephoenix\u002Fphoenix\n- **Version**: 12.0.0+\n- **License**: Apache 2.0\n\n## Related skills\n\n- `langsmith-observability`: LLM observability platform for tracing, evaluation, and monitoring.\n- `chroma`: Open-source embedding database for AI applications.\n- `speculative-decoding`: Accelerate LLM inference using speculative decoding, Medusa multiple heads, and lookahead decoding techniques.\n","# Phoenix - AI Observability Platform\n\nOpen-source AI observability and evaluation platform for LLM applications with tracing, evaluation, datasets, experiments, and real-time monitoring.\n\n## When to use Phoenix\n\n**Use Phoenix when:**\n- Debugging LLM application issues with detailed traces\n- Running systematic evaluations on datasets\n- Monitoring production LLM systems in real-time\n- Building experiment pipelines for prompt\u002Fmodel comparison\n- Self-hosted observability without vendor lock-in\n\n**Key features:**\n- **Tracing**: OpenTelemetry-based trace collection for any LLM framework\n- **Evaluation**: LLM-as-judge evaluators for quality assessment\n- **Datasets**: Versioned test sets for regression testing\n- **Experiments**: Compare prompts, models, and configurations\n- **Playground**: Interactive prompt testing with multiple models\n- **Open-source**: Self-hosted with PostgreSQL or SQLite\n\n**Use alternatives instead:**\n- **LangSmith**: Managed platform with LangChain-first integration\n- **Weights & Biases**: Deep learning experiment tracking focus\n- **Arize Cloud**: Managed Phoenix with enterprise features\n- **MLflow**: General ML lifecycle, model registry focus\n\n## Quick start\n\n### Installation\n\n```bash\npip install arize-phoenix\n\n# With specific backends\npip install arize-phoenix[embeddings]  # Embedding analysis\npip install arize-phoenix-otel         # OpenTelemetry config\npip install arize-phoenix-evals        # Evaluation framework\npip install arize-phoenix-client       # Lightweight REST client\n```\n\n### Launch Phoenix server\n\n```python\nimport phoenix as px\n\n# Launch in notebook (ThreadServer mode)\nsession = px.launch_app()\n\n# View UI\nsession.view()  # Embedded iframe\nprint(session.url)  # http:\u002F\u002Flocalhost:6006\n```\n\n### Command-line server (production)\n\n```bash\n# Start Phoenix server\nphoenix serve\n\n# With PostgreSQL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host\u002Fdb\"\nphoenix serve --port 6006\n```\n\n### Basic tracing\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\n# Configure OpenTelemetry with Phoenix\ntracer_provider = register(\n    project_name=\"my-llm-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"\n)\n\n# Instrument OpenAI SDK\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All OpenAI calls are now traced\nfrom openai import OpenAI\nclient = OpenAI()\nresponse = client.chat.completions.create(\n    model=\"gpt-4o\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n)\n```\n\n## Core concepts\n\n### Traces and spans\n\nA **trace** represents a complete execution flow, while **spans** are individual operations within that trace.\n\n```python\nfrom phoenix.otel import register\nfrom opentelemetry import trace\n\n# Setup tracing\ntracer_provider = register(project_name=\"my-app\")\ntracer = trace.get_tracer(__name__)\n\n# Create custom spans\nwith tracer.start_as_current_span(\"process_query\") as span:\n    span.set_attribute(\"input.value\", query)\n\n    # Child spans are automatically nested\n    with tracer.start_as_current_span(\"retrieve_context\"):\n        context = retriever.search(query)\n\n    with tracer.start_as_current_span(\"generate_response\"):\n        response = llm.generate(query, context)\n\n    span.set_attribute(\"output.value\", response)\n```\n\n### Projects\n\nProjects organize related traces:\n\n```python\nimport os\nos.environ[\"PHOENIX_PROJECT_NAME\"] = \"production-chatbot\"\n\n# Or per-trace\nfrom phoenix.otel import register\ntracer_provider = register(project_name=\"experiment-v2\")\n```\n\n## Framework instrumentation\n\n### OpenAI\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\ntracer_provider = register()\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### LangChain\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.langchain import LangChainInstrumentor\n\ntracer_provider = register()\nLangChainInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All LangChain operations traced\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI(model=\"gpt-4o\")\nresponse = llm.invoke(\"Hello!\")\n```\n\n### LlamaIndex\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.llama_index import LlamaIndexInstrumentor\n\ntracer_provider = register()\nLlamaIndexInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### Anthropic\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.anthropic import AnthropicInstrumentor\n\ntracer_provider = register()\nAnthropicInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n## Evaluation framework\n\n### Built-in evaluators\n\n```python\nfrom phoenix.evals import (\n    OpenAIModel,\n    HallucinationEvaluator,\n    RelevanceEvaluator,\n    ToxicityEvaluator,\n    llm_classify\n)\n\n# Setup model for evaluation\neval_model = OpenAIModel(model=\"gpt-4o\")\n\n# Evaluate hallucination\nhallucination_eval = HallucinationEvaluator(eval_model)\nresults = hallucination_eval.evaluate(\n    input=\"What is the capital of France?\",\n    output=\"The capital of France is Paris.\",\n    reference=\"Paris is the capital of France.\"\n)\n```\n\n### Custom evaluators\n\n```python\nfrom phoenix.evals import llm_classify\n\n# Define custom evaluation\ndef evaluate_helpfulness(input_text, output_text):\n    template = \"\"\"\n    Evaluate if the response is helpful for the given question.\n\n    Question: {input}\n    Response: {output}\n\n    Is this response helpful? Answer 'helpful' or 'not_helpful'.\n    \"\"\"\n\n    result = llm_classify(\n        model=eval_model,\n        template=template,\n        input=input_text,\n        output=output_text,\n        rails=[\"helpful\", \"not_helpful\"]\n    )\n    return result\n```\n\n### Run evaluations on dataset\n\n```python\nfrom phoenix import Client\nfrom phoenix.evals import run_evals\n\nclient = Client()\n\n# Get spans to evaluate\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\"\n)\n\n# Run evaluations\neval_results = run_evals(\n    dataframe=spans_df,\n    evaluators=[\n        HallucinationEvaluator(eval_model),\n        RelevanceEvaluator(eval_model)\n    ],\n    provide_explanation=True\n)\n\n# Log results back to Phoenix\nclient.log_evaluations(eval_results)\n```\n\n## Datasets and experiments\n\n### Create dataset\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Create dataset\ndataset = client.create_dataset(\n    name=\"qa-test-set\",\n    description=\"QA evaluation dataset\"\n)\n\n# Add examples\nclient.add_examples_to_dataset(\n    dataset_name=\"qa-test-set\",\n    examples=[\n        {\n            \"input\": {\"question\": \"What is Python?\"},\n            \"output\": {\"answer\": \"A programming language\"}\n        },\n        {\n            \"input\": {\"question\": \"What is ML?\"},\n            \"output\": {\"answer\": \"Machine learning\"}\n        }\n    ]\n)\n```\n\n### Run experiment\n\n```python\nfrom phoenix import Client\nfrom phoenix.experiments import run_experiment\n\nclient = Client()\n\ndef my_model(input_data):\n    \"\"\"Your model function.\"\"\"\n    question = input_data[\"question\"]\n    return {\"answer\": generate_answer(question)}\n\ndef accuracy_evaluator(input_data, output, expected):\n    \"\"\"Custom evaluator.\"\"\"\n    return {\n        \"score\": 1.0 if expected[\"answer\"].lower() in output[\"answer\"].lower() else 0.0,\n        \"label\": \"correct\" if expected[\"answer\"].lower() in output[\"answer\"].lower() else \"incorrect\"\n    }\n\n# Run experiment\nresults = run_experiment(\n    dataset_name=\"qa-test-set\",\n    task=my_model,\n    evaluators=[accuracy_evaluator],\n    experiment_name=\"baseline-v1\"\n)\n\nprint(f\"Average accuracy: {results.aggregate_metrics['accuracy']}\")\n```\n\n## Client API\n\n### Query traces and spans\n\n```python\nfrom phoenix import Client\n\nclient = Client(endpoint=\"http:\u002F\u002Flocalhost:6006\")\n\n# Get spans as DataFrame\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\",\n    limit=1000\n)\n\n# Get specific span\nspan = client.get_span(span_id=\"abc123\")\n\n# Get trace\ntrace = client.get_trace(trace_id=\"xyz789\")\n```\n\n### Log feedback\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Log user feedback\nclient.log_annotation(\n    span_id=\"abc123\",\n    name=\"user_rating\",\n    annotator_kind=\"HUMAN\",\n    score=0.8,\n    label=\"helpful\",\n    metadata={\"comment\": \"Good response\"}\n)\n```\n\n### Export data\n\n```python\n# Export to pandas\ndf = client.get_spans_dataframe(project_name=\"my-app\")\n\n# Export traces\ntraces = client.list_traces(project_name=\"my-app\")\n```\n\n## Production deployment\n\n### Docker\n\n```bash\ndocker run -p 6006:6006 arizephoenix\u002Fphoenix:latest\n```\n\n### With PostgreSQL\n\n```bash\n# Set database URL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host:5432\u002Fphoenix\"\n\n# Start server\nphoenix serve --host 0.0.0.0 --port 6006\n```\n\n### Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PHOENIX_PORT` | HTTP server port | `6006` |\n| `PHOENIX_HOST` | Server bind address | `127.0.0.1` |\n| `PHOENIX_GRPC_PORT` | gRPC\u002FOTLP port | `4317` |\n| `PHOENIX_SQL_DATABASE_URL` | Database connection | SQLite temp |\n| `PHOENIX_WORKING_DIR` | Data storage directory | OS temp |\n| `PHOENIX_ENABLE_AUTH` | Enable authentication | `false` |\n| `PHOENIX_SECRET` | JWT signing secret | Required if auth enabled |\n\n### With authentication\n\n```bash\nexport PHOENIX_ENABLE_AUTH=true\nexport PHOENIX_SECRET=\"your-secret-key-min-32-chars\"\nexport PHOENIX_ADMIN_SECRET=\"admin-bootstrap-token\"\n\nphoenix serve\n```\n\n## Best practices\n\n1. **Use projects**: Separate traces by environment (dev\u002Fstaging\u002Fprod)\n2. **Add metadata**: Include user IDs, session IDs for debugging\n3. **Evaluate regularly**: Run automated evaluations in CI\u002FCD\n4. **Version datasets**: Track test set changes over time\n5. **Monitor costs**: Track token usage via Phoenix dashboards\n6. **Self-host**: Use PostgreSQL for production deployments\n\n## Common issues\n\n**Traces not appearing:**\n```python\nfrom phoenix.otel import register\n\n# Verify endpoint\ntracer_provider = register(\n    project_name=\"my-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"  # Correct endpoint\n)\n\n# Force flush\nfrom opentelemetry import trace\ntrace.get_tracer_provider().force_flush()\n```\n\n**High memory in notebook:**\n```python\n# Close session when done\nsession = px.launch_app()\n# ... do work ...\nsession.close()\npx.close_app()\n```\n\n**Database connection issues:**\n```bash\n# Verify PostgreSQL connection\npsql $PHOENIX_SQL_DATABASE_URL -c \"SELECT 1\"\n\n# Check Phoenix logs\nphoenix serve --log-level debug\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom evaluators, experiments, production setup\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdocs.arize.com\u002Fphoenix\n- **Repository**: https:\u002F\u002Fgithub.com\u002FArize-ai\u002Fphoenix\n- **Docker Hub**: https:\u002F\u002Fhub.docker.com\u002Fr\u002Farizephoenix\u002Fphoenix\n- **Version**: 12.0.0+\n- **License**: Apache 2.0\n\n## Related skills\n\n- `langsmith-observability`: LLM observability platform for tracing, evaluation, and monitoring.\n- `chroma`: Open-source embedding database for AI applications.\n- `speculative-decoding`: Accelerate LLM inference using speculative decoding, Medusa multiple heads, and lookahead decoding techniques.\n",{"name":5,"license":15,"metadata":46,"description":7},{"tags":47,"version":48,"category":49,"maintainer":50,"dependencies":51},"Observability, Phoenix, Arize, Tracing, Evaluation, Monitoring, LLM Ops, OpenTelemetry","1.0.0","ml-inference-and-ops","Kalaris Labs","arize-phoenix>=12.0.0","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fphoenix-observability",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":63,"prompt":73,"zipAvailable":74},[64,67,70],{"tool":65,"command":66},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill phoenix-observability",{"tool":68,"command":69},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill phoenix-observability",{"tool":71,"command":72},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill phoenix-observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fphoenix-observability\u002FSKILL.md",true,[76,82],{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",15277,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fphoenix-observability\u002Freferences\u002Fadvanced-usage.md",{"path":83,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Ftroubleshooting.md",10944,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fphoenix-observability\u002Freferences\u002Ftroubleshooting.md",[87,96,104,112,120,128],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":95},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":100,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":95},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":108,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":95},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":116,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":95},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":124,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":95},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":132,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":95},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]