openJiuwen Agent Runtime 快速开始：源码一键启动与 Studio 低码智能体发布实战

人工智能AI Agent后端LLMOps【免费下载链接】agent-runtimeopenJiuwen Agent Runtime 是 openJiuwen 体系中的智能体运行与部署管理平台致力于将 Agent 从“开发态”稳定带到“生产态”让发布、运行、管理更加标准与可控。项目地址https://gitcode.com/openJiuwen/agent-runtime点击查看免费下载本指南面向希望快速上手 openJiuwen Agent Runtime简称 Runtime的开发者与运维人员完整演示从拉取源码、准备.env配置、安装agent-runtime-server包、启动服务到对接 openJiuwen Studio 一键发布低码智能体、在线对话体验、获取 API 调用示例与下架智能体的全流程。读完本文你将掌握 Runtime 的核心部署链路、关键环境变量含义以及运行态智能体的日常管理方法。Runtime 是 openJiuwen 体系中的智能体运行与部署管理平台核心目标是把 Agent 从“开发态”稳定带到“生产态”。首版本主要支持低码方式的 Agent 发布与 openJiuwen Studio 联动输入 Agent IR 文件后即可一键部署并拉起 Agent 服务当前版本推荐通过源码方式使用 Runtime拉取代码后可通过启动脚本一键完成安装与启动。环境要求在开始之前请确认运行环境满足以下要求依赖版本要求用途Python3.11.4运行 Runtime 服务与低码 Agent 的运行解释器uv0.25.x创建隔离虚拟环境并安装依赖包git无版本要求拉取仓库代码含子模块bashLinux/macOS 原生 Shell执行启动脚本Git BashWindows 系统在 Windows 上模拟 bash 环境执行启动脚本说明Windows 下仓库还提供了 PowerShell 启动脚本scripts/run-server.ps1详见 README_zh.md 与 scripts/run-server.ps1。一键启动 Runtime 服务1) 准备环境配置Runtime 服务的核心配置位于 server/.env.example请参考配置说明将其复制为server/.env并按需编辑cd server cp .env.example .env修改时重点注意以下核心配置项RUNTIME_DB_TYPE数据库类型完整支持mysql、sqlite、gaussdb、opengauss四个可选值默认sqliteMODE运行模式一键启动/正式部署场景需将值改为product生产运行模式优先从标准依赖环境、PyPI 仓库加载依赖其他运行时相关参数如IP主机地址、PORT端口号等。从源码结构看上述配置由 foundation/openjiuwen_runtime/foundation/config.py 通过 PydanticSettings统一解析并内置了动态必填校验当RUNTIME_DB_TYPE为mysql/gaussdb/opengauss时RUNTIME_DB_HOST、RUNTIME_DB_PORT、RUNTIME_DB_USER、RUNTIME_DB_PASSWORD、RUNTIME_DB_NAME缺一不可否则启动时直接抛出ValueErrorDEPLOY_TYPE为docker/k8s时则强制要求配置LOWCODE_IMAGE。配置完成后在终端加载环境变量set -a; source .env; set a2) 安装 Runtime 包Linux / macOS / WindowsGit Bash通用步骤如下# 首先初始化并启用独立隔离的虚拟运行环境实现依赖隔离与版本管控 uv venv source .venv/Scripts/activate # Windows(Git Bash) source .venv/bin/activate # Linux/MacOS # 安装 Runtime 包 uv pip install agent-runtime-server安装完成后可再次按需修改server/.env中的配置项重点包括RUNTIME_DB_TYPE支持mysql、sqlite、gaussdb、opengauss其他运行时相关参数如IP地址、PORT端口号等。数据库可选依赖说明默认安装仅包含sqlite/mysql所需依赖当RUNTIME_DB_TYPEgaussdb或RUNTIME_DB_TYPEopengauss时还需要额外安装async-gaussdb若手工安装请执行uv pip install -e ./foundation[gaussdb]。仓库自带启动脚本如 scripts/deploy_dev_server.sh、scripts/run-server.ps1会根据server/.env中的RUNTIME_DB_TYPE自动选择../foundation或../foundation[gaussdb]作为安装目标并顺带构建applications/lowcode_agent、service、foundation等模块的 WHL 产物到DIST_DIR指定的目录。3) 执行启动脚本python -m openjiuwen_runtime.server.main默认启动后可通过8186端口访问 Runtime 服务。从 server/openjiuwen_runtime/server/main.py 可以看到最终入口通过uvicorn.run(app, hostsettings.HOST, portsettings.PORT)拉起 FastAPI 应用其中HOST默认0.0.0.0、PORT默认8186均可在.env中覆盖。服务启动时会根据RUNTIME_DB_TYPE选择对应的数据库处理器SQLiteHandler/MySQLHandler/GaussDBHandler并在应用生命周期内完成部署管理的初始化与关闭。启动完成后可通过GET /health健康检查接口确认服务状态。发布智能体Runtime 支持两种智能体发布方式低码发布通过 openJiuwen Studio 一键发布当前已开放高码发布待开放。通过 Studio 发布低码智能体在 Runtime 服务启动后需要在 openJiuwen Studio 后端的.env中配置好 Runtime 的地址和端口完成对接后即可在 Studio 中一键发布 Agent。在 Studio 中配置 Runtime 服务连接在 agent-studio 根目录从.env.example复制.env文件打开.env文件修改 Runtime 服务的配置# Runtime 服务配置样例 RUNTIME_HOSTlocalhost RUNTIME_PORT8186其中RUNTIME_HOST指向 Runtime 服务所在主机的 IP 或域名RUNTIME_PORT与server/.env中的PORT默认 8186保持一致。发布智能体操作步骤进入智能体编辑页面配置好智能体的信息并调试成功点击发布按钮。页面将打开发布弹窗可选择草稿版本或之前已经提交的版本发布。如果选择草稿版本会弹出版本提交界面把当前草稿提交为新版本后发布。发布完成后会展示“发布成功卡片”可点击发布管理按钮进入发布管理页面查看发布的智能体的详情。发布后在智能体编辑页面右上角有发布管理入口按钮。鼠标悬浮在发布按钮上也能看到发布信息。发布动作背后的原理从 server/openjiuwen_runtime/server/main.py 可以看到Studio 提交发布后Runtime 通过POST /api/v1/agents/deploy接口接收上传的ir.jsonAgent IR 文件将其落盘到部署目录DEPLOY_DIR再交由DeploymentManager.deploy_agent()依据部署模式拉起 Agent 实例最后返回deployment_id、type、name、status、url等运行信息。低码 Agent 的完整部署、查询、删除与状态管理接口均基于该 REST API 暴露。对话体验进入发布管理页面后在对话体验页签下可以进行对话体验测试智能体的效果。对话链路对应 README 中描述的 Agent 应用标准接口部署完成后Agent 实例通过其运行端口提供GET /health健康检查、POST /query对话查询支持流式响应与POST /reset_conversation重置会话上下文详见 README_zh.md。查看 API 调用示例api 调用页签展示调用运行态智能体的 API 参数包括请求方式、url、body、返回结构等。在请求配置里输入参数会把你输入的参数自动放入右侧 curl / python / javascript 示例代码中便于你直接复制样例代码运行。这一步将“运行态智能体”从 UI 操作还原为可编程调用的 HTTP 接口业务侧即可基于该示例代码将智能体接入自有系统。关于业务接入的更多细节可参考 Agent 接入。下架智能体当你不需要该运行态的智能体时可以在发布管理页标题栏右侧点击下架按钮页面会弹出确认框点击确认后系统将移除该智能体的运行态部署。下架成功后会提示成功并跳转回智能体列表页。下架动作在服务端对应DELETE /api/v1/agents/{deployment_id}接口见 server/openjiuwen_runtime/server/main.py删除成功后返回Deployment {deployment_id} deleted该接口同样受租户上下文约束仅能删除当前租户的部署。通过高码发布智能体待开放高码发布能力当前处于待开放状态后续版本将补充请关注仓库 README_zh.md 的 Roadmap 与文档更新。常见问题与排错建议数据库连接失败检查server/.env中RUNTIME_DB_TYPE与数据库连接参数是否匹配使用mysql/gaussdb/opengauss时必须同时提供主机、端口、用户、密码与库名且数据库需提前创建服务不会自动建库。内网/受限环境安装依赖失败通过UV_EXTRA_ARGS为 uv 命令添加额外参数例如--native-tls --allow-insecure-host mirrors.aliyun.com -i https://mirrors.aliyun.com/pypi/simple可缓解 SSL 证书校验失败、TLS 握手异常、镜像源连接失败等问题参数间用空格分隔并整体用双引号包裹。端口被占用修改server/.env中的PORT建议 1024 以上未占用端口修改后需重启 runtime-server 并在防火墙中开放对应端口。配置不生效所有配置项均为键值格式等号前后不可有空格注释以#开头。修改配置后必须重启 runtime-server 服务方可生效。容器化低码 Agent 启动失败若使用DEPLOY_TYPEdocker需确保宿主机 Docker 服务已正常启动、LOWCODE_IMAGE配置正确且 runtime-server 具备访问 Docker 服务的权限详细步骤可参考 Agent 部署。延伸阅读项目介绍Runtime 定位、核心能力与模块架构配置说明server/.env全部环境变量详解与修改建议Agent 部署进程、Docker、K8s 多策略部署详解Agent 接入业务系统接入 Runtime / Agent 的方式server/.env.example可直接复制的完整配置模板server/openjiuwen_runtime/server/main.pyRuntime 管理服务入口与 REST API 实现foundation/openjiuwen_runtime/foundation/config.py环境变量解析与必填校验逻辑赞分享人工智能AI Agent后端LLMOps【免费下载链接】agent-runtimeopenJiuwen Agent Runtime 是 openJiuwen 体系中的智能体运行与部署管理平台致力于将 Agent 从“开发态”稳定带到“生产态”让发布、运行、管理更加标准与可控。项目地址https://gitcode.com/openJiuwen/agent-runtime点击查看免费下载相关推荐ok-ww 鸣潮自动化工具完整指南三步跑通自动战斗、刷 4C 声骸与一键日常ok ww 鸣潮自动化工具完整指南三步跑通自动战斗、刷 4C 声骸与一键日常 ok ww 是一个基于图像识别的《鸣潮》自动化程序核心功能涵盖自动战斗、自动刷GUI 自动化计算机视觉RPA人工智能openJiuwen Agent Runtime 快速上手指南从环境部署到 Studio 一键发布低码 AgentopenJiuwen Agent Runtime 快速上手指南从环境部署到 Studio 一键发布低码 Agent openJiuwen Agent Runt人工智能AI Agent后端LLMOpsGetQzonehistory完整指南3步导出QQ空间全部历史说说到本地ExcelGetQzonehistory完整指南3步导出QQ空间全部历史说说到本地Excel 翻QQ空间记录找早年发的说说翻到某年就翻不动了——更早的呢去哪儿了G网页爬虫数据分析上一篇Python性能监控终极指南使用cProfile深度分析代码性能下一篇告别黑盒ReVanced Manager资源处理核心AAPT2工具链全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考