如何快速上手openYuanrong agent runtime？5分钟入门教程

如何快速上手openYuanrong agent runtime？5分钟入门教程

【免费下载链接】yuanrong-agentruntimeopenYuanrong agent runtime：openYuanRong Agent 运行时，支持 AI Agent 的分布式调度与执行项目地址: https://gitcode.com/openeuler/yuanrong-agentruntime

前往项目官网免费下载：https://ar.openeuler.org/ar/

想要快速掌握AI Agent的分布式调度与执行？openYuanrong agent runtime正是您需要的终极解决方案！这个强大的Python CLI工具让AI Agent的部署和调用变得前所未有的简单。通过ar命令，您可以将Agent的注册、调用封装为对底层FaaS HTTP接口的访问，实现高效的AI应用开发。🎯

为什么选择openYuanrong agent runtime？

openYuanrong agent runtime是一个专为AI Agent设计的运行时环境，支持分布式调度与执行。它提供了简单易用的命令行工具ar，让开发者能够：

• 快速部署AI Agent：通过ar deploy命令轻松注册Agent
• 实时调用与流式响应：使用ar exec进行交互式调用，支持SSE流式输出
• 会话管理：内置会话上下文和实例会话支持
• 开箱即用：无需复杂配置，5分钟即可上手

第一步：安装ar命令行工具

在项目根目录的cli/文件夹下执行以下命令进行安装：

cd cli/ pip install .

或者先构建whl包再安装：

python setup.py bdist_wheel pip install dist/openyuanrong_agentruntime-*.whl

安装完成后，您就可以使用ar命令了！试试运行ar -h查看帮助，或者ar --version查看版本信息。

第二步：部署您的第一个AI Agent

部署AI Agent非常简单，只需要一个JSON格式的函数定义。您可以选择两种方式：

方式一：使用JSON文件

ar deploy -s ./agent.json --server 127.0.0.1:31182

方式二：使用inline JSON字符串

ar deploy -s '{"name":"0@svc@demo","runtime":"python3.11","handler":"demo.handler"}' --server 127.0.0.1:31182

部署成功后，系统会返回一个functionVersionUrn，这个URN将在后续调用中使用。

第三步：调用AI Agent进行交互

调用Agent同样简单，支持两种模式：

一次性调用模式（传入参数）：

ar exec --agent <URN> --server 127.0.0.1:31180 --args '{"message":"你好，世界！"}'

交互式调用模式（不传参数）：

ar exec --agent <URN> --server 127.0.0.1:31180

在交互模式下，您可以持续输入内容，每次输入都会自动包装为{"message":"您输入的内容"}并发送给Agent。输入/exit或/quit即可退出。

第四步：高级功能探索

会话管理功能

openYuanrong agent runtime提供了强大的会话管理功能：

# 带会话上下文的调用 ar exec --agent <URN> --server 127.0.0.1:31180 \ --session-ctx ctx1 --session-id id1 \ --session-ttl 90 --concurrency 1 \ --args '{"param1":"测试参数"}'

• --session-ctx：Agent会话上下文，传入才会携带X-Agent-Session请求头
• --session-id：实例会话ID，传入才会携带X-Instance-Session请求头
• --session-ttl：实例会话TTL，默认90秒
• --concurrency：实例会话并发数，默认1

调试与日志

开启详细日志模式，查看请求详情：

ar -v exec --agent <URN> --server 127.0.0.1:31180

普通日志输出到stderr，流式数据输出到stdout，互不干扰。如果需要保存日志，可以重定向输出：

ar exec ... 2> ar.log

第五步：理解核心架构

openYuanrong agent runtime的架构设计简洁而强大：

• cli/ar_cli/main.py：CLI入口点，处理全局参数和命令注册
• cli/ar_cli/commands/deploy.py：ar deploy命令实现，通过meta_service注册Agent
• cli/ar_cli/commands/exec.py：ar exec命令实现，调用frontend并处理SSE流式响应
• cli/ar_cli/client.py：HTTP客户端，封装注册和调用请求
• cli/ar_cli/sse.py：SSE流解析与结束条件处理

常见问题与解决技巧

问题1：部署时spec解析失败

确保您的JSON格式正确，或者JSON文件路径有效。可以使用在线JSON验证工具检查格式。

问题2：调用时连接失败

检查--server参数是否正确，确保服务地址和端口可访问。

问题3：交互模式无法退出

在交互模式下，输入/exit或/quit即可安全退出。

问题4：需要更多调试信息

使用-v或--verbose参数开启详细日志，查看请求的完整详情。

退出码说明

了解退出码有助于快速定位问题：

• 0：成功
• 1：服务端失败（HTTP非2xx，或响应code != 0）
• 2：参数错误（JSON非法、文件不存在、缺少必选参数）
• 3：网络错误（连接不上、超时）

开始您的AI Agent之旅吧！

现在您已经掌握了openYuanrong agent runtime的核心使用方法。这个工具的设计哲学是"简单即强大"，让您能够专注于AI Agent的业务逻辑，而不是底层通信细节。

记住这个简单的流程：安装 → 部署 → 调用 → 优化。随着您对工具越来越熟悉，可以探索更多高级功能，如自定义会话管理、批量调用优化等。

openYuanrong agent runtime是openEuler社区的开源项目，欢迎贡献代码和反馈问题。让我们一起构建更强大的AI Agent生态系统！🚀

提示：项目位于cli/目录，所有核心代码都在cli/ar_cli/文件夹中。如果您想深入了解实现细节，可以查看这些源码文件。

【免费下载链接】yuanrong-agentruntimeopenYuanrong agent runtime：openYuanRong Agent 运行时，支持 AI Agent 的分布式调度与执行项目地址: https://gitcode.com/openeuler/yuanrong-agentruntime