Qude Framework open-source 코드를 이용한 AI 에이전트 개발 및 배포 가이드

Qude Framework의 오픈소스 코드는 사용자가 CLI(Command Line Interface)에서 직접 AI 에이전트를 생성할 수 있게 하며, Qude가 이를 구축하는 데 도움을 주는 코파일럿(co-pilot) 역할을 합니다. Qude API는 Qude Framework의 오픈소스 코드를 사용하여 생성된 AI 에이전트와의 상호작용을 가능하게 합니다.

• 에이전트 배포 (Agent Deployment): 사용자 정의 AI 에이전트를 Solana 블록체인에 배포합니다.

• 에이전트 상호작용 (Agent Interaction): 자연어 쿼리를 사용하여 배포된 에이전트와 상호작용합니다.

• 시장 분석 (Market Analysis): 시가총액(market cap), 주요 토큰 보유자, 거래 활동을 포함한 실시간 블록체인 데이터를 가져옵니다.

• 트렌드 통찰력 (Trend Insights): 트렌드 토큰을 발견하고 거래 패턴을 분석합니다.

• 사용자 정의 쿼리 (Custom Queries): 고급 데이터 분석을 위한 강력한 사용자 정의 쿼리를 실행합니다.

• Bitquery 통합 (Bitquery Integration): Bitquery API와 원활하게 통합되어 블록체인 데이터를 가져옵니다.

• 토큰 상호작용 (Token Interaction): 시가총액 및 주요 보유자와 같은 토큰 지표를 조회합니다.

• 거래 분석 (Trading Analysis): 트렌드 토큰을 식별하고 거래 데이터를 분석합니다.

• 사용자 정의 명령어 (Customizable Commands): 에이전트 상호작용 및 배포를 위한 사용자 정의 스크립트를 쉽게 정의할 수 있습니다.

• 크로스 플랫폼 (Cross-Platform): 최신 Node.js 환경과 완벽하게 호환됩니다.

• Node.js (>= 16.x)

• npm 또는 yarn 설치

• 유효한 Bitquery API 키

• 나머지 전제 조건은 .env.example을 참조하세요.

• 저장소 클론 (Clone the repository)

git clone https://github.com/qudeai/qudeai-framework-v.1.git
cd qudeai-framework-v.1

• 의존성 설치 (Install dependencies):

npm install

• 환경 변수 설정 (Set up environment variables): 루트 디렉터리에 .env 파일을 생성하고 다음 변수를 추가합니다:

PRIVATE_KEYPAIR=<YOUR_PRIVATE_KEYPAIR>
OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>
RPC_ENDPOINT=https://api.mainnet-beta.solana.com
...

• 프레임워크 빌드 (Build the Framework)

npm run build

• 에이전트에 쿼리 요청하기 (Ask Queries to an Agent):

npm run askqude {agentName} {yourQuestion}

• 예시:

`npm run askqude Aura

• 에이전트와 상호작용하기:

npm run interactqude {agent_name} ask "질문 내용"

• 예시:

npm run interactqude Aura ask "24시간 트렌딩 토큰"

• 트렌딩 토큰 가져오기:

npm run interactqude Aura ask "24시간 트렌딩 토큰"

• 상위 토큰 보유자 가져오기:

npm run interactqude Aura ask "상위 보유자: {mintAddress}"

• 예시:

npm run interactqude Aura ask "상위 보유자: 6LKbpcg2fQ84Ay3kKXVyo3bHUGe3s36g9EVbKYSupump"

• 시가총액 데이터 가져오기:

`npm run interactqude Aura ask "시가총액 개수:{count} 기간:"{term}"

: AI 에이전트에게 일반 질문하기. npm run deployqude

: 솔라나 블록체인에 새 에이전트 배포하기. npm run interactqude

: 쿼리를 사용하여 배포된 에이전트와 상호작용하기. npm run qude-trade

: 솔라나 블록체인에서 토큰 거래하기.

• Firebase 통합: 에이전트 관련 데이터의 안전한 저장 및 검색을 제공합니다.
• Bitquery 통합: 쿼리를 위한 실시간 및 과거 블록체인 데이터를 가져옵니다.
• 명령어 파싱(Command Parsing): 사용자 명령을 처리하여 적절한 기능으로 라우팅합니다.
• 커스터마이징 가능한 프레임워크(Customizable Framework): 특정 요구 사항에 맞게 프레임워크를 수정하거나 확장할 수 있습니다.

API를 사용하려면 다음 사항을 확인하세요:

API 접근: API는 api.qude.ai에서 공개적으로 이용 가능합니다.
API 클라이언트: 선호하는 프로그래밍 언어의 curl, Postman 또는 모든 HTTP 클라이언트 라이브러리를 사용하세요.

공식 Qude Framework 데이터베이스에서 에이전트에 대한 메타데이터를 검색하세요.

GET /api/agent/:name

curl https://api.qude.ai/api/agent/Aura

응답 예시:

{
"name": "Aura",
"description": "작업을 돕기 위해 설계된 지능형 에이전트입니다.",
...

쿼리 매개변수를 사용하여 에이전트에 메시지를 보내고 AI가 생성한 응답을 받으세요.

GET /api/agent/:name/interact?message=YourMessage

요청 예시:

curl "https://api.qude.ai/api/agent/Aura/interact?message=Hello!"

응답 예시:

{
"agent": "Aura",
"reply": "안녕하세요! 오늘 어떻게 도와드릴까요?"
...

JSON 페이로드를 사용하여 에이전트에 메시지를 보내고 AI가 생성한 응답을 받으세요.

POST /api/agent/:name/interact

요청 예시:

curl -X POST "https://api.qude.ai/api/agent/Aura/interact" \
-H "Content-Type: application/json" \
-d '{"message": "Hello, Aura"}'

응답 예시:

{
"agent": "Aura",
"reply": "안녕하세요, 어떻게 도와드릴까요?"
...

API와 프로그래밍 방식으로 상호작용하는 방법은 다음과 같습니다:

API와 프로그래밍 방식으로 상호작용하는 방법은 다음과 같습니다:

const fetch = require("node-fetch");
async function interactWithAgent(agentName, message) {
const response = await fetch(`https://api.qude.ai/api/agent/${agentName}/interact`, {
...

• 로컬 설정 불필요: 이 API는 완전히 호스팅되어 있어 사용 준비가 되어 있으며, Firebase 설정이나 서비스 계정 키가 필요하지 않습니다.
• 에이전트 메타데이터: 모든 에이전트 정보는 공식 Qude Framework 데이터베이스에서 직접 가져옵니다.

기여를 환영합니다! 시작하려면:

• 레포지토리를 포크(Fork)하세요.
• 새 브랜치(feature/my-feature)를 만드세요.
• 변경 사항을 적용하고 커밋하세요.
• 풀 리퀘스트(pull request)를 여세요.