使用说明
AgentKit
Every agent deserves a wallet.
目录
📖 概述
AgentKit是 Coinbase开发者平台 为AI代理提供加密钱包和链上交互的工具包。它被设计为与框架无关,因此您可以将其与任何AI框架一起使用,与钱包无关,因此可以与任何钱包一起使用。借助AgentKit,您可以实现免费的稳定币支付,并无缝地将您的AI代理货币化。AgentKit正在积极构建中 欢迎社区捐款!
Watch our welcome guide above to understand what AgentKit is, learn how to navigate this repository, and get started building your first onchain AI agent.
🚀 快速启动
Node.js
先决条件:
- 让您的代理运行:
# Create a new fullstack agent project
npm create onchain-agent@latest
# Navigate to your project directory
cd onchain-agent
# At this point, fill in your CDP API key name, OpenAI API key, and any other environment variables in the .env.local file.
# Then, rename the .env.local file to .env
mv .env.local .env
# Install dependencies
npm install
# Run the development server
npm run dev
- 访问
http://localhost:3000在浏览器中,开始告诉你的代理在链上做事情!
User: Fund my wallet with some testnet ETH.
Agent: Your wallet has been successfully funded with testnet ETH. You can view the transaction [here](https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca)
python
先决条件:
- 让您的代理运行:
# Create a new agent chatbot
pipx run create-onchain-agent
# Navigate to your project directory
cd onchain-agent
# At this point, fill in your CDP API key name, OpenAI API key, and any other environment variables in the .env.local file.
# Then, rename the .env.local file to .env
mv .env.local .env
# Install dependencies
poetry install
# Run the chatbot
poetry run python chatbot.py
- 选择“1。聊天模式”,并开始告诉你的代理在链上做事情!
Prompt: Fund my wallet with some testnet ETH.
-------------------
Wallet: ccaf1dbf-3a90-4e52-ad34-89a07aad9e8b on network: base-sepolia with default address: 0xD9b990c7b0079c1c3733D2918Ee50b68f29FCFD5
-------------------
-------------------
Received eth from the faucet. Transaction: https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca
-------------------
Your wallet has been successfully funded with testnet ETH. You can view the transaction [here](https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca).
-------------------
🗂 存储库结构
AgentKit被组织为两个monorepos,一个用于Python,一个为Typescript,每个都包含多个包。
agentkit/
├── typescript/
│ ├── agentkit/
│ │ └── src/
│ │ ├── action-providers/ # find 50+ actions in here
│ │ └── wallet-providers/
│ │ ├── cdp/
│ │ ├── privy/
│ │ └── viem/
│ │ └── scripts/generate-action-provider/ # use this to create new actions
│ ├── create-onchain-agent/
│ ├── framework-extensions/
│ │ ├── langchain/
│ │ ├── vercel-ai-sdk/
│ │ └── model-context-protocol/
│ └── examples/
│ ├── langchain-cdp-chatbot/
│ ├── langchain-farcaster-chatbot/
│ ├── langchain-privy-chatbot/
│ ├── langchain-solana-chatbot/
│ ├── langchain-twitter-chatbot/
│ ├── langchain-xmtp-chatbot/
│ ├── model-context-protocol-smart-wallet-server/
│ └── vercel-ai-sdk-smart-wallet-chatbot/
├── python/
│ ├── coinbase-agentkit/
│ │ └── coinbase_agentkit/
│ │ ├── action_providers/ # find 30+ actions in here
│ │ └── wallet_providers/
│ │ ├── cdp/
│ │ ├── privy/
│ │ └── viem/
│ ├── create-onchain-agent/
│ ├── framework-extensions/
│ │ ├── langchain/
│ │ └── openai-agents-sdk/
│ └── examples/
│ ├── langchain-cdp-chatbot/
│ ├── langchain-eth-account-chatbot/
│ ├── langchain-smart-wallet-chatbot/
│ ├── langchain-twitter-chatbot/
│ └── openai-agents-cdp-voice-chatbot/
│ └── openai-agents-sdk-smart-wallet-chatbot/
🤝 贡献
AgentKit正在积极寻找社区贡献!
- 要查看我们希望看到的开源贡献的行动和框架列表,请参阅 WISHLIST.md.
- 要了解为AgentKit做出贡献的过程,请参阅 贡献.md.
📜 文档
- AgentKit文档
- Python API参考
- Node.js API参考
🌙 夜间构建
要访问AgentKit的最新版本,您可以为您的语言安装夜间构建。这是最新代码的构建 main 分支,并每晚更新。
打字稿
您可以使用以下命令安装最新的夜间版本:
npm install @coinbase/agentkit@nightly @coinbase/agentkit-langchain@nightly
如果您使用的是Langchain以外的AI框架,请确保安装相应的软件包,而不是 @coinbase/agentkit-langchain.
要安装特定版本的夜间构建,您可以指定确切的版本。例如,如果你想从2025年2月20日开始安装夜间构建,你可以运行以下命令:
npm install @coinbase/agentkit@0.2.3-nightly.20250220.0 @coinbase/agentkit-langchain@0.2.3-nightly.20250220.0
python
您可以使用以下命令安装最新的夜间版本:
pip install --pre coinbase-agentkit coinbase-agentkit-langchain
# or, using poetry
poetry add coinbase-agentkit coinbase-agentkit-langchain --allow-prereleases
如果您使用的是Langchain以外的AI框架,请确保安装相应的软件包,而不是 coinbase-agentkit-langchain.
要安装特定版本的夜间构建,您可以指定确切的版本。例如,如果你想从2025年2月20日开始安装夜间构建,你可以运行以下命令:
pip install coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220
# or, using poetry
poetry add coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220 --allow-prereleases
🚨 安全和Bug报告
AgentKit团队非常重视安全。 看 安全.md 了解更多信息。
📧 联系
有关功能请求、反馈或问题,请通过 Coinbase开发者平台不一致.
🔗 支持的钱包、协议和框架
AgentKit很自豪能够支持以下协议、框架、钱包和网络。有关支持的提供商的详细文档,请参阅:
钱包
协议
框架
网络
注意:我们支持所有EVM和SVM网络,并对上述网络提供深度协议支持。请不要犹豫,为您的首选网络提供更多支持。
📝 许可证
AgentKit根据 阿帕奇-2.0 许可证。
🔒 法律和隐私
AgentKit软件新颖且具有实验性,因此是在AS-is的基础上提供的。该软件仅用于协助设计区块链交易和使用自然语言输入实现其他API集成的目的,不用于提供(i)要约或要约邀请,投资或买卖任何权益或股票,或参与任何投资或交易策略,(ii)会计、法律、税务建议、投资建议或其他专业建议,或(iii)Coinbase的官方声明。代理人通过AgentKit软件提出或执行的行为不是Coinbase的行为。在根据软件提供的信息做出任何决定之前,您应该咨询专业顾问。您不得使用贷款或信贷收益在coinbase.com、coinbase的API、coinbase移动应用程序或任何其他coinbase网站或产品(包括AgentKit)上或通过这些平台购买数字资产。对于软件或与软件相关的任何信息的准确性、完整性、可靠性、安全性或适用性,不作任何明示或暗示的陈述或保证。使用该软件的损失风险可能很大,您承担任何和所有损失和责任风险。软件可能会产生不准确、不正确、不可预测或不理想的输出,用户全权负责评估输出和用例,并确定其是否合适。使用该软件的权利取决于您是否同意 CDP服务条款 (除非它与Apache-2.0许可证冲突)。
