에이전트 개발과 문서 중심 개발: AI가 코드가 아닌 계약을 작성할 때
한 기사는 LLM이 코드 생성 전에 시스템 계약(OpenAPI, Proto, JSON Schema, CloudEvents, AsyncAPI)을 먼저 설계하는 에이전트 방식에 대해 설명합니다. 문서 중심 에이전트 개발이라고 하는 이 방법은 여러 프롬프트 단계를 사용하여 계약을 생성하고 검토합니다. 저자는 자동 전화 교환(PBX) 서비스 예시를 통해 이 방법을 시연하며, 생성기와 에이전트를 구분합니다.
저자 마트베이 리호타(Matvey Likhota)는 시니어 Go 개발자로서, LLM이 먼저 시스템을 설계하고 OpenAPI, Proto, JSON Schema, CloudEvents, AsyncAPI 등의 계약(contract)을 생성하며, 이후 코드는 반복 가능한 생성기와 개발자 및 에이전트가 프로젝트별 부분을 생성하는 개발 방식을 제안합니다. 그는 이를 '문서 주도 에이전트 개발(Documentation Driven Agent Development)' 또는 '사양 주도 에이전트 개발(Specification Driven Agent Development)'이라고 부릅니다. 이 글에서는 간단한 PBX(구내 교환기) 서비스 예시를 통해 이 과정을 보여줍니다. 첫 번째 프롬프트는 코드를 작성하지 않고 아키텍처상 중요한 질문들을 나열하도록 LLM에 요청합니다. 두 번째 프롬프트는 RFC 9457 오류, Idempotency-Key, If-Match/ETag, 커서 페이지네이션을 포함한 엄격한 요구 사항으로 OpenAPI 3.1 계약을 생성합니다. 그런 다음 적대적 리뷰 프롬프트가 계약의 결함을 비판합니다. 이벤트 계약의 경우 CloudEvents 1.0을 사용하며 CallStarted, CallAnswered, CallMissed 같은 이벤트 카탈로그를 포함합니다. WebSocket 계약은 AsyncAPI 3.0을 통해 설명되고, 내부 API는 proto3를 사용하는 gRPC로 설계됩니다. 이 글은 계약 설계를 코드 생성과 분리하고 리뷰 프롬프트를 사용하여 불일치를 잡아내는 것의 중요성을 강조합니다.
출처: Habr — хаб ИИ —
원문