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.5

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.5
File Size Uploaded Provenance
ai_eval_scope-0.3.5.tar.gz 1.4 MB Without provenance Details

Built distribution (wheel)

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

Total release size: 2.4 MB

Release files / ai_eval_scope-0.3.5.tar.gz

Download URL ai_eval_scope-0.3.5.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
7b7c65346129a5e3bd8018b9b2caca075009d736ce1c26538bb25eb98aaeeae7
BLAKE2b-256 checksum
How to use checksums
827ab2decd9693169e1129e867e29a3e6c33934b2436c68aa47bcf6666fb64c6
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.5-py3-none-any.whl

Download URL ai_eval_scope-0.3.5-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
093be3074914cbb83e2c837effe69e19a570651484f1573257d02c671cc00d3a
BLAKE2b-256 checksum
How to use checksums
0a814800c17c9085249b0cbb3a4a29533e50f66804032e11be9c6b91eb361d31
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.5

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