본문으로 건너뛰기

7부: 프로덕션 에이전트 배포

지금까지는 에이전트를 활용하여 소프트웨어를 개발하는 방법에 대해 다루었습니다. 이번 부분은 여러분이 만들고 있는 것 자체가 에이전트인 경우를 다룹니다 — 고객 지원 봇, 리서치 어시스턴트, 내부 모니터링 도구 등이 그 예입니다. 이것들은 한 번만 실행하는 스크립트가 아니라 실제 사용자를 대상으로 서비스하는 제품이며, 그에 걸맞은 기반이 필요합니다.

먼저 실제로 무엇을 만들고 있는지 결정하십시오​

시작하기 전에 가장 유용한 질문 하나:

  • 스크립트입니까? 일회성 자동화, 개인 도구, 프로토타입. 에이전트가 곧 목적물입니다. 터미널에서 사용하는 일반 코딩 에이전트로 충분합니다.
  • 제품입니까? 실제 사용자가 의존하는 무언가. 에이전트가 이제 제품이며, 그 아래에 기반 구조가 필요합니다: 자체적인 도구, 메모리, 평가, 배포 인프라.

이 둘을 혼동하면 프로토타입이 실수로 배포되는 상황이 발생합니다. 무엇을 만들고 있는지 코드를 작성하기 전에 명확히 하십시오.

프로덕션 에이전트에는 스크립트에 없는 것이 필요합니다​

실제 사용자가 에이전트에 의존하는 순간, 네 가지가 선택 사항이 아니게 됩니다:

  • 영속적 메모리 — 세션 간에 유지되어 에이전트가 매번 처음부터 시작하지 않도록 합니다.
  • 범위 제한 권한 — 모든 도구와 데이터 소스에 적용되어 에이전트가 접근해야 할 범위만 접근할 수 있도록 합니다.
  • 평가 커버리지 — CI에서 실행되어 배포 전에 회귀를 잡아냅니다 (이는 에이전트 자체에 적용된 3부의 내용입니다).
  • 관찰 가능성 — 에이전트가 실제로 한 일을 추적하여 프로덕션 동작을 감사할 수 있게 합니다 (이는 에이전트 자체에 적용된 5부의 내용입니다).

일회성 스크립트라면 이 모든 것이 노력 대비 가치가 없습니다. 제품이라면, 출시 후에 구축하는 것은 유지 불가능하고 신뢰할 수 없는 시스템으로 이어지는 길입니다.

프로토타입에서 프로덕션까지 하나의 워크플로를 유지하십시오​

이를 실용적으로 만드는 전환점: 프로토타입을 만드는 데 사용하던 동일한 터미널 기반 워크플로가 이제 배포된 제품까지 도달합니다. 프로덕션으로 가기 위해 별도의 스택을 새로 배울 필요가 없습니다. 원하는 것을 기술하면 스킬 번들(2부에서 다룬 종류)이 기존 코딩 에이전트에 전체 생명 주기를 제공합니다 — 스캐폴드, 작성, 평가, 배포, 관찰 가능성 연결 — 새로운 SDK 없이 가능합니다.

처음부터 끝까지의 루프는 대화처럼 보입니다:

# one-time setup of the skills bundle, then, in your coding agent:
> Build a support agent that answers questions from our docs.
> Evaluate it against the FAQ dataset.
> Deploy it to the runtime.

그 뒤에서 에이전트는 템플릿으로 프로젝트를 스캐폴드하고, 코드를 작성하고, 평가 세트를 생성하고, 실행하고, 배포하고, 결과를 보고합니다. 직접 제어하기를 선호하는 분들을 위해 동일한 단계가 일반 CLI 명령으로도 제공됩니다. 결과적으로: 어제 노트북에서 실행되던 프로토타입이 오늘 사용자를 대상으로 서비스하는 프로덕션 에이전트가 됩니다 — 재작성 없이.

멀티 에이전트로 나아가기​

에이전트 하나로 충분하지 않을 때, 조율은 세 가지 메커니즘을 통해 이루어지며 각기 다른 규모에서 사용됩니다:

  • 공유 세션 상태 — 에이전트들이 동일한 컨텍스트를 볼 필요가 있는 단순한 경우.
  • MCP (Model Context Protocol) — 에이전트가 도구와 외부 서비스에 접근하는 표준 방식.
  • A2A (Agent2Agent) — 하나의 에이전트가 다른 에이전트에게 작업을 위임하는 경우.

이것들은 적합한 패턴으로 조합됩니다: 플래너가 전문 에이전트에게 하위 작업을 넘기거나, 병렬 작업자들이 작업의 서로 다른 부분을 처리하거나, 리뷰어 에이전트가 빌더 에이전트를 검토합니다. 병목은 구현 작성에서 각 에이전트가 무엇을 해야 하는지 명세하고 실제로 했는지 검증하는 것으로 이동합니다 — 이 가이드 전체의 주제와 동일하되 한 단계 위에 있는 것입니다.

나만의 워크플로를 설정하십시오​

  • 다음 에이전트를 위해 한 문장을 적으십시오: "이것은 스크립트다" 또는 "이것은 제품이다." 그 결정이 얼마나 많은 기반 구조를 구축할지 결정하게 하십시오.
  • 제품이라면 네 가지 필수 요소를 추가하십시오: 영속적 메모리, 범위 제한 권한, CI 평가, 실행 추적.
  • 스킬 번들을 사용하여 빌드 → 평가 → 배포 → 관찰이 하나의 워크플로에 머물도록 하십시오.
  • 여러 에이전트가 필요하다면 공유 상태로 시작하십시오; MCP와 A2A는 조율이 실제로 필요할 때만 활용하십시오.