Skip to main content

Agent Eval 评估器

PyPI Python License: MIT

Agent 能力评估框架(agent-eval CLI)——基于 Agent-Driven 架构,支持课件生成、 代码生成、RAG、对话等多类 Agent 评估。

安装(发布后)

pip install ai-eval-scope                 # 基础:规则评估(无 LLM 依赖)
pip install "ai-eval-scope[llm]"          # + LLM Judge(OpenAI/Anthropic 兼容)
pip install "ai-eval-scope[agent]"        # + ExecutionAgent 执行引擎(DeepAgents 底座)
pip install "ai-eval-scope[vision]"       # + 视觉评估(playwright 截图渲染)
pip install "ai-eval-scope[datasets]"     # + 数据集下载(HuggingFace/ModelScope)

uv tool install "ai-eval-scope[agent]"    # uv:全局 CLI 工具安装
uvx --from "ai-eval-scope[agent]" agent-eval --help   # 一次性运行,不落盘

包名 ai-eval-scope,import 名 agent_eval,CLI 命令 agent-eval(命令名≠包名)。 Python ≥ 3.11。LLM 与凭证配置见 CLI 使用教程。

开发

cd evaluator
uv sync --group dev                # 开发依赖组(PEP 735,含 llm/vision 测试依赖)
uv run playwright install chromium  # 下载 Chromium 浏览器二进制(~150MB,装到用户缓存)
uv run agent-eval --help

配置

交互式向导(推荐)

uv run agent-eval models login

向导流程:

  1. 选择提供商:anthropic / openai / deepseek / custom(自定义 OpenAI 兼容端点)
  2. API Base URL:按提供商给默认值(anthropic 缺省 https://api.moonshot.cn/anthropic,即 Kimi 的 Anthropic 协议端点;openai 缺省 https://api.openai.com/v1;deepseek 缺省 https://api.deepseek.com/v1)
  3. API Key:隐藏输入
  4. 逐角色确认模型:
    • text — 文本 LLM Judge(默认必配)
    • vision — 视觉评估模型(用视觉规则集时需要)
    • agent — 执行侧模型(run/pipeline 驱动被测 Agent 用;未配置时自动回退 text)

查看与验证

uv run agent-eval models list    # 查看(API Key 脱敏显示 前4…后4)
uv run agent-eval models test    # 对每个已配角色真实调用一次,打印时延
uv run agent-eval models logout  # 删除配置(含 key)

详见 CLI 使用教程 与 CLAUDE.md。

运行

uv run agent-eval eval \
  --package-dir workspace/packages/<包目录>/ \
  --package courseware

验证是否真正执行:产物中出现 *.png 截图、评估耗时显著增加(视觉渲染 + 视觉 LLM 调用), 且日志无「视觉跳过」「Chromium 启动失败」字样。缓存命中时会跳过视觉重算,调试时加 --no-cache 强制重评。

Metadata

Release files for ai-eval-scope 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-eval-scope 0.3.3
File Size Uploaded Provenance
ai_eval_scope-0.3.3.tar.gz 1.3 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ai-eval-scope 0.3.3
File Interpreter ABI Platform
ai_eval_scope-0.3.3-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / ai_eval_scope-0.3.3.tar.gz

Download URL ai_eval_scope-0.3.3.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
aabbd2252ab961530ccb5fc9d7dc99de9746cc202f3478e0cff4678ce343fc00
BLAKE2b-256 checksum
How to use checksums
228aeb92679671a8be8230869fee4df4e7bfcca8b507673e022dbfaa7020eb90
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / ai_eval_scope-0.3.3-py3-none-any.whl

Download URL ai_eval_scope-0.3.3-py3-none-any.whl
Size 989.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
de7502e3193a615844866aadee5f7fc6c5ef212f346ee03cfa60972394b48371
BLAKE2b-256 checksum
How to use checksums
dd69316e7d1d40100f3e42eb27b2b2aef0a235c12d36c5e38e798a3408c591e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for ai-eval-scope 0.3.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page