openYuanrong agent runtime部署实战：一步步搭建分布式AI Agent环境

openYuanrong agent runtime部署实战：一步步搭建分布式AI Agent环境

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

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

openYuanrong agent runtime是一款强大的分布式AI Agent运行时工具，支持AI Agent的分布式调度与执行，让你轻松构建高效的智能应用。本文将详细介绍如何部署openYuanrong agent runtime，从环境准备到实际操作，助你快速搭建分布式AI Agent环境。

一、环境准备：满足部署的基本要求

在开始部署openYuanrong agent runtime之前，需要确保你的系统满足以下基本要求。虽然项目文档中未明确提及具体的Python版本要求，但考虑到其是Python CLI包，建议使用Python 3.7及以上版本，以保证兼容性。同时，确保系统已安装pip工具，用于后续的包安装。

二、安装步骤：快速获取openYuanrong agent runtime

获取openYuanrong agent runtime的方式有多种，你可以选择直接克隆仓库或者通过源码安装。

2.1 克隆仓库

首先，使用以下命令克隆项目仓库：

git clone https://gitcode.com/openeuler/yuanrong-agentruntime

2.2 源码安装

进入项目目录后，可通过以下两种方式进行安装。

2.2.1 直接安装

在项目根目录下执行：

pip install .

2.2.2 构建wheel包安装

先构建wheel包：

python setup.py bdist_wheel

然后安装生成的wheel包：

pip install dist/openyuanrong_agentruntime-*.whl

三、核心命令解析：掌握agent的注册与调用

openYuanrong agent runtime提供了ar命令，用于agent的注册和调用，下面详细介绍这两个核心命令。

3.1 ar deploy——注册agent

ar deploy命令用于通过meta_service注册一个agent（函数）。注册成功后会打印functionVersionUrn，可直接用于ar exec --agent。

3.1.1 使用配置文件注册

如果有现成的agent配置文件（如agent.json），可使用以下命令：

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

3.1.2 直接传入配置信息注册

也可以直接在命令中传入配置信息：

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

3.2 ar exec——调用agent(流式)

ar exec命令用于调用agent，并以SSE流式输出返回结果。当未传--args时会进入交互模式。

该命令的基本格式为：

ar exec --agent <FUNCTION_VERSION_URN> --server <FRONTEND_ADDR> [可选参数]

其中，--agent和--server是必选参数，--agent用于指定要调用的agent的functionVersionUrn，--server用于指定前端地址。

3.2.1 基本调用

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

3.2.2 带参数调用

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

3.2.3 开启调试模式调用

如果需要查看详细的调试信息，可以使用-v参数：

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

四、项目结构探秘：了解核心模块

openYuanrong agent runtime的项目结构清晰，主要包含以下核心模块：

• cli/: Python包源码与打包配置，其中cli/setup.py是openyuanrong-agentruntime包定义，console entry point为ar=ar_cli.main:main。
• cli/ar_cli/commands/deploy.py: 实现ar deploy命令，通过meta_service注册agent/function。
• cli/ar_cli/utils.py: 包含地址归一化、JSON/spec解析、日志配置等通用工具。
• pytest.ini: 测试配置，已将cli/加入pythonpath。

通过了解这些模块，你可以更好地理解项目的工作原理，为后续的使用和扩展打下基础。

五、总结：开启分布式AI Agent之旅

通过本文的介绍，你已经掌握了openYuanrong agent runtime的部署方法和核心命令的使用。从环境准备到实际操作，每一步都简单明了，让你能够快速搭建起分布式AI Agent环境。现在，你可以开始探索更多高级功能，利用openYuanrong agent runtime构建属于你的智能应用了！

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