Add guide for extending AML agent evaluation and datasets

[fcogidi]

Summary

Add guide for extending AML agent evaluation and datasets.

Clickup Ticket(s): N/A

Type of Change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
• 📝 Documentation update
• 🔧 Refactoring (no functional changes)
• ⚡ Performance improvement
• 🧪 Test improvements
• 🔒 Security fix

Changes Made

• Add documentation for how to extend the AML agent capabilities and evaluation dimensions.

Testing

• Tests pass locally (uv run pytest tests/)
• Type checking passes (uv run mypy <src_dir>)
• Linting passes (uv run ruff check src_dir/)
• Manual testing performed (describe below)

Manual testing details:
N/A

Screenshots/Recordings

Related Issues

Deployment Notes

Checklist

• Code follows the project's style guidelines
• Self-review of code completed
• Documentation updated (if applicable)
• No sensitive information (API keys, credentials) exposed

[Copilot]

Pull request overview

Adds a new documentation guide explaining how the AML investigation evaluation is structured today and where to extend datasets, evaluation dimensions, and agent capabilities.

Changes:

• Introduces a comprehensive “Extending AML Agent Evaluation and Datasets” guide for dataset generation, schema evolution, and evaluator additions.
• Documents extension points across the AML agent, task wrapper, graders (item/trace/run), and rubrics.
• Provides recommended next metrics, tooling ideas, and a validation loop for iterating on datasets/agents/evals.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.