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

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.1
File Size Uploaded Provenance
ai_eval_scope-0.3.1.tar.gz 1.3 MB Without provenance Details

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / ai_eval_scope-0.3.1.tar.gz

Download URL ai_eval_scope-0.3.1.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
fb5d5c65ef4d5a6e54d6bc427f54500761140b3cba8e8da734ab8d36162b0a32
BLAKE2b-256 checksum
How to use checksums
4917018ae1bdb012329a2391f02f79c3e4ed3dfe027fb92924224d399502f6ee
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.1-py3-none-any.whl

Download URL ai_eval_scope-0.3.1-py3-none-any.whl
Size 977.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c380c16ae7d21fa3f5a3b94754557d290c9fd8ea05c3c6fb88af426a354836c2
BLAKE2b-256 checksum
How to use checksums
b6d09e47a7c9d93186e17b845fe0283c488b43215e845b32e6176b3f231751f4
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.1

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