Skip to content

docs: migrate quickstart-evals notebook to current phoenix-evals API - #75

Closed
jimbobbennett wants to merge 1 commit into
mainfrom
docs/quickstart-evals-current-api
Closed

docs: migrate quickstart-evals notebook to current phoenix-evals API#75
jimbobbennett wants to merge 1 commit into
mainfrom
docs/quickstart-evals-current-api

Conversation

@jimbobbennett

Copy link
Copy Markdown
Contributor

What

Migrates python/llm/evaluation/quickstart-evals.ipynb off the deprecated v7 evaluation stack onto the current API.

Before (deprecated) After (current)
ArizeExportClient(...).export_model_to_df(model_id=..., environment=Environments.TRACING) ArizeClient(...).spans.export_to_df(project_name=...)
OpenAIModel(model="gpt-4o", ...) LLM(provider="openai", model="gpt-4.1")
llm_classify(dataframe, template, model, rails=[...]) + nest_asyncio create_classifier(...) + evaluate_dataframe(...)
arize.pandas.logger.Client(...).log_evaluations_sync(...) to_annotation_dataframe(...)client.spans.update_evaluations(...)

Why

The paired AX docs page (ax/cookbooks/evaluate/evaluations-quickstart) is being migrated to the current API, and this Colab is linked directly from that page. This keeps the notebook and doc in sync. phoenix.evals' classic llm_classify/OpenAIModel interface is deprecated (moved to phoenix.evals.legacy) in favor of the LLM + create_classifier + evaluate_dataframe API.

Testing

Executed end-to-end via jupyter nbconvert --execute against a live AX space with arize 8.35.0 / arize-phoenix-evals 3.x: exported 4 spans, graded them (positive/negative), and uploaded — records_updated: 4, no cell errors.

🤖 Generated with Claude Code

Update the evaluations quickstart off the deprecated v7 stack
(ArizeExportClient/export_model_to_df, OpenAIModel, llm_classify,
log_evaluations_sync) onto the current API:

- export spans via ArizeClient().spans.export_to_df
- build the judge with phoenix.evals LLM + create_classifier
- run with evaluate_dataframe
- flatten with to_annotation_dataframe and log via client.spans.update_evaluations

Keeps the notebook in sync with the AX docs evaluations quickstart.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@jimbobbennett

Copy link
Copy Markdown
Contributor Author

Pairs with docs PR Arize-ai/docs#766 (Phoenix Evals integration, closes Arize-ai/docs#92).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants