openYuanrong agent runtime CLI命令详解:deploy与exec实用教程
openYuanrong agent runtime CLI命令详解deploy与exec实用教程【免费下载链接】yuanrong-agentruntimeopenYuanrong agent runtimeopenYuanRong Agent 运行时支持 AI Agent 的分布式调度与执行项目地址: https://gitcode.com/openeuler/yuanrong-agentruntime前往项目官网免费下载https://ar.openeuler.org/ar/openYuanrong agent runtime是openEuler社区推出的AI Agent运行时框架支持AI Agent的分布式调度与执行。本文将详细介绍其CLI工具中最常用的deploy与exec命令帮助新手快速掌握AI Agent的部署与执行技巧。一、CLI工具基础准备在使用deploy和exec命令前需先通过以下命令克隆项目并安装CLI工具git clone https://gitcode.com/openeuler/yuanrong-agentruntime cd yuanrong-agentruntime pip install -e ./cli安装完成后可通过ar-cli --help查看所有可用命令核心功能集中在cli/ar_cli/commands/目录下。二、deploy命令一键部署AI Agent2.1 命令功能与核心参数deploy命令用于将Agent规范文件部署到运行时环境定义在deploy.py中。其基本语法为ar-cli deploy --spec agent规范文件 --server 运行时服务地址关键参数说明--spec必填Agent的JSON规范文件路径包含Agent元信息与执行逻辑--server必填openYuanrong运行时服务的访问地址2.2 实用部署示例部署本地开发的AI Agentar-cli deploy --spec ./my_agent.spec.json --server http://127.0.0.1:8080该命令会将规范文件上传至指定服务器完成Agent的注册与初始化流程。部署成功后Agent将进入就绪状态等待执行请求。三、exec命令灵活执行Agent任务3.1 命令功能与核心参数exec命令用于触发已部署Agent的执行定义在exec.py中。支持多种执行模式与上下文控制基本语法为ar-cli exec --agent agentURN [--input 输入数据] [--session-id 会话ID]核心参数解析--agent必填Agent的唯一标识functionVersionUrn--input可选JSON格式的任务输入数据--session-ctx可选会话上下文信息用于维持多轮对话状态--session-id可选指定会话ID便于追踪任务执行历史3.2 典型执行场景3.2.1 基础任务执行ar-cli exec --agent urn:openyuanrong:agent:demo:v1 --input {prompt:生成一份周报}3.2.2 多轮会话执行ar-cli exec --agent urn:openyuanrong:agent:chatbot:v2 \ --input {question:如何安装openYuanrong?} \ --session-id user_12345 \ --session-ctx {history:[{role:user,content:介绍下openYuanrong}]}四、常见问题解决4.1 部署失败规范文件格式错误检查JSON文件是否符合AGENTS.md中定义的规范重点验证name、version和entrypoint字段。4.2 执行超时网络连接问题确认--server地址是否可达可通过以下命令测试连接性curl http://server_address/health五、总结通过deploy与exec命令开发者可以轻松完成AI Agent的全生命周期管理。deploy命令实现规范定义到运行时的一键部署exec命令则提供灵活的任务触发与会话控制能力。结合tests/cli/目录下的测试用例可进一步探索命令的高级用法。掌握这两个核心命令后你已具备使用openYuanrong agent runtime构建分布式AI应用的基础能力。后续可深入学习fork和resume命令实现更复杂的Agent编排与状态管理。【免费下载链接】yuanrong-agentruntimeopenYuanrong agent runtimeopenYuanRong Agent 运行时支持 AI Agent 的分布式调度与执行项目地址: https://gitcode.com/openeuler/yuanrong-agentruntime创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考