CDP Agentkit 工具包
CDP Agentkit 工具包包含允许 LLM 代理与 Coinbase 开发者平台 交互的工具。该工具包提供了 CDP SDK 的包装器，允许代理执行链上操作，如转账、交易和智能合约交互。
概述
集成详情
| 类 | 包 | 可序列化 | JS 支持 | 最新包 |
|---|---|---|---|---|
| CdpToolkit | cdp-langchain | ❌ | ❌ |  |
工具功能
该工具包提供以下工具
- get_wallet_details - 获取 MPC 钱包的详细信息
- get_balance - 获取特定资产的余额
- request_faucet_funds - 从水龙头请求测试代币
- transfer - 在地址之间转移资产
- trade - 交易资产（仅限主网）
- deploy_token - 部署 ERC-20 代币合约
- mint_nft - 从现有合约铸造 NFT
- deploy_nft - 部署新的 NFT 合约
- register_basename - 为钱包注册基本名称
我们鼓励您添加自己的工具，使用 CDP 和 web2 API，创建一个适合您需求的代理。
设置
总体而言，我们将
- 安装 langchain 包
- 设置您的 CDP API 凭据
- 初始化 CDP 包装器和工具包
- 使用
toolkit.get_tools()将工具传递给您的代理
如果您想从单个工具的运行中获得自动跟踪，您也可以通过取消注释下面内容来设置您的 LangSmith API 密钥
# os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
# os.environ["LANGSMITH_TRACING"] = "true"
安装
此工具包位于 cdp-langchain 包中
%pip install -qU cdp-langchain
设置环境变量
要使用此工具包，您必须首先设置以下环境变量，以访问 CDP API，创建钱包并进行链上交互。您可以在 CDP 门户上免费注册 API 密钥
import getpass
import os
for env_var in [
"CDP_API_KEY_NAME",
"CDP_API_KEY_PRIVATE_KEY",
]:
if not os.getenv(env_var):
os.environ[env_var] = getpass.getpass(f"Enter your {env_var}: ")
# Optional: Set network (defaults to base-sepolia)
os.environ["NETWORK_ID"] = "base-sepolia" # or "base-mainnet"
实例化
现在我们可以实例化我们的工具包
from cdp_langchain.agent_toolkits import CdpToolkit
from cdp_langchain.utils import CdpAgentkitWrapper
# Initialize CDP wrapper
cdp = CdpAgentkitWrapper()
# Create toolkit from wrapper
toolkit = CdpToolkit.from_cdp_agentkit_wrapper(cdp)
工具
查看可用工具
tools = toolkit.get_tools()
for tool in tools:
print(tool.name)
在代理中使用
我们将需要一个 LLM 或聊天模型
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="gpt-4o-mini")
API 参考：ChatOpenAI
使用工具初始化代理
from langgraph.prebuilt import create_react_agent
tools = toolkit.get_tools()
agent_executor = create_react_agent(llm, tools)
API 参考：create_react_agent
示例用法
example_query = "Send 0.005 ETH to john2879.base.eth"
events = agent_executor.stream(
{"messages": [("user", example_query)]},
stream_mode="values",
)
for event in events:
event["messages"][-1].pretty_print()
预期输出
Transferred 0.005 of eth to john2879.base.eth.
Transaction hash for the transfer: 0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1e
Transaction link for the transfer: https://sepolia.basescan.org/tx/0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1
CDP 工具包特定功能
钱包管理
该工具包维护一个 MPC 钱包。可以导出和导入钱包数据，以便在会话之间持久化
# Export wallet data
wallet_data = cdp.export_wallet()
# Import wallet data
values = {"cdp_wallet_data": wallet_data}
cdp = CdpAgentkitWrapper(**values)
网络支持
该工具包支持多个网络
无 Gas 交易
一些操作支持在 Base 主网上进行无 Gas 交易
- USDC 转账
- EURC 转账
- cbBTC 转账
API 参考
有关所有 CDP 功能和配置的详细文档，请访问 CDP 文档。