项目介绍
thirdweb AI
链上智能的AI代理
📖 概述
thirdweb AI 是 thirdweb 的全面工具包，用于区块链数据分析、钱包管理和与区块链交互的AI代理。它将复杂的区块链操作简化为五个核心组件：Insight 用于数据分析，Engine 用于钱包和合约操作，EngineCloud 用于基于云的引擎操作，Storage 用于去中心化文件管理，以及 Nebula 用于通过自然语言驱动的区块链交互。
🌐 功能
Insight
全面的区块链数据智能：
- Chains：多链支持和网络信息
- Transactions：交易分析和监控
- Blocks：区块数据探索和指标
- Events：智能合约事件跟踪和过滤
- Prices：实时代币价格推送
- Tokens：详细的代币信息和分析
Engine
核心区块链交互能力：
- Wallet：安全的钱包管理和交易签名
- Read：智能合约和区块链数据的读取操作
- Write：交易创建和合约交互
EngineCloud
具有高级功能的基于云的引擎操作：
- Server Wallets：创建和管理与KMS集成的服务器钱包
- Contract Interaction：从智能合约中读取和写入
- Transaction Management：发送交易并查询交易历史
- Balance Queries：检查各种链上的本地代币余额
Storage
去中心化存储能力：
- Upload：将文件、目录和JSON数据上传到IPFS
- Fetch：使用 thirdweb 网关从IPFS检索内容
Nebula
AI代理区块链交互：
- 自然语言代理动作：通过自然语言指令完成区块链任务
🚀 快速开始
MCP Server
安装
### 使用 uvx 运行
THIRDWEB_SECRET_KEY=... \
uvx thirdweb-mcp
### 使用 pipx 安装并运行 (并运行 thirdweb-mcp)
pipx install thirdweb-mcp
THIRDWEB_SECRET_KEY=... \
thirdweb-mcp
更多信息请参阅 这里
Python SDK
安装
# 安装带有所有框架适配器的核心包
pip install "thirdweb-ai[all]"
# 或者安装特定框架适配器
pip install "thirdweb--ai[openai]" # 对于 OpenAI 代理
pip install "thirdweb-ai[langchain]" # 对于 LangChain
pip install "thirdweb-ai[agentkit]" # 对于 Coinbase Agentkit
pip install "thirdweb-ai[goat]" # 对于 GOAT SDK
# 支持许多其他框架
查看 支持的框架和安装指南
基本用法
from thirdweb_ai import Engine, EngineCloud, Insight, Nebula, Storage, Tool
# 初始化服务
insight = Insight(secret_key=...)
nebula = Nebula(secret_key=...)
engine = Engine(...)
engine_cloud = EngineCloud(secret_key=..., vault_access_token=...) # 用于基于云的操作
storage = Storage(secret_key=...)
# 示例：为AI代理创建工具
# 选项1：单独使用Nebula（推荐在需要自给自足的区块链代理时）
# Nebula 内部已经使用了大多数其他服务
tools = [
*nebula.get_tools(),
]
# 选项2：不使用Nebula直接使用各个服务
# tools = [
# *insight.get_tools(),
# *engine.get_tools(),
# *engine_cloud.get_tools(),
# *storage.get_tools(),
# ]
# 示例：框架集成（LangChain）
from thirdweb_ai.adapters.langchain import get_langchain_tools
langchain_tools = get_langchain_tools(tools)
agent = create_tool_calling_agent(tools=langchain_tools, ...)
# 示例：框架集成（OpenAI 代理）
from thirdweb_ai.adapters.openai import get_openai_tools
openai_tools = get_openai_tools(tools)
agent = Agent(name="thirdweb Assistant", tools=tools)
# 查看 python/examples 中的其他框架集成
更多信息请参阅 这里
TypeScript SDK
即将推出。
📜 文档
要获取全面的文档，请访问：
🚨 安全性和错误报告
我们非常重视安全性。如果您发现 thirdweb AI 中的安全漏洞，请发送邮件至 security@thirdweb.com 而不是使用问题追踪器。
对于非安全相关的问题，请使用 GitHub 问题追踪器。
⚠️ 重要使用说明
当使用 Nebula 时，不要将其与其他工具（Insight、Engine、EngineCloud、Storage）在同一代理实现中结合使用，因为 Nebula 已经在后台调用了这些工具。同时使用它们可能会导致兼容性问题和意外行为。
📦 发布工作流程
要发布 thirdweb AI 包的新版本：
- 为新版本创建一个 git 标签：
git tag -a v0.X.Y -m "Release v0.X.Y" - 将标签推送到 GitHub：
git push origin v0.X.Y - 在 GitHub 上使用此标签创建一个发布
- CI/CD 管道将自动构建并将两个包发布到 PyPI，版本号匹配
📧 联系方式
- 网站：thirdweb.com
- X：@thirdweb
- Telegram：加入我们的社区
- Discord：加入我们的社区
- 邮箱：support@thirdweb.com
📝 许可证
thirdweb AI 采用 Apache-2.0 许可证。详情请参阅 LICENSE 文件。