모든 API는 에이전트를 위해 재구축될 것이다
MCP는 연결 문제를 해결합니다. 하지만 '동사 격차(verb gap)'를 해결하지는 못합니다.
완벽한 REST API를 MCP로 감싸는 데는 오후 한나절이면 충분합니다. 하지만 그렇게 해도 코딩 에이전트는 어려움을 겪을 것입니다. 잘못된 엔드포인트를 선택하거나, 하나면 충분한 상황에서 세 개의 도구를 호출할 수도 있습니다. 심지어 묻지도 않고 파괴적인 쓰기 작업을 수행할 수도 있습니다.
API가 고장 난 것이 아닙니다. 단지 잘못된 소비자를 위해 만들어졌을 뿐입니다.
지난 20년 동안 API는 인간을 위해 구축되었습니다. 인간은 의도와 멘탈 모델(mental model)을 가지고 있습니다. 에이전트는 둘 다 가지고 있지 않습니다. 에이전트는 여러분이 제공하는 인터페이스(surface)로부터 이 두 가지를 모두 재구성해야 합니다.
주요 소비자가 이토록 크게 변한다면, 인터페이스 또한 변해야 합니다.
저는 진지한 제품 인터페이스들이 단순히 기존 API를 감싸는 데 그치지 않을 것이라고 믿습니다. 에이전트 네이티브(agent-native) 작업 방식을 중심으로 API를 재구축할 것입니다.
이는 리소스 중심(resource-shaped) API에서 의도 중심(intent-shaped) 계약으로 전환함을 의미합니다. 우리는 목표, 상태, 부수 효과(side-effects), 승인, 그리고 복구(recovery)를 중심으로 재설계해야 합니다.
MCP는 연결과 전송을 위한 훌륭한 표준입니다. 하지만 명세(spec)상에서 도구는 그저 이름과 스키마를 가진 함수일 뿐입니다. 작업의 순서를 결정하거나 어떤 작업이 위험한지 판단하지 못합니다.
이것이 '동사 격차(verb gap)'를 만듭니다. API는 에이전트에게 명사와 CRUD 작업을 제공합니다. 하지만 에이전트에게 필요한 것은 의도를 담은 동사입니다.
GitHub을 보십시오. 그들은 에이전트의 추론 능력을 향상시키기 위해 도구 세트를 좁혀나가고 있습니다. 제품 API를 에이전트 도구로 1:1 매핑하는 방식이 작동하지 않는다는 것을 깨닫고 있는 것입니다.
연구에 따르면 API가 구조적으로는 유효하더라도 에이전트에게는 의미론적으로 무용지물일 수 있습니다. 에이전트 네이티브 API는 단순히 "무엇을 반환해야 하는가" 이상의 질문에 답합니다. 다음과 같은 질문들입니다:
- 목표가 무엇인가?
- 현재 어떤 상태인가?
- 부수 효과는 무엇인가?
- 승인이 필요한가?
- 어떻게 복구하는가?
가공되지 않은 쓰기 작업 대신, 다음과 같이 단계를 나누어야 합니다:
- 작업 미리보기.
- 명시적 승인 받기.
- 변경 사항 확정(Commit).
- 실패 시 롤백(Rollback).
이것은 단순히 '에이전트용 버전'이 아닙니다. 이것은 그저 더 나은 API일 뿐입니다. 개발자들 역시 미리보기, 명확한 권한 오류, 그리고 롤백 기능을 원합니다. 결국 에이전트 네이티브 디자인이 인간 중심의 디자인을 대체할 것입니다.
이 변화는 거대합니다. API, CLI, 그리고 로그에까지 영향을 미칩니다. 우리는 인간이 읽기 좋은 산문(prose)에서 기계가 파싱 가능한 상태(state)로 이동해야 합니다.
안전(Safety)은 나중에 추가하는 래퍼(wrapper)가 아닙니다. 안전은 작업 그 자체에 설계되어야 하는 속성입니다.
Source: https://dev.to/gyu07/every-api-will-be-rebuilt-for-agents-2hj4
Optional learning community: https://t.me/GyaanSetuAi