에이전트를 위한 API 설계: 인간 중심 설계가 더 이상 통하지 않는 이유
Designing APIs for Agents
API 소비의 대부분이 에이전트가 작성한 코드를 통해 이루어지는 시대가 왔다. 저자는 인간을 위해 설계된 기존 API 설계 원칙(간결한 코드, 기본값, 관대한 오류 처리)이 에이전트에게는 오히려 해가 된다고 주장한다. 에이전트는 전체 문서를 읽고 수천 줄의 코드를 생성할 수 있으므로, 명시성, 정확한 오류 메시지, 모호하지 않은 필드 이름이 중요하다. 또한 SDK보다는 가이드 문서를 제공하는 것이 에이전트의 유연성을 높인다. Freestyle의 사례와 여러 에이전트 프레임워크 및 샌드박스 API를 평가하며, 에이전트 중심 설계의 실제 적용을 보여준다.
에이전트에게 오류는 행복 경로를 찾는 최고의 표면 중 하나이지만, 정확할 때만 그렇다. 인간과 달리 에이전트는 지시를 문자 그대로 따르기 때문에, 모호하거나 잘못된 오류는 회복 대신 혼란에 빠뜨린다.