08 — 사용법
설치부터 지시까지
키가 없어도 전부 돕니다. Python 3.13 이상이 필요합니다.
01
설치
공통 라이브러리와 에이전트 셋, 콘솔까지 다섯을 한 번에 설치합니다.
python deploy/setup_dev.py
02
에이전트 기동
띄우기 전에 무엇이 뜨는지만 보시려면 --list 를 붙입니다.
python deploy/run_all.py
────────────────────────────────────────────────
reviewer 127.0.0.1:8003 수신 ['worker'] (끝단)
worker 127.0.0.1:8002 수신 ['manager'] → reviewer
manager 127.0.0.1:8001 수신 ['console'] → worker
────────────────────────────────────────────────
03
CLI 로 지시
지시 없이 실행하면 대화 모드로 들어갑니다.
python -m console.cli "로그인 검증 함수를 만들어줘"
04
웹 화면
http://127.0.0.1:8080 을 브라우저로 엽니다.
python -m console.web_server
실제 출력
A2A 콘솔 · 관리자 manager · http://127.0.0.1:8001
[사람] 로그인 검증 함수를 만들어줘
[reviewer] 반려 · [docstring] docstring 이 없는 함수: authenticate, test_authenticate
[reviewer] 통과
[worker] 결과 제출
[manager] 결과 제출
────────────────────────────────────────────────
def authenticate(user_id, password):
"""로그인 검증 함수를 만들어줘"""
if user_id is None:
raise ValueError("user_id 가 필요하다")
return True
def test_authenticate():
"""authenticate 이 참을 돌려주는지 확인한다."""
assert authenticate("user_id", "password") is True
────────────────────────────────────────────────
재작업 1회 · 검증 2회 · 동작방식 rule · 호출 3회 · 비용 0원
첫 산출물이 docstring 누락으로 반려되고 두 번째에 통과했습니다. 꾸민 것이 아니라
기본 동작방식이 첫 시도에 일부러 docstring 을 빼도록 되어 있습니다 —
루프가 도는 것을 매번 보실 수 있게 하기 위해서입니다.
지난 실행을 꺼내 쓰기
CLI 와 화면이 같은 기록을 봅니다. 화면에서 돌린 것을 CLI 로 이어갈 수 있습니다.
python -m console.cli --list 지난 실행 목록
python -m console.cli --show <번호> 하나 자세히
python -m console.cli --resume <번호> "…" 이어서 지시 — 그때 산출물이 실려 간다
python -m console.cli --agents 에이전트 생사 확인
설정 한 장에 들어가는 것
에이전트마다 자기 설정 하나만 읽습니다. 전체 배치를 아는 파일은 없습니다.
# 관리자 — 검증자 주소가 어디에도 없다
self: { name: manager, bind: 127.0.0.1, port: 8001 }
accepts_from: [console] # 이 발신자만 받는다
delegates:
- { name: worker, url: "http://127.0.0.1:8002",
delivery: polling } # 이 상대에게만 적용된다
limits: { max_depth: 5, max_llm_calls: 4 }
auth: { token: "" } # 비면 토큰 검사 안 함
store: { dir: ./_data, enabled: true }
이름·포트·바인드가 전부 설정에 있습니다. 코드에 이름 상수가 없어서,
같은 실무자를 둘 띄우려면 설정을 복사해 이름과 포트만 바꿉니다 — 코드 복제가 아닙니다.
