첫 에이전트 디스패치

무엇을 만들게 되는가

이 튜토리얼을 마치면 다음을 갖추게 됩니다.

직접 만들고 구성한 에이전트
당신과 그 에이전트가 대화하는 스페이스
격리된 워크트리에 커밋된 작업과 에이전트의 실행 로그에 남은 행 하나를 갖춘, 완료된 실행 하나

사전 준비: 첫 워크스페이스를 완료해야 합니다. 그래야 이 워크스페이스에 저장소가 등록되어 있고 모델 프로바이더가 하나 이상 연결되어 있습니다.

1단계: 에이전트 만들기

설정 → 워크스페이스 → 에이전트로 이동합니다.
새 에이전트를 클릭합니다. “이름 없는 에이전트”라는 에이전트가 즉시 만들어지고 로스터에서 선택됩니다. 만들기 대화 상자도, 확인할 절차도 없습니다. 그 자리에서 구성하면 됩니다.
설정 탭에서 다음을 입력합니다.
- 이름: alice처럼 짧고 기억하기 쉬운 값입니다. @ 뒤에 입력하는 값입니다.
- 제목: 에이전트가 하는 일입니다. 예: “백엔드 엔지니어”
- 어댑터: Control Center (built-in). 이것을 의도적으로 고르세요. 내장 하네스만 실행 중에 조종하고 턴 경계에서 일시 중지할 수 있으며, 서버 호스트에 CLI를 설치할 필요도 없습니다.
- 모델: 연결된 프로바이더가 제공하는 목록에서 고릅니다.
- 스킬: 맞는 것이 있으면 붙입니다. 예: testing 또는 architecture
변경 사항 저장을 누릅니다.

체크포인트. 로스터의 행에 에이전트 이름과 속이 빈 상태 링이 표시됩니다.

2단계: 스페이스 시작하기

사이드바에서 스페이스 섹션을 찾아 + 버튼을 클릭합니다.
스페이스에 이름을 지정합니다.
에이전트 추가에서 방금 만든 에이전트를 선택합니다.
워크스페이스에 저장소가 있다면 이 스페이스가 작업할 저장소를 고릅니다.
만들기를 클릭합니다.

스페이스가 열립니다. Control Center는 백그라운드에서 이 대화를 위해 선택한 저장소의 기록 중 복사 워크트리를 자체 브랜치에 프로비저닝합니다. 소스 체크아웃은 결코 변경되지 않습니다.

3단계: 작업 보내기

등록한 저장소를 대상으로 구체적이고 작은 작업 하나를 입력합니다. 확인 가능한 결과가 있는 작업이 가장 좋습니다. 테스트 추가, 린트 수정, 심벌 이름 변경 등입니다.

Enter를 누릅니다. 누구도 @로 멘션할 필요가 없습니다. 스페이스에 에이전트가 하나뿐이면 평범한 메시지로 깨어납니다. 에이전트가 여러 명인 스페이스에서는 @name으로 하나를 고릅니다.

Control Center는 에이전트의 지침, 페르소나, 스킬과 스페이스의 컨텍스트로 프롬프트를 조립한 다음 실행을 디스패치합니다.

체크포인트. 컴포저의 보내기 버튼이 중지 버튼으로 바뀌고(이 대화에서 에이전트가 작업 중이라는 뜻입니다) 텍스트가 도착하기 시작합니다.

4단계: 작동하는 모습 지켜보기

대화는 실행이 일어나는 동안 그것을 그대로 렌더링합니다.

추론: 에이전트가 생각하는 내용이 인라인으로 표시됩니다.
도구 호출: 파일 읽기와 쓰기, 검색, 셸 명령이 각각의 결과와 함께 표시됩니다.
텍스트: 요약, 설명 그리고 당신에게 하는 질문입니다.

에이전트가 무언가를 물으면 대화에서 답하세요. 그러면 이어서 진행합니다.

실행 자체의 지표와 일시 중지, 재개, 중지 컨트롤을 보려면 스페이스의 일반 패널에 있는 에이전트 섹션에서 실행 중인 에이전트를 찾고 활동 열기를 선택합니다.

활동 창에서 상태 배지는 실행 중으로 표시되고, 실행이 끝나면 성공으로 바뀝니다. 멈추거나 반복되는 실행은 차단됨, 오류가 나는 실행은 실패로 표시됩니다. 에이전트 레지스트리에서 로스터 링은 첫 실행 전에는 속이 비어 있고, 에이전트가 다시 유휴 상태가 되면 채워집니다.

실행을 제약하는 요소는 다음과 같습니다. 자체 기록 중 복사 워크트리, 실행 시작 시 중개되었다가 종료 시 해지되는 자격 증명, 정리된 환경, 해당 모드가 허용하는 도구 표면, 그리고 액션 가드레일입니다. 브랜치를 푸시하거나 풀 리퀘스트를 여는 것과 같은 효과는 별도로 게이트됩니다. 가드레일을 참고하세요.

5단계: 결과 확인하기

설정 → 워크스페이스 → 에이전트를 열고 에이전트를 선택합니다.
로그 탭을 엽니다.

체크포인트. 실행 행 하나가 상태, 소요 시간, 시작 및 종료 시각 그리고 실행에 사용된 어댑터와 함께 표시됩니다.

에이전트의 변경 사항은 워크트리 안에서 대화의 브랜치에 커밋됩니다. 커밋은 에이전트가 작성자로 기록되며, 당신은 Co-Authored-By: 트레일러로 크레딧을 받습니다.

풀 리퀘스트 만들기

풀 리퀘스트를 스스로 여는 것은 없습니다. 원한다면 같은 대화에서 요청하세요.

이 브랜치를 푸시하고 기본 브랜치를 대상으로 풀 리퀘스트를 열어 주세요.

푸시(gitPush)와 PR 생성(prCreate)은 둘 다 기본적으로 승인을 요청하므로, 각 작업 전에 확인 절차를 예상해야 합니다. 프롬프트가 뜰 때 연결된 승인자가 없으면 그 작업은 허용되지 않고 거부됩니다. 가드레일은 닫힌 상태로 실패합니다.

PR은 에이전트의 이름이 아니라 그 실행이 사용한 토큰의 GitHub 아이덴티티로 열립니다. 개인 토큰을 저장했다면 그것이 곧 당신의 아이덴티티입니다. 에이전트의 작성자 표시는 커밋에 드러납니다.

직접 열 수도 있습니다. 스페이스의 소스 제어 패널에는 대화의 브랜치를 작성 화면으로 넘겨주는 풀 리퀘스트 만들기 버튼이 있고, 풀 리퀘스트 → 새 PR은 같은 화면을 빈 상태로 엽니다. 다음 튜토리얼은 여기서 이어집니다.

마무리

에이전트를 만들고 어댑터와 모델을 구성했으며, 스페이스와 작업을 부여한 다음 체크아웃은 건드리지 않고 격리된 워크트리에서 실제 실행이 끝나는 모습을 지켜봤습니다.

다음: 리뷰 워크플로를 배우려면 첫 풀 리퀘스트 리뷰를 참고하세요.

에이전트에 관한 더 자세한 내용은 에이전트 모델을, 디스패치 세부 사항은 에이전트 디스패치 수명주기를 참고하세요.