AgentScope Studio
面向 AgentScope 开发者的本地可视化工具包,让基于 Agent 的应用开发、调试与评估变得透明、简单而有趣。
- Star 数
- ★ 674
- 最近更新
- 2 个月前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 AgentScope 框架的开发者,希望在本地 Web 界面中实时观察 Agent 的对话与推理过程。
- 不适合
- 需要长期维护支持的新项目:仓库已归档,官方建议迁移到 AgentScope 2.0 内置 Web UI
- 不使用 AgentScope 框架构建 Agent 的团队
- 官网
- agentscope-ai.github.io ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-09-02
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
AgentScope Studio 是一个本地运行的可视化工具包(agentscope-ai/agentscope-studio,Apache-2.0 许可),服务于使用 AgentScope 框架的开发者。它提供项目管理(Projects 与 Runs)、聊天机器人式的实时运行界面、基于 OpenTelemetry 的链路追踪可视化(LLM 调用、token 用量与 Agent 调用)、统计视角的 Agent 评估,以及内置 Copilot(Friday)。应用通过在 agentscope.init 中设置 studio_url 连接到 Studio。通过 npm 全局安装后以 as_studio 命令启动,访问 localhost:3000 使用;也支持从源码运行或 Docker 部署。需要注意:该仓库已发布归档公告,不再作为独立工具维护,官方建议迁移到内置 Web UI 的 AgentScope 2.0,本仓库将转为只读并很快归档。
Studio 在本地启动一个 Web 界面(默认 http://localhost:3000)。AgentScope 应用通过 agentscope.init(studio_url="http://localhost:3000") 注册后,其运行情况会呈现在 Studio 中:Projects/Runs 用于组织和管理 AgentScope 项目;聊天机器人式界面用于实时与 Agent 交互;基于 OpenTelemetry 的追踪视图展示 LLM 调用、token 用量和 Agent 调用链;评估模块从统计角度分析 Agent 表现;内置 Copilot Friday 提供开发辅助、快速二次开发的 playground 和高级功能集成入口。安装方式包括 npm install -g @agentscope/studio 后运行 as_studio,或克隆源码后 npm install && npm run dev,亦可选 Docker 部署。
- 使用 AgentScope 框架的开发者,希望在本地 Web 界面中实时观察 Agent 的对话与推理过程。
- 需要排查 LLM 调用链和 token 消耗的工程师,可借助 OpenTelemetry 追踪视图定位问题。
- 构建多 Agent 应用的团队,用 Projects 和 Runs 组织、管理多个实验运行。
- 需要从统计角度评估 Agent 表现的研究者或评测人员。
- 希望在 playground 中快速做二次开发的开发者,可使用内置 Copilot Friday。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @agentscope/studio
- 运行环境
- Node.js 20.0.0+
- 安装说明涉及
- Docker
如何安装或部署这个 Agent?
前置要求:Node.js >= 20.0.0、npm >= 10.0.0(使用 nvm 可运行 nvm use 自动切换版本)。推荐从 npm 安装:
npm install -g @agentscope/studio
# 启动 AgentScope Studio
as_studio或从源码运行:
git clone https://github.com/agentscope-ai/agentscope-studio
cd agentscope-studio
npm install
# 以开发模式启动
npm run devDocker 部署方式见仓库中的 docker/README.md。
如何使用这个 Agent?
启动 Studio 后(默认地址 http://localhost:3000),在你的 AgentScope 应用初始化时设置 studio_url 以连接:
import agentscope
agentscope.init(
# ...
studio_url="http://localhost:3000"
)
# ...连接后即可在浏览器中使用 Projects/Runs 管理项目、通过聊天界面与 Agent 实时交互、查看 OpenTelemetry 追踪与评估分析。
这个 Agent 有哪些优点和局限?
- 与 AgentScope 框架原生集成,一行 studio_url 配置即可接入运行时可视化。
- 基于 OpenTelemetry 的追踪标准化,可审查 LLM 调用、token 用量和 Agent 调用链。
- 本地运行、Apache-2.0 开源,数据不出本机,且提供 npm、源码、Docker 三种部署路径。
- 仓库已发布归档公告,不再作为独立工具维护,官方建议迁移到 AgentScope 2.0,存在迁移风险。
- 与 AgentScope 框架强绑定:不使用 AgentScope 构建的应用无法通过 agentscope.init 接入。
- 需要 Node.js >= 20.0.0 与 npm >= 10.0.0 的本地运行时环境。
这个 Agent 与同类方案有什么区别?
README 明确指出其继任者是 AgentScope 2.0 的内置 Web UI(FastAPI 后端加预构建前端 examples/web_ui),后者新增多会话隔离、Agent Team(leader–worker)编排、权限与人在回路控制、IM 渠道(飞书/Discord)、MCP 与 Skill Hub 管理、会话持久化和任务调度。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentScope Studio 当前 | 53 · 缺口较多 | 网页应用免费 | ★ 674 | 2 个月前 | TypeScript | — |
| 上下文工程智能体技能集 | 66 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 18k | 1 天前 | Python | Codex · Claude Code |
| NVIDIA NeMo Agent Toolkit | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.7k | 2 天前 | Python | — |
| Judgeval | 53 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 1.1k | 2 天前 | Python | OpenAI API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
Friday代理默认注册execute_python_code与execute_shell_command,写文件工具需--writePermission显式开启,体现部分最小权限;但shell/python执行本身权限极大,权限控制仅靠系统提示词('请求许可、禁止灾难操作'),无技术层确认门控。数据流向(本地会话JSON保存、studio_url转发)在代码中可见,得2分;但API密钥经命令行args传入且无脱敏说明,敏感数据处理薄弱。无回滚机制,会话仅追加保存。依赖固定版本但无lockfile或审计证据。归因清晰(作者、团队、Apache-2.0)。
代码内部一致:端口冲突有交互/非交互双路径处理,gRPC失败降级到HTTP /v1/traces,优雅关闭处理SIGINT/SIGTERM;JSONSession兼容try/except处理API变更,错误信息具体可读。依赖均为npm主流维护包,版本约束合理。
面向AgentScope开发者,README与文档索引明确;能力边界(可视化/追踪/评估/Friday)描述清楚。但工具触发精度依赖提示词,无结构化触发定义;Friday的max_iters=50与提示词中max_turns=20不一致,存在小的环境适配瑕疵。
信息架构良好(README、docs目录、docker子说明),安装说明含版本检查与nvm提示,命名稳定(@agentscope/studio、as_studio),package.json与发布流程版本一致性有CI校验。许可证Apache-2.0完整全文,得3分。但无FAQ/示例细节文档(仅链接),无已知限制章节,且仓库已宣布归档、不再维护——维护责任明显缺失,仅指向迁移路径。
输出可用性:可视化界面、追踪、健康检查脚本齐全;marginal_value作为本地开发可视化工具对AgentScope用户有价值。但项目已废弃,价值被AgentScope 2.0内置Web UI取代,成本收益被归档状态显著拉低。
声明可追溯:功能列表对应代码中的trpc/otel/socket模块;arXiv论文、npm徽章、CI流程交叉印证;事实与推断在README中分离清楚(归档通知为明确事实)。但性能类声明('powerful')无测试证据支撑,且样本文件不含测试代码。
- 仓库已宣布归档、仅作只读参考,不会再有安全修复;应迁移到AgentScope 2.0。
- Friday代理默认具备执行任意Python与shell命令的能力,权限控制仅为提示词层面,建议在隔离环境中运行并谨慎授予writePermission。
- API密钥通过命令行参数传入,可能进入shell历史或进程列表,注意脱敏。
- 无已知漏洞披露、依赖审计或lockfile证据,依赖安全性未经证实。
常见问题
AgentScope Studio 现在还能用吗?
使用它需要付费吗?
不用 AgentScope 框架可以使用 Studio 吗?
需要哪些运行环境?
如何部署?
AgentScope Studio 官网是什么?
AgentScope Studio 开源吗?
AgentScope Studio 安全吗?
AgentScope Studio 还在维护吗?
AgentScope Studio 是谁开发的?
谢谢反馈,我们会据此改进页面。