Giskard

为 LLM 与多轮智能体执行评测、红队测试和测试生成。

Star 数
★ 5.9k
最近更新
4 天前
License
Apache-2.0
主语言
Python

30 秒速览

运行形态
代码库 / SDK
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Python 3.12+用于 LLM 评判器或扫描生成器的 LLM 提供方 SDK 及匹配的 API 密钥Shell / 命令行网络访问
典型场景
正在迭代客服智能体的 Python 团队,可将多轮 Scenario 放入测试流程,检查改动后是否出现行为回归。
不适合
  • 仍在使用 Python 3.11 或更早版本、无法升级的环境
  • 需要稳定生产级 API、不能接受 Beta 版功能变动的团队

这个 Agent 能做什么,适合哪些场景?

Giskard 是面向智能体系统的开源 Python 测试与评估库,v3 采用模块化、轻量级且 async-first 的架构。主要可直接使用的包是 giskard-checks(评测与测试)和 giskard-scan(漏洞扫描与 RAG/质量评估,均为 Beta)。它可将同步或异步的 (inputs) -> outputs 可调用对象作为 Target,并通过 Scenario、Check 与 Suite 执行多轮或单轮评测。giskard-checks 可输出场景运行报告;giskard-scan 根据智能体描述生成对抗测试套件并执行漏洞扫描或知识库质量评估。它是嵌入应用代码的 Python 库,而非独立托管的聊天产品;使用 LLM 判审或扫描生成器时需要安装提供商 SDK 并配置相应 API 密钥。

Scenario 先用 .interact(inputs=..., outputs=target) 调用待测系统,再用 .check(...) 对输出或 trace 执行检查,随后通过 await scenario.run() 运行并以 result.print_report() 输出报告。内置检查包括字符串匹配、比较、正则、语义相似度,以及 Groundedness、Conformity、LLMJudge 等 LLM 判审。vulnerability_scan(target=..., description=..., languages=...) 接收一个异步目标和自然语言描述,自动生成覆盖提示注入、有害内容、刻板印象与错误信息等范围的对抗测试;也可向 generate_suite 传入自定义 ScenarioGenerator,或注册至 vulnerability_suite_generator_registry。对于 RAG,v3 的 giskard-scan 提供 quality_scan 与 KnowledgeBase 路径;旧版 v2 的 generate_testset 可从知识库生成问题、参考答案和上下文。

  1. 正在迭代客服智能体的 Python 团队,可将多轮 Scenario 放入测试流程,检查改动后是否出现行为回归。
  2. 维护 RAG 问答系统的团队,可用 Groundedness 检查回答是否基于给定检索上下文。
  3. 上线前需要安全评估的智能体开发者,可用 vulnerability_scan 根据产品描述生成提示注入和有害内容等对抗测试。
  4. 有内部攻击样本的安全团队,可实现自定义 ScenarioGenerator 并传给 generate_suite 扩展扫描覆盖范围。
  5. 仍在运行 v2 RAGET 或 LLM Scan 的用户,可评估迁移到 v3 的 quality_scan 与 vulnerability_scan。

如何安装或部署这个 Agent?

需要 Python 3.12+。基础评测安装:pip install giskard,或仅安装检查包:pip install giskard-checks。扫描功能安装:pip install "giskard[scan]",也可使用 pip install giskard-scan。使用 LLM 判审或扫描生成器时,安装提供商额外依赖,例如 pip install "giskard[openai]",并设置匹配的 API 密钥;README 还列出 anthropic 等提供商额外依赖。若不希望发送可选聚合遥测数据,应在导入前设置 export DO_NOT_TRACK=1 或 export GISKARD_TELEMETRY_DISABLED=1。

如何使用这个 Agent?

最小评测调用可定义 def get_answer(inputs: str) -> str,创建 Scenario("test_france_capital").interact(inputs="What is the capital of France?", outputs=get_answer).check(Groundedness(name="answer is grounded", context="...")),再在 async def main() 中执行 result = await scenario.run() 和 result.print_report()。最小扫描调用可定义 async def my_agent(inputs: str) -> str,然后执行 await vulnerability_scan(target=my_agent, description="A customer support chatbot for an e-commerce platform.", languages=["en"])。Groundedness 默认使用 openai/gpt-4o-mini,因此该示例需相应的提供商额外依赖和 API 密钥。

这个 Agent 有哪些优点和局限?

优点
  • v3 将评测、扫描、共享核心、LLM 路由和工作流编排拆分为独立包,避免为基础检查引入扫描依赖。
  • Scenario API 支持同步或异步 Target、trace 和多轮交互,适合输出非确定性的智能体测试。
  • giskard-scan 可从自然语言智能体描述自动生成对抗测试,并覆盖提示注入、越狱、有害内容等范围。
  • 既提供常规断言,也提供 Groundedness、Conformity 与 LLMJudge 等 LLM 判审。
局限
  • giskard-checks 与 giskard-scan 在 README 中均标为 Beta,采用时需接受接口和行为仍可能演进。
  • LLM 判审与扫描生成器依赖提供商 SDK、匹配 API 密钥及网络连接;并非完全离线的评测方案。
  • 运行时要求 Python 3.12+,对较旧的 Python 环境需要升级。
  • v2 已不再积极维护;旧版表格/ML 自动扫描仍仅限 v2,且没有迁移到 v3 的计划。

这个 Agent 与同类方案有什么区别?

相对于已不再积极维护的 Giskard v2,v3 将 LLM 智能体扫描迁移为 giskard-scan 的 vulnerability_scan,将 RAGET 路径迁移为 quality_scan 与 KnowledgeBase。但 v2 的自动表格/ML 扫描(基于 giskard.Model 与 giskard.Dataset 的性能、偏差和鲁棒性检测)、giskard.testing ML 测试套件及 Giskard Hub 不计划迁移到 v3。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Giskard 当前 47 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 5.9k 4 天前 Python OpenAI API · Claude API
DeepEval 53 · 缺口较多 命令行工具免费 + 模型费 ★ 19k 1 天前 Python OpenAI API · Claude API
AI 评测技能集 52 · 缺口较多 Agent 插件 / 技能 ★ 1.7k 1 个月前 — —
Agent Learning Kit 38 · 缺口较多 命令行工具免费 + 模型费 ★ 128 2 天前 Python —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
47/ 100 五分制 2.4 / 5
本评测基于 2026年8月9日 的源码;此后该项目发布了 23 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 7/29
可靠稳定 8/14
适用触发 12/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全7 / 29 · 1.2/5

证据显示:telemetry 可禁用(DO_NOT_TRACK/GISKARD_TELEMETRY_DISABLED),且声明不发送 prompts 或 outputs;CI 工作流使用最小权限(permissions: {} 或 contents: read),并固定 action 版本;集成测试对外部 PR 有授权门控(authorize job)和 'safe for build' 标签。扣分:未发现用户确认机制(如执行前确认);数据流透明度仅部分(telemetry 说明但未详述数据流向);敏感数据处理未明确(如 API key 处理);依赖安全仅通过 pip-audit 在 dev 组中提及,未显示在 CI 中;外部影响(如网络调用)未明确说明;回滚机制未提及;来源归属仅通过作者字段和版权声明,未验证。

可靠稳定8 / 14 · 2.9/5

证据显示:README 和 pyproject.toml 中版本号一致(3.0.0b1),依赖声明明确(giskard-checks>=1.0.2b6,<2),CI 测试覆盖多 Python 版本和包。扣分:失败消息未在文档中明确说明(如错误处理指南);依赖可用性未完全验证(如外部 provider SDK 未在 CI 中全部测试)。

适用触发12 / 18 · 3.3/5

证据显示:README 明确目标受众(开发者、研究人员),提供多种使用场景(回归测试、RAG 验证、安全规则、多轮 agent);能力边界通过模块划分(checks, scan, core, llm, agents)清晰;触发精度通过 Scenario 和 Check 概念明确;环境适配通过 Python 3.12+ 和可选 extras 支持多种 provider。扣分:未发现针对不同环境的详细配置指南(如 Docker、云部署)。

规范维护10 / 18 · 2.8/5

证据显示:README 结构清晰,包含安装、快速开始、概念解释;安装说明详细(pip install 和 extras);命名稳定(giskard-checks, giskard-scan 等);示例和 FAQ 通过快速开始和文档链接提供;已知限制在 README 中提及(v2 不再维护,v3 为 beta);许可证为 Apache-2.0;版本号在 pyproject.toml 中明确,但未发现 CHANGELOG 文件;维护责任通过 CONTRIBUTING.md 和社区链接体现。扣分:命名稳定性未完全验证(v3 重写可能改变 API);版本变更日志未提供。

有效结果7 / 13 · 2.7/5

证据显示:输出可用性通过 result.print_report() 和文档中的示例体现;边际价值通过提供自动化扫描和测试生成功能体现;成本效益未明确讨论(如资源消耗、API 成本)。扣分:成本效益未量化。

证据核验3 / 8 · 1.9/5

证据显示:README 中的声明(如功能、架构)有文档链接支持;CI 测试提供部分验证;但未发现独立的第三方验证或交叉来源。扣分:声明可追溯性仅部分(文档链接但未提供具体测试结果);交叉来源验证不足;事实与推断分离不明确。

风险与缓解建议
  • 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 该仓库为 beta 版本,API 可能变化,生产使用需谨慎。
  • telemetry 虽可禁用,但默认可能启用,需在导入前设置环境变量。
  • 依赖外部 LLM provider,需自行管理 API key 和成本。
  • 未发现明确的回滚机制,升级前需备份。
证据充分度:低 评估于 2026年8月9日 审查版本 b6b8403ffa88 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. giskard-agents/v1.0.6 giskard-agents v1.0.6
    发布说明摘录
    What's Changed * fix(deps): bump certifi, filelock and setuptools to clear pip-audit advisories by @kevinmessiaen in https://github.com/Giskard-AI/giskard-oss/pull/2898 * [Security] Exclude litellm compromised version by @pierlj in https://github.com/Giskard-AI/giskard-oss/pull/2896 Full Changelog: https://github.com/Giskard-AI/giskard-oss/compare/giskard-agents/v1.0.5...giskard-agents/v1.0.6
    在 GitHub 查看 ↗
  2. giskard-agents/v1.0.5 giskard-agents v1.0.5
    发布说明摘录
    Full Changelog: https://github.com/Giskard-AI/giskard-oss/compare/giskard-llm/v1.0.3...giskard-agents/v1.0.5
    在 GitHub 查看 ↗
  3. giskard-llm/v1.0.3 giskard-llm v1.0.3
    发布说明摘录
    Full Changelog: https://github.com/Giskard-AI/giskard-oss/compare/giskard-core/v1.0.3...giskard-llm/v1.0.3
    在 GitHub 查看 ↗

常见问题

使用 Giskard 是否必须调用外部模型?
不是所有检查都必须。字符串匹配、比较、正则和语义相似度属于内置评测;Groundedness、Conformity、LLMJudge 以及扫描生成器需要提供商额外依赖和 API 密钥。
Giskard 能测试什么形式的目标?
Target 可以是任意同步或异步的 (inputs) -> outputs 可调用对象,并可选提供 trace;README 明确列出 LLM、黑盒智能体和多步流水线。
它会上传提示词和模型输出吗?
README 说明 giskard-core 的聚合遥测是可选的,且不发送 prompts 或 outputs。可在导入前通过 DO_NOT_TRACK=1 或 GISKARD_TELEMETRY_DISABLED=1 退出。
从 v2 迁移时有哪些边界?
LLM Scan 和 RAGET 有对应的 v3 路径,但自动表格/ML 扫描、giskard.testing ML 测试和 Giskard Hub 仍是 v2 专属,未计划进入 v3。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents