【免费下载链接】agentscope-runtimeA production-ready runtime framework for agent apps with secure tool sandboxing, Agent-as-a-Service APIs, scalable deployment, full-stack observability, and broad framework compatibility.项目地址https://gitcode.com/gh_mirrors/ag/agentscope-runtime点击查看免费下载AgentScope Runtime 是面向生产环境的智能体Agent运行时框架内置安全工具沙箱、Agent-as-a-Service API、可扩展部署与全栈可观测能力。它的统一命令行入口就叫agentscope——从本地对话调试、Web UI 测试到一键部署到 K8s / Knative / 阿里云 ModelStudio 等 6 大平台再到列出、查看、停止已部署的智能体全部由 9 个子命令完成。本文是一份速查清单帮你 10 分钟掌握 agentscope 命令行子命令全貌遇到报错也能快速定位。一键安装与验证agentscope CLI 快速上手先确认 CLI 已安装并可用源码入口cli.pypip install agentscope-runtime agentscope --version # 查看版本 agentscope --help # 查看全部子命令只要--help能列出 9 个子命令就说明 CLI 工作正常。agentscope 子命令总览一张表看懂全部命令子命令类别作用关键参数chat开发调试交互对话或单次查询智能体-q查询、--session-id、-e入口文件web开发调试启动浏览器 Web UI 测试--host、--port默认 8090run开发调试以常驻 HTTP 服务方式运行智能体--host、-p端口默认 8080deploy部署部署到 local / modelstudio / agentrun / k8s / knative / kruise-E环境变量、-c配置文件list部署管理列出所有部署及状态--status、--platform、--format jsonstatus部署管理查看单个部署详情部署 ID、--formatstop部署管理停止指定部署部署 ID、-y跳过确认invoke部署管理调用已部署的智能体chat的便捷别名-q、--session-id、--user-idsandbox沙箱启动 MCP 服务器 / 沙箱管理服务器 / 构建沙箱子命令mcp、server、build 记忆口诀开发用 chat / web / run上线用 deploy运维用 list / status / stop / invoke沙箱用 sandbox。开发调试命令速查chat、web、run 三剑客agentscope chat交互式运行与单次查询chat既可以在开发期直接跑智能体也可以指向一个部署 ID 测试线上版本实现见 chat.pyagentscope chat app_agent.py # 交互模式多轮对话 agentscope chat ./my-agent-project # 从项目目录加载 agentscope chat app_agent.py --query 今天天气如何 # 单次查询后退出 agentscope chat app_agent.py -q 你好 --session-id my-session --user-id u123 agentscope chat ./my-project --entrypoint custom_app.py # 指定目录入口文件SOURCE可以是 Python 文件、项目目录或部署 ID--verbose/-v可打印日志和推理过程排查问题时非常有用agentscope web浏览器界面测试agentscope web app_agent.py # 后端 127.0.0.1:8090前端 http://localhost:5173/ agentscope web app_agent.py --host 0.0.0.0 --port 8000注意首次启动会通过 npm 安装 Web UI 依赖耗时略长属正常现象web.py。agentscope run把智能体跑成常驻 HTTP 服务适合把智能体当后台服务、供其他应用通过 HTTP 调用run.pyagentscope run app_agent.py # 默认 0.0.0.0:8080 agentscope run app_agent.py --host 127.0.0.1 --port 8090 --verbose服务启动后可通过POST /process端点访问按 CtrlC 停止。部署命令速查agentscope deploy 支持哪 6 个平台deploy是 CLI 中最重的命令一条命令即可把智能体打成部署包并推送到目标平台deploy.pyagentscope deploy PLATFORM SOURCE [OPTIONS]6 大部署平台与关键选项对照平台语法平台特有选项前置条件localdeploy local app_agent.py无无适合本地验证modelstudiodeploy modelstudio app_agent.py--skip-upload阿里云账户、DASHSCOPE_API_KEYagentrundeploy agentrun app_agent.py--region、--cpu、--memory阿里云 AK 环境变量k8sdeploy k8s app_agent.py--namespace、--replicas、--pushDocker kubectl 集群权限knativedeploy knative app_agent.py与 k8s 基本一致已部署 Knative 的集群kruisedeploy kruise app_agent.py与 k8s 基本一致已安装 Kruise Sandbox CRDK8s 系平台的常用资源选项--image-name、--image-tag、--registry-url、--push推送镜像、--cpu-limit、--memory-limit、--pypi-mirrorpip 镜像源国内网络建议配置。所有平台通用的部署选项选项简写说明--name-部署名称不填则自动生成--entrypoint-e目录源的入口文件名如app.py--env-E环境变量KEYVALUE可重复多次--env-file-.env文件路径--config-cJSON / YAML 部署配置文件一个典型的生产部署示例agentscope deploy k8s app_agent.py \ --image-name my-agent \ --replicas 3 \ --push \ --env DASHSCOPE_API_KEYsk-xxx环境变量优先级-ECLI--env-file--config。示例配置见 k8s_deploy_config.yaml、modelstudio_deploy_config.yaml。部署管理命令速查list、status、stop、invoke部署完成后这 4 个命令负责善后都基于部署 ID形如local_20250101_120000_abc123agentscope list # 列出全部部署 agentscope list --status running # 按状态筛选 agentscope list --platform k8s --format json # 按平台筛选JSON 输出供脚本处理 agentscope status local_20250101_120000_abc123 # 查看详情[status.py](https://link.gitcode.com/i/a8a50643bca8d5c8e42a323218b047c5) agentscope stop local_20250101_120000_abc123 --yes # 停止部署-y 跳过确认 agentscope invoke local_20250101_120000_abc123 -q 你好 # 调用已部署的智能体invoke本质是chat 部署ID的便捷别名invoke.py支持--query、--session-id、--user-id。标准开发到上线工作流可直接抄agentscope chat app_agent.py # 1. 本地调试 agentscope web app_agent.py # 2. Web UI 测试 agentscope deploy local app_agent.py --env DASHSCOPE_API_KEYsk-xxx # 3. 部署 agentscope list agentscope status deployment-id # 4. 检查状态 agentscope invoke deployment-id -q test # 5. 验证调用 agentscope stop deployment-id # 6. 收尾沙箱命令速查agentscope sandbox 的 3 个子命令沙箱是 AgentScope Runtime 的安全执行环境。统一入口agentscope sandbox下有 3 个子命令sandbox.py子命令作用agentscope sandbox mcp启动沙箱 MCP 服务器agentscope sandbox server启动沙箱管理器服务器agentscope sandbox build构建沙箱环境旧的runtime-sandbox-*命令仍然可用但官方建议迁移到agentscope sandbox *。高频参数与常见报错速查高频参数一览参数出现位置用途-q/--querychat / invoke单次查询执行完即退出--session-idchat / invoke固定会话 ID保持多轮上下文--user-idchat / invoke区分多用户会话-v/--verbosechat / run打印日志与推理过程-e/--entrypointchat / web / run / deploy目录源指定入口文件--format jsonlist / status机器可读输出方便脚本-y/--yesstop跳过停止前的确认提示常见报错 60 秒排查报错 / 现象原因与解决No AgentApp found in agent.py智能体文件需导出agent_app或app变量或提供create_app()函数Multiple AgentApp instances found文件中存在多个 AgentApp 实例只保留一个Address already in use端口被占用换--port或停掉冲突进程部署超时 / 连接失败检查网络、凭证与环境变量用agentscope status id看部署日志会话历史不连续每次查询使用相同的--session-id模块导入失败确认依赖已安装、智能体文件为合法 Python 代码状态文件在哪里全局部署注册表~/.agentscope-runtime/deployments.json自动每日备份保留 30 天工作空间构建缓存当前目录下.agentscope_runtime/builds/可安全删除以释放空间建议加入.gitignore写在最后这份清单怎么用把本文当作贴墙速查表开发调试看chat/web/run上线看deploy六平台对照表运维看list/status/stop/invoke。完整参数与示例可继续阅读官方文档 cookbook/zh/cli.md各子命令的源码实现集中在 src/agentscope_runtime/cli/commands/ 目录遇到怪异行为时可以直接对照源码确认行为细节。赞分享【免费下载链接】agentscope-runtimeA production-ready runtime framework for agent apps with secure tool sandboxing, Agent-as-a-Service APIs, scalable deployment, full-stack observability, and broad framework compatibility.项目地址https://gitcode.com/gh_mirrors/ag/agentscope-runtime点击查看免费下载相关推荐plan-review 命令清单/plan-review、resume、finish、ls 等 9 个子命令一览速查plan review 命令清单/plan review、resume、finish、ls 等 9 个子命令一览速查 plan review 是 ClaudeCORAL CLI命令全清单eval、resume、log、status、export等18个命令速查手册CORAL CLI命令全清单eval、resume、log、status、export等18个命令速查手册 CORAL 是一个开源的自主研究autoreseOpenTabs CLI命令手册从start到doctor的12个高频命令速查清单OpenTabs CLI命令手册从start到doctor的12个高频命令速查清单 刚接触 OpenTabs 的朋友最容易被它CLI 驱动一切的设计惊艳创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考