uAgents

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 许可协议发布。