uAgents 项目介绍
uAgents 是由 Fetch.ai 开发的一个库,旨在帮助用户使用 Python 创建自主的人工智能代理。通过这个库,用户可以使用简单且富有表现力的装饰器,让代理定期执行任务或在特定事件发生时采取行动。
项目特点
- 🤖 简单的创建与管理:用户可以根据需求创建各种类型的代理,并在代码中实现。
- 🔗 互联性:每个代理在启动时会自动连接到不断增长的 uAgents 网络,并通过 Almanac(一个部署在 Fetch.ai 区块链上的智能合约)注册。
- 🔒 安全性:uAgents 的消息和钱包均采用加密技术保护,确保其身份和资产的安全。
快速开始
安装
用户可以在 Python 3.9 到 3.12 上安装 uAgents,通过以下命令即可轻松安装:
pip install uagents
创建代理演示
创建一个代理
使用以下脚本创建第一个 uAgent:
from uagents import Agent, Context
alice = Agent(name="alice", seed="alice recovery phrase")
其中 seed
参数用于设置固定地址,也可以忽略此参数让系统每次生成一个新的随机地址。
给代理分配任务
为代理分配一个简单的任务,例如打招呼:
@alice.on_interval(period=2.0)
async def say_hello(ctx: Context):
ctx.logger.info(f'hello, my name is {ctx.agent.name}')
if __name__ == "__main__":
alice.run()
运行代理
根据上述代码,用户可以这样运行代理:
python agent.py
之后在终端界面中即可看到运行结果。
文档与示例
官方文档
要了解完整的设置说明和高级功能,请参见官方文档:
此项目中还提供了各种示例以及更深入的库使用方法:
参与贡献
uAgents 项目欢迎任何形式的贡献。贡献不仅限于代码,任何关于文档或开发者提出的问题帮助也同样欢迎。请参阅我们的贡献指南了解更多信息。
开发与问题处理
有关开发的有用提示可以查看我们的开发指南。对于需求和错误追踪,我们使用 GitHub Issues,普通问题和讨论则在 GitHub Discussions 进行。
免责声明
uAgents 是一个“按原样”提供的软件,不含任何明示或暗示的担保。使用软件即表示用户愿意承担其使用过程中可能产生的所有风险,开发人员和贡献者对因使用该软件而发生的任何损失、损害或其他后果不承担责任。
许可证
uAgents 项目基于 Apache License 2.0 许可协议发布。