Chuyển đến nội dung chính
Phiên bản: 2.0.0

Mẫu khởi động Agentkit của CDP

Tổng quan​

Mẫu này hiển thị một tác nhân trên chuỗi được hỗ trợ bởi AgentKit của Coinbase với khung Next.js ở giao diện người dùng và LangGraph để thiết lập tác nhân. Tác nhân được thiết kế cho các khả năng trên chuỗi do AI điều khiển.

AgentKit xử lý những tương tác này bằng cách sử dụng nút Gaia để suy luận Mô hình ngôn ngữ lớn (LLM).

cdp-hình ảnh

Đặc trưng​

  • Tương tác trên chuỗi do AI điều khiển : Tận dụng AgentKit để cho phép các tác nhân AI thực hiện các hành động trên mạng blockchain.

  • Tự khởi động: Được xây dựng như một dự án Next.js với LangGraph trong máy chủ, được khởi động bằng npm tạo onchain-agent@latest.

  • LLM có thể cấu hình : Hỗ trợ tích hợp với LLM được lưu trữ trên các nút Gaia, được cấu hình cụ thể để suy ra cách sử dụng công cụ (ví dụ: Llama-3-Groq-8B-Tool , Llama-3.3-70B-Instruct-Q5_K_M ).

  • Quản lý ví: Tích hợp với một Nhà cung cấp ví thông minh để tương tác blockchain, với quản lý dữ liệu ví liên tục.

  • Hành động mở rộng : Sử dụng nhiều Nhà cung cấp hành động khác nhau (ví dụ: WETH, Pyth, ERC20, CDP API, hành động Ví) để xác định khả năng của tác nhân.

  • Giao diện trò chuyện : Cung cấp giao diện trò chuyện thân thiện với người dùng để tương tác với nhân viên.

  • Phản hồi theo luồng : Phản hồi của tác nhân được truyền trực tuyến để mang lại trải nghiệm tương tác hơn cho người dùng.

  • Ký ức: Kết hợp bộ nhớ cho các cuộc hội thoại bằng cách sử dụng Bộ nhớ tiết kiệm từ LangGraph.

Bắt đầu​

Điều kiện tiên quyết​

  1. Đã cài đặt Node.js 18 trở lên
  2. Xác nhận npm 9 hoặc phiên bản mới hơn đã được cài đặt

Kiểm tra phiên bản Node.js và npm của bạn:

node --version # Phải từ 18 tuổi trở lên
 npm --version # Phải là 9+
  1. Bạn có thể sử dụng nút Gaia công khai, ví dụ: https://llama70b.gaia.domains/v1 hoặc chạy nút cục bộ .

Tạo một dự án mới​

Bạn có thể sử dụng CLI để khởi tạo một dự án Agenkit mới bằng lệnh bên dưới:

npm tạo onchain-agent@latest

Thực hiện theo hướng dẫn trên CLI để thiết lập dự án của bạn và chọn tùy chọn Smart wallet (mặc định) để thiết lập. Bạn cũng có thể lựa chọn khung trong số:

  • LangChain
  • Vercel AI SDK

Ngoài ra còn có tùy chọn Giao thức ngữ cảnh mô hình (MCP), nhưng trong hướng dẫn này, chúng tôi sẽ đề cập đến tùy chọn LangChain.

Cấu hình bí mật và giá trị​

Đổi tên .env.ví dụ ĐẾN .env và đảm bảo rằng bạn có các giá trị dưới đây:

CDP_API_KEY_NAME=
 CDP_API_KEY_PRIVATE_KEY=

 # Không bắt buộc
 NETWORK_ID=base-sepolia

Để có được các giá trị cho CDP_API_KEY_TÊN và CDP_API_KEY_KHÓA_RIÊNG TƯ đi đến Cổng thông tin CDP để tạo khóa API mới. Sao chép tên khóa API và giá trị khóa riêng từ hộp thoại xuất hiện.

Các MẠNG_ID có thể ở lại như căn cứ-sepolia và bạn có thể khám phá những điều có thể tùy chọn mạng cũng như vậy.

Cấu trúc dự án​

└── onchain-agent/
    ├── README.md
    ├── next-env.d.ts
    ├── next.config.js
    ├── package.json
    ├── postcss.config.mjs
    ├── tailwind.config.ts
    ├── tsconfig.json
    ├── wallet_data.txt
    ├── .eslintrc.json
    ├── .npmignore
    ├── .yarnrc.yml
    └── app/
        ├── globals.css
        ├── layout.tsx
        ├── page.tsx
        ├── api/
        │   └── agent/
        │       ├── create-agent.ts
        │       ├── prepare-agentkit.ts
        │       └── route.ts
        ├── hooks/
        │   └── useAgent.ts
        └── types/
            └── api.ts

Tích hợp Gaia​

Thông tin

Một nút Gaia cục bộ không yêu cầu khóa API. Bạn sẽ cần khóa API Gaia để sử dụng các nút công khai.

Suy luận LLM được chuyển đến một nút Gaia:

  • LLM được cấu hình trong ứng dụng/api/tác nhân/create-agent.ts.
  • Dự án sử dụng Trò chuyệnOpenAI từ @langchain/openai để kết nối với nút Gaia.
  • Mô hình cụ thể được cấu hình là "Llama-3-Groq-8B-Tool".
  • Điểm cuối của nút Gaia được thiết lập thông qua URL cơ sở trong Trò chuyệnOpenAI cấu hình:

Ví dụ với một nút cục bộ đang chạy trên máy:

const llm = new ChatOpenAI({
  model: "Llama-3-Groq-8B-Tool",
  configuration: {
    baseURL: "https://YOUR_NODE_ID.gaia.domains/v1", // Gaia node URL
    apiKey: "gaia", // API key for the Gaia node (if required)
  },
});

Chạy mẫu​

Lệnh bên dưới chạy mẫu:

npm chạy dev

Khi mẫu đang chạy, có một số lời nhắc mẫu mà bạn có thể sử dụng để kiểm tra tác nhân:

  • "Địa chỉ ví của bạn là gì?"
  • "Số dư trong ví của bạn là bao nhiêu? Hãy kiểm tra và xác nhận."
  • "Chia sẻ thông tin chi tiết về ví của bạn bao gồm mọi thông tin có liên quan."

Tài liệu​

Để biết thêm thông tin và các chủ đề nâng cao, hãy tham khảo tài liệu chính thức sau: