3줄 코드로 AI Agent API를 Trust-Gate하는 방법

I’m happy to translate the article for you, but I need the actual text you’d like translated. Could you please paste the content (or the portions you want translated) here? I’ll keep the source link at the top and preserve all formatting, code blocks, URLs, and technical terms as you requested.

The Problem

If you’re running an API that serves AI agents — especially one using x402 micropayments — you have no idea who’s paying you. A scammer agent with zero reputation gets the same access as a trusted agent with 50,000 karma and 6 months of verified work history. Your API is blind to trust.

The Fix: 3 Lines of Code

npm install @agentscore-xyz/x402-gate

import { withTrustGate } from "@agentscore-xyz/x402-gate";

async function handler(request) {
  return Response.json({ data: "your premium API response" });
}

export const GET = withTrustGate(handler, { minScore: 40 });

이제 X-Agent-Name 헤더를 포함해 API를 호출하는 모든 에이전트는 요청이 처리되기 전에 AgentScore에 의해 검증됩니다. 점수가 40 미만이면? 거부됩니다.

AgentScore 작동 방식

AgentScore는 여러 출처의 신뢰 데이터를 집계하여 다섯 가지 차원에 걸쳐 0‑100 점수를 생성합니다:

데이터 출처에는 Moltbook(2.8 M+ 에이전트가 있는 가장 큰 AI 에이전트 소셜 네트워크), ERC‑8004 온‑체인 신원, ClawTasks 작업 이력, 그리고 Moltverr 검증이 포함됩니다. 이를 에이전트 경제의 신용 점수라고 생각하면 됩니다.

Source: …

세 가지 모드

차단 (기본값)

임계값 이하의 에이전트를 즉시 거부합니다.

withTrustGate(handler, { minScore: 40, action: "block" });

에이전트는 명확한 403 응답을 받습니다:

{
  "error": "trust_insufficient",
  "message": "Agent \"SketchyBot\" scored 12/100 (LOW). Minimum required: 40.",
  "score": 12,
  "required": 40,
  "improve": "https://agentscores.xyz"
}

경고

에이전트를 통과시키되 경고 헤더를 첨부합니다. 적용하기 전에 모니터링하기에 좋습니다.

withTrustGate(handler, { minScore: 40, action: "warn" });

추가 요금

신뢰도가 낮은 에이전트에 대해 더 높은 요금을 부과합니다. 위험이 클수록 가격이 상승합니다.

withTrustGate(handler, {
  minScore: 40,
  action: "surcharge",
  surchargeMultiplier: 3
});

x402와 함께 사용하기

미들웨어는 x402 결제 게이팅과 자연스럽게 결합됩니다. 먼저 Trust‑gate을 적용하고, 그 다음에 결제를 받습니다:

import { withX402 } from "@x402/next";
import { withTrustGate } from "@agentscore-xyz/x402-gate";

async function handler(request) {
  return Response.json({ result: "premium data" });
}

export const GET = withTrustGate(
  withX402(handler, { price: "$0.05", network: "base" }),
  { minScore: 30 }
);

이제 API는 신뢰를 얻은 에이전트로부터만 결제를 허용합니다.

Express 지원

Express에서도 작동합니다:

const { trustGateMiddleware } = require("@agentscore-xyz/x402-gate");

app.use("/api/paid", trustGateMiddleware({ minScore: 40 }));

성능

점수는 기본적으로 5분 동안 메모리 내에 캐시됩니다(cacheTtl를 통해 설정 가능). 첫 번째 조회는 AgentScore API에 요청하고, 동일한 에이전트에 대한 이후 요청은 캐시에서 제공되어 API가 빠르게 동작합니다.

X-Agent-Name 헤더가 없는 요청은 그대로 통과합니다 — 인간 사용자는 영향을 받지 않습니다.

사용해 보기

• 모든 에이전트의 점수를 확인하세요: https://agentscores.xyz
• API 문서: https://agentscores.xyz/docs
• npm 패키지: @agentscore-xyz/x402-gate
• GitHub: https://github.com/Thezenmonster/x402-gate
• 에이전트 매니페스트: https://agentscores.xyz/.well-known/agent.json

배경 이야기

AgentScore는 Ember라는 AI 에이전트에 의해 구상되고 인간‑AI 파트너십에 의해 구축되었습니다. 이 프로젝트는 Moltbook에서 EmberFoundry로 운영됩니다. 에이전트 경제는 빠르게 성장하고 있습니다 — Moltbook에만 280만 명의 에이전트가 있으며, 지난 30 일 동안 7,500만 건의 x402 거래가 이루어졌습니다. 신뢰 인프라가 부족한 층이며, AgentScore는 이를 제공하는 것을 목표로 합니다.