Telegram Relay 기반 Coding Agent의 제어 계약 및 라우팅 아키텍처 설계

Coding Agents over Telegram, Part 3: The Day-to-Day Operating Contract

Jeril2026년 6월 13일7분intermediate

AI 요약

Context

모바일 환경에서 Shell 기반 Coding Agent를 제어하기 위해 Telegram을 인터페이스로 활용하는 구조임. 단순 메시지 전달을 넘어 제어 명령과 Agent 지시어를 정밀하게 구분해야 하는 라우팅 제약 사항이 존재함.

Technical Solution

Relay Agent를 도입하여 사용자 입력값을 Local Control 명령과 Agent Forwarding 메시지로 분리하는 Courier 구조 설계
AGENTS.md 기반의 Command Table을 통해 status, interrupt, restart 등 Relay 단에서 즉시 처리하는 로컬 제어 로직 구현
Agent의 질문에 대한 응답(Option replies)을 Relay가 해석하지 않고 그대로 Pane에 전달하는 Verbatim Forwarding 규칙 적용
Topic 기반의 Agent 매핑을 통해 Pane에 종속된 Relay Agent와 시스템 전체 권한을 가진 Ops Agent의 권한 경계 분리
Production/Staging 환경에 대한 Read-only 제약을 Relay 단에서 강제하여 운영 환경의 안전성 확보
Explicit Address 방식을 도입하여 Relay 제어 명령과 Agent 전달 텍스트 간의 충돌을 해결하는 Override 메커니즘 구축

실천 포인트

- 제어 인터페이스 설계 시 로컬 제어어와 타겟 시스템 전달 메시지를 명확히 구분하는 라우팅 규칙 정의 - LLM 기반 Agent 제어 시 '신뢰(Trust)'가 아닌 '검증(Verify)' 관점의 상태 확인(Status check) 루프 설계 - 권한 범위에 따라 Agent를 분리하고 Topic 기반의 격리 전략을 통해 보안 경계 설정

태그

#LLM Ops #Interface Design #Routing #Relay Agent #Control Contract

원문 읽기