Lucid Agents 소개
What Is Lucid Agents
Lucid Agents는 TypeScript로 작성된 에이전트형 머신 커머스 SDK다. 이미 작성한 타입 지정 함수를 그대로 받아, 다른 에이전트가 그것을 사는 데 필요한 모든 것을 입힌다. 안정적인 케이퍼빌리티 키, 입력과 출력 스키마, 가격, 결제 승인, 재시도, 그리고 탐색 카드다. 결과물은 평범한 HTTP 서비스인데, 돈을 청구하고 스스로를 기계에게 설명한다는 점이 다르다.
이 프로젝트는 같은 이름의 에이전트 프레임워크를 만든 Daydreams의 것이며, daydreamsai/lucid-agents 저장소에 MIT 라이선스로 있다. 스택의 중간 계층에 자리한다. 아래에는 지갑, 퍼실리테이터, 네트워크, 그리고 결제 프로토콜 자체가 있다. 위에는 비즈니스 로직이 있다. Lucid는 그 아래 계층을 대체하지 않고 새 결제 프로토콜도 만들지 않는다. x402나 MPP의 기존 결제 증명을 검증된 애플리케이션 작업과 하나의 타입 지정 결과에 연결한다.
이 좁은 범위가 한계도 정한다. 서비스가 여러 타입 지정 케이퍼빌리티를 필요로 하거나 프레임워크를 넘나드는 공통 동작이 필요할 때 Lucid가 값을 한다. 유료 라우트가 하나뿐이라면 원래 결제 미들웨어가 더 가벼운 의존성이며, 공식 문서도 그렇게 밝힌다. 완전한 A2A v1 전송이나 x402 Bazaar 등록 같은 프로토콜 일부는 현재 부분 지원이거나 아예 없다.
Getting Started
- Bun 1.3 이상을 설치하고 CLI로 프로젝트를 만든다. 예를 들어
bunx @lucid-agents/cli my-agent --adapter=hono --template=blank다. - 폴더 안에서
bun install과bun run dev를 실행해 생성된 서비스를 3000번 포트에서 띄운다. - 예제 echo 엔트리포인트를 자신의 타입 지정 함수로 바꾸고, Zod 같은 스키마 라이브러리로 입력, 출력, 핸들러를 정의한다.
- 결제 확장을 추가하고 엔트리포인트에 가격을 붙여 유료 라우트로 만든다.
- 구매자 지갑과 퍼실리테이터를 서비스에 연결하고 invoke 라우트를 호출한 뒤 응답의 정산 헤더를 읽는다.
제품 정보
Lucid Agents의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 백엔드와 TypeScript 개발자
- AI 케이퍼빌리티를 팔려는 팀
- 에이전트 프레임워크 개발자
- 에이전트 결제를 실험하는 팀
작업
- 함수를 에이전트용 유료 API로 바꾸기
- 다른 에이전트에게 호출당 과금하기
- 유료 작업을 백그라운드 작업으로 돌리기
- 탐색 가능한 에이전트 등록하기
- 유료 호출에 안전한 재시도 붙이기
활용 상황
- 마감에 맞춰 유료 텍스트나 데이터 서비스 출시하기
- 하나의 런타임으로 여러 케이퍼빌리티 내보내기
- 스트리밍이나 오래 걸리는 에이전트 작업 다루기
- 프로덕션으로 넘어가기
주요 기능
유일한 근거로서의 타입 지정 엔트리포인트
Lucid의 모든 것은 정의 하나에서 시작한다. 키, 설명, 입력과 출력 스키마, 핸들러, 선택적 가격으로 엔트리포인트를 서술한다. 이 계약 하나가 검증, 호출, 스트리밍, 작업, 탐색, 그리고 각 프레임워크 어댑터를 먹여 살리므로 라우트의 동작과 대외 설명이 어긋나지 않는다. 개발자 입장에서는 다섯 군데가 아니라 한 군데만 고치면 된다는 뜻이다.
프로토콜에 종속되지 않은 결제 레일
결제 패키지는 한 가지 이상의 프로토콜을 말한다. EVM과 Solana 판매자 검증을 포함한 x402 챌린지, EVM 구매, Sign-In-With-X, 정책 통제를 처리하고, Machine Payments Protocol도 Payment-Auth 챌린지와 Tempo, Stripe, 자체 자격 증명으로 지원한다. 지갑과 퍼실리테이터는 밖에 남아 있어 보관과 정산 선택이 SDK에 묶이지 않고 자신의 손에 남는다.
프레임워크 어댑터
Lucid는 하나의 HTTP 계약을 팀이 이미 쓰는 프레임워크에 묶는다. Hono, Express, TanStack Start용 전용 어댑터가 있고, CLI는 독립 패키지가 아니라 Next.js App Router 모듈도 생성한다. 어댑터가 같은 라우트 계획을 묶으므로 서비스는 작은 스크립트에서 Hono 뒤에 있든, 더 큰 Express나 Next.js 애플리케이션 안에 있든 같은 동작을 보인다.
탐색, 아이덴티티, 작업
유료 서비스는 구매자가 찾고 신뢰할 수 있어야 쓸모가 있다. 아이덴티티 패키지가 ERC-8004 등록과 조회, 신뢰 메타데이터를 맡고, a2a 패키지가 Agent Card 형태의 에이전트 탐색, 클라이언트 호출, 토큰으로 보호되는 비동기 작업을 만들어 낸다. 에이전트 간 결제를 위해 AP2 역할 메타데이터도 붙일 수 있다. 이 계층이 다른 기계로 하여금 서비스를 호출할지 결정하게 만든다.
정책, 멱등성, 분석
돈이 걸리면 애플리케이션 통제가 프로토콜만큼 중요하다. Lucid는 결제 코어 위에 수취인 한도, 예산, 요청 한도, 안전한 유료 재시도를 더하고, 멱등성이 결제와 이행을 하나의 트랜잭션에 붙든다. 분석 패키지는 묶인 결제를 JSON과 CSV로 내보내 서비스가 얼마를 벌었고 어디서 실패했는지 볼 수 있는 정도로 요약한다.
CLI, 예제, 릴리스 채널
CLI는 템플릿에서 Hono, Express, TanStack, Next.js 프로젝트를 생성하고, 보호 장치가 있는 배포 패키지가 프로바이더 배포를 맡는다. 공개 npm 패키지가 Stable 채널을 이루고, 저장소는 앞서나갈 수 있는 Next 채널을 유지한다. 문서는 모든 패키지를 한 채널에 두라고 강하게 권한다. Stable과 Next를 섞는 것이 흔한 고장 원인이기 때문이다.
장단점
장점
- 타입 지정 계약 하나가 라우트, 결제, 탐색, 어댑터를 움직여 과금벽 주변에서 흔히 생기는 중복 코드를 줄인다.
- 설계부터 프로토콜에 종속되지 않고, x402와 MPP를 지원하며 주요 네 가지 프레임워크용 어댑터를 갖춘다.
- 결제 승인, 정책, 멱등성, 분석이 함께 제공되어 유료 서비스에 필요한 통제를 개발자에게 떠넘기지 않는다.
- MIT 라이선스 오픈 소스라 런타임을 읽고 포크하고 직접 호스팅할 수 있다.
- 멱등 키로 각 결제를 단일 이행에 묶어 이중 청구를 막는다.
단점
- 대상은 개발자이고 최종 사용자가 아니어서 TypeScript와 Bun 또는 Node 환경이 없으면 직접 시험할 수 없다.
- 프로토콜 커버리지가 불완전하다. 완전한 A2A v1 전송과 x402 Bazaar에 대해 문서도 명시하므로 상호운용성 약속이 제한된다.
- 외부 지갑, 퍼실리테이터, 네트워크가 필요해 첫 유료 호출에는 추가 설정과 테스트넷 자금이 든다.
- Stable과 Next 채널을 섞으면 빌드가 깨질 수 있어, 많은 팀이 익숙하지 않은 버전 규율을 요구한다.
- 호스팅 플랫폼도 있지만 그 API 기본 URL과 조건은 오픈 소스 문서가 아니라 제품 소유자에게서 나온다.
자주 묻는 질문
Lucid Agents는 Daydreams가 만든 머신 커머스용 TypeScript 런타임이다. 타입 지정 함수를 다른 에이전트와 애플리케이션이 탐색하고 호출하고 결제하고 스트리밍하고 작업으로 실행할 수 있는 서비스로 바꾼다. 코드는 daydreamsai/lucid-agents 저장소에 있다.
관련 콘텐츠
Lucid Agents와 관련된 도구, 스킬, 아티클을 살펴보세요.
Lucid Agents 대안
Emailwritr
Emailwritr · 글쓰기 · 마케팅Emailwritr는 이미 보유한 리스트에서 더 많은 매출을 끌어내려는 제휴 마케터, 강의 제작자, 온라인 사업자를 위해 만든 AI 이메일 카피라이팅 도구다. 빈 페이지나 일반적인 챗봇 프롬프트 대신, 이 AI 이메일 작성 도구는 잘 알려진 다이렉트 리스폰스 카피라이터를 본뜬 프레임워크로 웰컴 시퀀스, 런칭 캠페인, 장바구니 이탈 이메일, 프로모 시리즈를 생성한다. 오토리스폰더를 연결하고 제안에 관한 몇 가지 질문에 답하면 나머지 문구를 대신 써 준다.
Prosp
Prosp · 글쓰기 · 음성 및 언어 · 마케팅Prosp는 에이전시와 영업팀을 위해 만들어진 AI LinkedIn 아웃리치 도구다. 잠재 고객마다 자신의 목소리로 메시지와 음성 메시지를 작성해, 상대가 실제로 답장하도록 만든다. 계정을 연결하고 리드를 찾고, AI가 개인화된 메시지를 대량으로 작성해 보내도록 맡긴다. 전부 하나의 받은편지함에서 처리한다. 대량으로 아웃바운드를 돌리는 사람을 위해 만들어졌다. 그게 이 제품의 전부다. 그래도 모든 접점은 인간처럼 느껴져야 한다.
On Model
On Model · 이미지 · 마케팅On Model은 옷을 가상 모델에 입히는 AI 패션 모델 도구로, 온라인 스토어가 촬영을 예약하지 않고도 모델 착용 제품 사진을 얻을 수 있게 한다. Shopify 앱으로 작동하며, 기존 이미지의 모델을 교체하고 배경을 바꾸며, 잘린 사진이나 머리 없는 사진에 얼굴을 생성할 수 있다. 목표는 단순하다. 제품 사진을 고객에게 맞추고, 같은 공급업체 이미지를 쓰는 경쟁자와 차별화하는 것이다.