주요 콘텐츠로 건너뛰기
버전: 2.0.0

CDP의 에이전트 키트 시작 템플릿

개요​

이 템플릿은 코인베이스의 에이전트 키트에 의해 구동되는 온체인 에이전트와 프론트엔드에 Next.js 프레임워크, 에이전트의 설정을 위한 LangGraph를 보여줍니다. 이 에이전트는 AI 기반 온체인 기능을 위해 설계되었습니다.

에이전트키트는 대규모 언어 모델(LLM) 추론을 위해 Gaia 노드를 사용하여 이러한 상호작용을 처리합니다.

cdp-image

특징​

  • AI 기반 온체인 상호작용: 에이전트키트를 활용하여 AI 에이전트가 블록체인 네트워크에서 작업을 수행할 수 있도록 합니다.

  • 부트스트랩: 서버에 LangGraph가 포함된 Next.js 프로젝트로 빌드되며, 다음을 사용하여 부트스트랩됩니다. 엔피엠 생성 온체인 에이전트@최신 버전.

  • 구성 가능한 LLM: 도구 사용 추론을 위해 특별히 구성된 Gaia 노드에서 호스팅되는 LLM과의 통합을 지원합니다(예: Llama-3-Groq-8B-Tool, Llama-3.3-70B-Instruct-Q5_K_M).

  • 지갑 관리: 와 통합 스마트 지갑 공급자 를 통해 지속적인 지갑 데이터 관리와 함께 블록체인 상호작용을 지원합니다.

  • 확장 가능한 액션: 다양한 액션 공급자(예: WETH, Pyth, ERC20, CDP API, 월렛 액션)를 활용하여 에이전트의 기능을 정의합니다.

  • 채팅 인터페이스: 상담원과 상호작용할 수 있는 사용자 친화적인 채팅 인터페이스를 제공합니다.

  • 스트리밍 응답: 보다 대화형 사용자 경험을 위해 상담원 응답이 스트리밍됩니다.

  • 메모리: 다음을 사용하여 대화를위한 메모리를 통합합니다. 메모리 세이버 에서

시작하기​

전제 조건​

  1. Node.js 18 이상이 설치되어 있습니다.
  2. npm 9 이상이 설치되어 있는지 확인합니다.

Node.js 및 npm 버전을 확인하세요:

node --version # 18 이상이어야 함
npm --version #은 9 이상이어야 합니다.
  1. 예를 들어 퍼블릭 Gaia 노드( https://llama70b.gaia.domains/v1 )를 사용하거나 로컬에서 노드를 실행할 수 있습니다.

새 프로젝트 만들기​

CLI를 사용하여 아래 명령어로 새 Agenkit 프로젝트를 부트랩할 수 있습니다:

엔피엠 생성 온체인 에이전트@최신 버전

CLI의 지침에 따라 프로젝트를 설정하고 스마트 지갑(기본값) 옵션을 선택해 설정합니다. 다음 중에서 프레임워크를 선택할 수도 있습니다:

  • LangChain
  • 버셀 AI SDK

MCP(모델 컨텍스트 프로토콜) 옵션도 있지만, 이 가이드에서는 LangChain 옵션을 사용하는 방법을 다룹니다.

비밀 및 값 구성​

이름을 변경합니다. .env.example 에 .env 를 클릭하고 아래 값이 있는지 확인합니다:

CDP_API_KEY_NAME==
CDP_API_KEY_Private_KEY=

# 선택 사항
NETWORK_ID=base-sepolia

다음 값을 얻으려면 CDP_API_KEY_NAME 그리고 CDP_API_KEY_개인키 로 이동하여 CDP 포털 를 클릭하여 새 API 키를 만듭니다. 표시되는 모달에서 API 키 이름과 비공개 키 값을 복사합니다.

그리고 NETWORK_ID 로 유지될 수 있습니다. 베이스-세폴리아 그리고 가능한 네트워크 옵션 도 마찬가지입니다.

프로젝트 구조​

└── 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

Gaia 통합​

정보

로컬 Gaia 노드에는 API 키가 필요하지 않습니다. 퍼블릭 노드를 사용하려면 Gaia API 키가 필요합니다.

LLM 추론은 Gaia 노드로 오프로드됩니다:

  • LLM은 다음에서 구성됩니다. 앱/api/에이전트/에이전트 만들기.ts.
  • 이 프로젝트는 다음을 사용합니다. ChatOpenAI 에서 랑체인/오픈아이 를 클릭해 가이아 노드에 연결합니다.
  • 구성된 특정 모델은 "Llama-3-Groq-8B-Tool"입니다.
  • Gaia 노드 엔드포인트는 다음을 통해 설정됩니다. baseURL 에서 ChatOpenAI 구성:

예를 들어 머신에서 로컬 노드를 실행하는 경우입니다:

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)
  },
});

템플릿 실행​

아래 명령은 템플릿을 실행합니다:

npm 실행 개발

템플릿이 실행되면 상담원을 테스트하는 데 사용할 수 있는 몇 가지 예제 메시지가 표시됩니다:

  • "지갑 주소가 어떻게 되나요?"
  • "지갑 잔액이 얼마인가요? 확인하고 확인하세요."
  • "모든 관련 정보를 포함한 지갑 세부 정보를 공유하세요."

문서​

자세한 정보 및 고급 주제는 다음 공식 문서를 참조하세요: