에이전트 네이티브 인프라에서는 AI 에이전트가 구조화된 인터페이스로 백엔드 리소스를 탐색하고 프로비저닝하고 점검하고 운영할 수 있습니다. 에이전트는 명시된 한도 안에서 설정을 직접 완료합니다. 정책, 결제, 영향이 큰 승인은 여전히 사람이 관리합니다.
API가 있다고 해서 인프라가 에이전트 네이티브가 되는 것은 아닙니다. 기계가 읽을 수 있는 기능 설명, 범위가 제한된 ID, 예측 가능한 오류, 안전한 재시도, 사람이 작업을 클레임하거나 승인하는 절차도 필요합니다.
인프라를 에이전트 네이티브로 만드는 요소
에이전트가 가능한 작업을 탐색할 수 있어야 합니다
인터페이스는 어떤 작업이 있고 각 매개변수가 무엇을 뜻하며 결과에 무엇이 포함되는지 호출자에게 알려 줍니다. 이 설명은 OpenAPI 문서, MCP 서버, CLI 도움말 또는 다른 구조화된 계약에 담을 수 있습니다. 형식보다 중요한 것은 에이전트가 전체 문서 사이트를 컨텍스트에 불러오지 않고 올바른 작업을 고를 수 있느냐입니다.
ID와 권한은 호출자에게 귀속되어야 합니다
각 에이전트나 에이전트 세션에는 범위가 제한된 ID를 부여해야 합니다. 그러면 백엔드는 그 호출자가 리소스를 읽거나 만들거나 비용을 쓰거나 데이터를 삭제할 수 있는지 판단합니다. 공유 관리자 키는 이 경계를 없애고 작업의 주체를 추적하기 어렵게 만듭니다. OWASP의 Excessive Agency 지침은 확장 기능, 권한, 자율성을 필요한 최소 범위로 제한하라고 권고합니다. AI 에이전트 보안 설계에서도 ID, 권한, 감사 기록이 누가 작업했는지 일치해야 합니다.
쓰기 작업을 안전하게 재시도할 수 있어야 합니다
에이전트는 시간 초과, 중단된 실행, 불완전한 도구 결과 이후 재시도합니다. 따라서 쓰기 작업에는 멱등성 키나 서버 측 중복 제거 장치가 필요합니다. Stripe의 멱등성 계약이 구체적인 예입니다. 서버는 키에 대한 첫 결과를 저장하고 같은 키로 재시도하면 그 결과를 다시 반환합니다. 에이전트 네이티브 백엔드도 두 번째 데이터베이스, 결제 또는 메시지를 만들지 않으려면 같은 속성이 필요합니다.
영향이 큰 작업에는 경계가 있어야 합니다
일회용 개발 데이터베이스 프로비저닝과 프로덕션 볼륨 삭제에 같은 승인 규칙을 적용해서는 안 됩니다. 에이전트 네이티브 시스템은 위험이 낮은 경로를 바로 제공하고, 파괴적이거나 비용이 발생하거나 범위가 비정상적으로 넓은 작업은 정책 또는 사람의 승인을 기다립니다. 프로덕션 에이전트 체크리스트는 이 구분을 구체적인 제어 수단으로 바꿉니다.
에이전트 네이티브 인프라와 API 접근 가능 인프라 비교
| 질문 | API 접근 가능 인프라 | 에이전트 네이티브 인프라 |
|---|---|---|
| 호출자는 인터페이스를 어떻게 학습하나요? | 개발자가 문서를 읽고 통합 코드를 작성합니다 | 에이전트가 구조화된 작업과 제약을 탐색합니다 |
| 자격 증명은 누구에게 귀속되나요? | 주로 개인, 팀 또는 공유 애플리케이션입니다 | 범위가 제한된 에이전트, 세션 또는 테넌트입니다 |
| 시간 초과 후에는 어떻게 되나요? | 클라이언트가 재시도의 안전성을 판단합니다 | 서버가 멱등 작업과 안정된 오류 코드를 제공합니다 |
| 위험한 작업은 어떻게 처리하나요? | API 키로 바로 실행할 수도 있습니다 | 실행 전에 정책 또는 승인 게이트를 거칩니다 |
| 사람이 언제 개입하나요? | 계정과 자격 증명을 만들기 위해 설정 전에 개입합니다 | 정의된 클레임, 결제 또는 승인 경계에서 개입합니다 |
이 차이는 운영에서 드러납니다. 일반 API를 MCP 서버로 감싸도 광범위한 자격 증명, 모호한 도구 설명, 멱등성이 없는 쓰기 작업을 노출하면 에이전트가 사용하기 어렵습니다.
지금 이 인터페이스가 중요한 이유
Vercel은 2026년 4월 코딩 에이전트가 시작한 배포가 6개월 동안 1,000% 증가했고 플랫폼 주간 배포의 30% 이상을 차지했다고 발표했습니다. 그중 Claude Code가 75%, Lovable과 v0가 6%, Cursor가 1.5%였습니다. 또한 에이전트가 배포한 프로젝트는 AI 추론 공급자를 호출할 가능성이 20배 높았습니다. 이는 보편적인 시장 추정치가 아니라 Vercel 플랫폼 측정치이지만, 대형 배포 플랫폼에서 인터페이스가 어떻게 바뀌는지 보여 줍니다.
콘솔은 사람이 모호한 실패를 해석하고 다른 탭을 열어 비밀 값을 복사한 뒤 다시 시도할 수 있다고 가정합니다. 에이전트에는 빠진 권한, 재시도의 안전성, 변경된 내용, 승인이 필요한 작업이 데이터로 표현되어야 합니다.
구체적인 프로비저닝 흐름
Cohesivity의 설정 흐름이 이 패턴을 보여 줍니다. npx @cohesivity/init은 프로젝트 컨텍스트를 만들고 .cohesivity 파일을 씁니다. 에이전트는 공급자마다 별도 가입 절차를 열지 않고 같은 프로젝트에서 리소스를 요청할 수 있습니다. 프로젝트는 72시간 동안 클레임할 수 있으므로 에이전트가 빌드할 시간을 확보하면서 소유권은 사람에게 남겨 둡니다.
데이터베이스, 인증, 스토리지, 호스팅 프로비저닝 가이드에는 요청과 생성되는 프로젝트 구조가 나와 있습니다. 이는 에이전트 네이티브 인프라의 한 구현일 뿐, 모든 플랫폼이 같은 서비스를 묶어야 한다는 뜻은 아닙니다.
에이전트 네이티브 플랫폼 평가 방법
실제 작업 하나로 전체 경로를 점검하세요.
- 에이전트가 산문으로만 된 설정 지침 없이 작업을 탐색할 수 있나요?
- 작업에 입력, 출력, 한도, 안정된 실패 사유가 선언되어 있나요?
- 자격 증명이 프로젝트와 에이전트에 필요한 작업으로 제한되나요?
- 에이전트가 결과를 중복시키지 않고 쓰기 작업을 재시도할 수 있나요?
- 파괴적이거나 비용이 발생하는 작업이 실행 전에 멈추나요?
- 사람이 에이전트가 만든 항목을 식별하고 클레임하고 취소하고 감사할 수 있나요?
첫 두 검사를 통과하지 못한 플랫폼은 에이전트가 사용하기 어렵습니다. 나머지 검사를 통과하지 못하면 호출은 쉽더라도 무인 운영은 안전하지 않을 수 있습니다.
프로비저닝 경로 하나 테스트하기
일회용 프로젝트에서 설정을 실행하고 첫 리소스를 만든 뒤 중단한 다음 같은 요청을 다시 실행하세요. 두 번째 실행이 문제없이 재개되는지, 두 시도가 하나의 작업 기록을 공유하는지, 생성된 리소스의 시작 에이전트를 추적할 수 있는지 확인하세요.
재시도에서 두 번째 리소스가 생겼다면 잘된 일입니다. 프로덕션 새벽 2시 47분이 아니라 지금 버그를 찾았습니다. 다음 명령으로 테스트를 시작하세요.
npx @cohesivity/init