Managed Agent Runs: 잠자는 동안 아키텍처를 작업하는 자율 에이전트

2주 전, 우리는 적합성 가드레일과 함께 Agent Hub를 출시했습니다 — AI 에이전트가 할 수 있는 것과 할 수 없는 것을 정의하는 규칙입니다. 그것은 방어적 레이어였습니다. 오늘 우리는 공격적 레이어를 추가합니다.

Managed Agent Runs를 사용하면 Archyl에서 직접 자율 AI 에이전트를 배포할 수 있습니다. 작업을 지시하고, 도구에 연결하고, 스케줄을 설정하고, 작업을 맡기세요. 에이전트는 저장소를 클론하고, 아키텍처를 읽고, 외부 서비스를 호출하고, 수행한 모든 작업 — 모든 도구 호출, 모든 결정, 모든 소비된 토큰 — 을 보고합니다.

이것은 "아키텍처와 채팅하기"가 아닙니다. 코드베이스에서 자율적으로 실제 작업을 수행하는 에이전트입니다.

Managed Runs가 필요한 이유

우리가 반복적으로 관찰한 패턴은 이러했습니다: 팀들이 적합성 규칙을 설정하고, CLAUDE.md 파일을 생성한 다음, 터미널에서 수동으로 에이전트를 실행하는 것이었습니다. 컨텍스트를 복사하고, Claude Code에 붙여넣고, 작업을 실행하고, 출력을 확인합니다. 매번 똑같이.

빠진 조각은 자동화였습니다. 정기적인 작업을 수행하는 에이전트를 지켜볼 필요가 없어야 합니다. 매주 월요일 아침마다 오래된 의존성을 확인한다고요? 그건 스케줄이어야 합니다. 병합할 때마다 아키텍처 규칙에 따라 열린 PR을 검토한다고요? 그건 자동이어야 합니다. 주간 아키텍처 드리프트 보고서를 생성한다고요? 설정하고 잊어버리면 됩니다.

Managed Runs가 이 루프를 완성합니다. 작업을 정의하고, 스케줄을 선택하면, Archyl이 나머지를 처리합니다 — 클론, 컨텍스트 주입, 실행, 모니터링까지.

실행의 구조

모든 Managed Run은 동일한 라이프사이클을 따릅니다:

클론 — 에이전트가 프로젝트의 저장소를 격리된 워크스페이스에 클론합니다. 이전 실행의 오염 없이 깨끗한 복사본입니다.
컨텍스트 주입 — 에이전트가 단 한 줄의 코드를 작성하기 전에, 전체 아키텍처 컨텍스트를 수신합니다: C4 모델, ADR, 적합성 규칙, 기술 스택, API 계약. 가드레일을 구동하는 동일한 get_agent_context 데이터가 자동으로 주입됩니다.
실행 — 에이전트가 작업을 수행합니다. 파일을 읽고, 코드를 작성하고, 외부 도구를 호출하고, 결정을 내릴 수 있습니다. 각 동작은 실시간 피드에 이벤트로 기록됩니다.
보고 — 실행이 완료되거나 반복 제한에 도달하면, 전체 추적 정보를 받습니다: 입력과 출력이 포함된 모든 도구 호출, 상태 배지, 토큰 수, 경과 시간.

실행 상세 페이지는 모든 것을 보여줍니다. 도구 호출은 구문 강조된 JSON이 포함된 확장 가능한 카드입니다. 각 카드는 도구가 어떤 커넥터에서 왔는지 보여줍니다 — GitHub API 호출은 "github", 아키텍처 쿼리는 "archyl", 이슈 추적은 "linear". 에이전트가 무엇을 했고 왜 했는지 정확히 추적할 수 있습니다.

커넥터: 모든 MCP 서비스 연결

여기서부터 흥미로워집니다. Managed Runs는 Archyl과만 통신하지 않습니다. MCP(Model Context Protocol)를 지원하는 모든 것과 통신할 수 있습니다.

커넥터를 사용하면 에이전트 실행에 외부 서비스를 연결할 수 있습니다. 기본적으로 다음을 지원합니다:

GitHub — PR 읽기, CI 상태 확인, 이슈 목록, 코드 리뷰
GitLab — GitLab 호스팅 프로젝트에 대한 동일한 기능
Linear — 이슈 읽기 및 업데이트, 스프린트 진행 상황 확인
Slack — 메시지 전송, 채널 읽기, 팀 알림
모든 MCP 서버 — MCP 도구를 노출하는 서버라면 연결 가능

커넥터 설정은 30초면 됩니다. 이름을 지정하고, 서버 URL을 붙여넣고, 필요한 경우 인증 헤더를 추가하면 Archyl이 서버를 탐색하여 사용 가능한 도구를 발견합니다. 저장하기 전에 커넥터가 노출하는 모든 도구를 확인할 수 있습니다.

실행이나 스케줄을 생성할 때 연결할 커넥터를 선택합니다. 에이전트는 연결된 모든 커넥터의 모든 도구에 접근할 수 있으며, 커넥터 이름으로 네임스페이스가 구분됩니다. GitHub 도구는 github__list_pull_requests로 표시됩니다. Linear 도구는 linear__get_issue로 표시됩니다. 충돌도 모호함도 없습니다.

이 네임스페이스 구분이 중요합니다. 실행의 이벤트 피드를 볼 때, 모든 도구 호출은 출처를 보여줍니다. 에이전트가 아키텍처 모델을 쿼리하고 있었는지, GitHub PR을 읽고 있었는지, Slack에 게시하고 있었는지 즉시 알 수 있습니다. 에이전트가 어디서 무엇을 건드렸는지 완전한 가시성을 제공합니다.

스케줄: Cron 기반 자동화

일부 작업은 사람이 "실행" 버튼을 누를 때까지 기다릴 필요가 없습니다. 스케줄을 사용하면 표준 cron 표현식으로 반복 에이전트 실행을 정의할 수 있습니다.

팀들이 이미 활용하고 있는 몇 가지 예시:

주간 아키텍처 리뷰 — 매주 월요일 오전 9시, 에이전트가 코드베이스에서 아키텍처 드리프트를 확인합니다. 실제 코드 구조를 C4 모델과 비교하고, 문서화되지 않은 새로운 의존성을 표시하고, 의도된 범위를 넘어선 컴포넌트를 식별합니다.

PR 적합성 검사 — main에 병합할 때마다, 에이전트가 적합성 규칙에 따라 차이점을 검토합니다. CI를 통과한 패턴을 잡아냅니다 — 구문 오류가 아니라, 전체 시스템의 맥락에서만 의미가 있는 아키텍처 위반입니다.

의존성 감사 — 매주 수요일, 에이전트가 의존성 트리에서 알려진 취약점, 더 이상 사용되지 않는 패키지, 서비스 간 버전 불일치를 스캔합니다. 심각도 등급과 권장 업데이트가 포함된 요약을 생성합니다.

문서 동기화 — 매주 금요일 오후, 에이전트가 현재 코드베이스를 프로젝트 문서와 비교합니다. 누락된 엔드포인트, 오래된 설명, 문서가 없는 새 서비스 — 모두 표시합니다.

각 스케줄은 cron 표현식, 다음 실행 시간, 마지막 실행 시간, 활성/일시 정지 상태를 보여줍니다. 삭제하지 않고 스케줄을 일시 정지하거나, 정상 주기 외에 수동으로 트리거하거나, 언제든지 작업 텍스트와 타이밍을 편집할 수 있습니다.

실행 상세 페이지

에이전트가 자율적으로 작업할 때 가시성이 전부이기 때문에, 모니터링 경험에 많은 시간을 투자했습니다.

실행 상세 페이지는 다음을 제공합니다:

한눈에 보는 상태 — 실행 중, 완료, 실패 또는 취소. 색상으로 구분된 배지가 즉시 표시됩니다.
토큰 사용량 — 입력 및 출력 토큰으로 실행당 비용을 추적할 수 있습니다.
경과 시간 — 에이전트가 작업한 시간이 실행 중 실시간으로 업데이트됩니다.
실행 ID — 추적성과 디버깅을 위한 식별자입니다.
실시간 이벤트 피드 — 에이전트가 수행하는 모든 동작이 확장 가능한 카드로 표시됩니다. 도구 호출은 커넥터 출처, 도구 이름, 입력 파라미터, 출력을 보여줍니다. 메시지는 에이전트의 추론을 보여줍니다. 오류는 강조 표시됩니다.

피드는 빠른 스캔을 위해 설계되었습니다. 접힌 행은 이벤트 유형과 한 줄 요약을 보여줍니다. 마우스를 올리면 커넥터 배지가 표시되고 확장하면 전체 세부 정보를 볼 수 있습니다. 문제가 발생하면 로그를 뒤질 필요 없이, 정확히 무슨 일이 있었는지 구조화된 타임라인을 스크롤하면 됩니다.

기본적으로 아키텍처 인식

모든 Managed Run은 Archyl 프로젝트의 MCP 서버에 자동으로 접근합니다. 이는 에이전트가 다음을 수행할 수 있음을 의미합니다:

C4 모델을 쿼리하여 시스템 경계를 이해
ADR을 읽어 과거 결정을 이해
적합성 규칙을 확인하여 어떤 패턴을 따라야 하는지 파악
API 계약을 탐색하여 서비스 인터페이스를 이해
기술 할당을 조회하여 적절한 도구를 선택

이것은 선택적 통합이 아닙니다. 이것이 기반입니다. 에이전트는 제로에서 시작하지 않습니다 — 아키텍처에서 시작합니다. 새 서비스를 생성해야 할 때, 어떤 컨테이너에 속하는지 압니다. 코드를 작성할 때, 어떤 패턴이 적용되는지 압니다. 의존성을 추가할 때, 어떤 기술이 승인되었는지 압니다.

외부 커넥터와 결합하면, 아키텍처를 인식하면서 운영적으로도 유능한 에이전트가 만들어집니다. 에이전트가 시스템을 알고 동시에 도구와 상호작용할 수 있습니다.

시작하기

Managed Agent Runs는 현재 Business 및 Scale 플랜의 Agent Hub에서 사용할 수 있습니다.

커넥터 생성 — Agent Hub > Connectors로 이동합니다. GitHub, Linear 또는 MCP 호환 서비스를 추가합니다.
실행 시작 — Runs > New Run으로 이동합니다. 작업을 작성하고, 커넥터를 연결하고, 실행합니다.
스케줄 설정 — Schedules > New Schedule로 이동합니다. cron 표현식을 선택하고, 커넥터를 연결하고, 실행되도록 합니다.

에이전트는 준비되었습니다. 아키텍처가 컨텍스트이고, 도구가 커넥터입니다. 이제 작업을 시작하세요.