Rewrite azure-ai-evaluation skill to use azure-ai-projects SDK (V2 API)#105
Merged
thegovind merged 3 commits intomicrosoft:mainfrom Feb 6, 2026
Merged
Conversation
BREAKING CHANGE: Replaces deprecated azure-ai-evaluation SDK with azure-ai-projects SDK
Key changes:
- Replace all azure-ai-evaluation imports with azure-ai-projects SDK
- Use AIProjectClient + openai_client.evals.* API instead of evaluate()
- Built-in evaluators now use 'builtin.' prefix (e.g., builtin.coherence)
- Data mapping syntax changed from \ to {{item.field}}
- Custom evaluators use CodeBasedEvaluatorDefinition/PromptBasedEvaluatorDefinition
- Agent evaluations use {{sample.output_text}} for response mapping
Updated files:
- SKILL.md: Complete rewrite with new SDK patterns
- references/built-in-evaluators.md: New evaluator discovery and usage
- references/custom-evaluators.md: Code-based and prompt-based patterns
- references/acceptance-criteria.md: Updated acceptance tests
- scripts/run_batch_evaluation.py: CLI tool using new SDK
References:
- Azure AI Projects samples: sdk/ai/azure-ai-projects/samples/evaluations/
- Guidance: 'Don't use or reference azure-ai-evaluation anywhere'
…zure-ai-evaluation-py Changes: - Delete azure-ai-evaluation-py folder entirely (deprecated SDK) - Enhance azure-ai-projects-py with comprehensive evaluation content: - Replace references/evaluation.md with comprehensive version - Add references/built-in-evaluators.md (complete evaluator reference) - Add references/custom-evaluators.md (code/prompt-based patterns) - Add scripts/run_batch_evaluation.py (CLI tool) - Update SKILL.md reference files list - Rename 'Azure AI Foundry' to 'Microsoft Foundry' in docs The azure-ai-evaluation SDK is deprecated per guidance: 'Don't use or reference azure-ai-evaluation anywhere'
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR deprecates the azure-ai-evaluation-py skill and merges its functionality into azure-ai-projects-py using the current V2 API.
Background
Per guidance from April:
"azure-ai-evaluation is v1 API (not compatible with nextgen and eventually will be deprecated)" "don't use or reference azure-ai-evaluation anywhere"
Changes
Deleted
Enhanced azure-ai-projects-py skill
Key API Pattern (V2)
References