메인 콘텐츠로 건너뛰기
작업이 명확하면 에이전트가 잘못된 방향으로 가는 일이 줄고, 멈춰서 사용자에게 묻는 횟수도 줄어듭니다. 아래 팁은 대부분의 세션에 적용됩니다.

목표, 범위, 완료 기준 밝히기

무엇을 달성할지, 어디를 변경할지, 완료되었는지 어떻게 판단할지를 에이전트에게 알려 주세요. 비교해 보세요.
  • “로그인 페이지를 고쳐 줘.”
  • “Safari에서 로그인 페이지의 입력 필드가 어긋나는 문제를 고쳐 줘. 로그인 페이지 스타일만 변경하고 다른 페이지는 건드리지 마. 끝나면 기존 테스트를 실행하고 Safari를 다루는 테스트를 추가해 줘.”
두 번째 버전은 목표, 경계, 결과를 검증하는 방법을 제시합니다. 에이전트는 추측할 필요가 없으며, 언제 멈추고 작업을 사용자에게 넘겨야 하는지 알 수 있습니다.

관련 파일과 링크 제공

  • 에이전트가 올바른 코드와 환경에서 작업하도록 먼저 알맞은 프로젝트를 선택하세요.
  • 작업에 관련 파일, 폴더, 오류 메시지, 문서 링크를 명시하세요.
  • UI 문제는 스크린샷을 첨부하거나 입력창의 Take a screenshot을 사용하세요. 로그, 디자인 파일 등의 자료는 첨부 파일로 보내세요. 세션 시작하기를 참고하세요.
  • 에이전트에게 필요한 시크릿은 프로젝트의 시크릿 및 환경 변수에 미리 저장해 두세요. 그러면 에이전트가 멈춰서 요청할 필요가 없습니다. 프로젝트 및 환경 구성을 참고하세요.

큰 작업 나누기

세션은 보통 한 가지 일에 집중할 때 가장 잘 작동합니다. 큰 요청은 여러 세션으로 나누세요. 예를 들어 에이전트에게 먼저 방안을 조사하게 하고, 그 결과를 바탕으로 구현을 시작합니다.
  • 작업의 일부가 서로 독립적이면 어떤 부분을 병렬로 진행할 수 있는지 알려 주세요. 복잡한 작업에서 에이전트는 하위 에이전트를 시작하여 동시에 작업하게 하고, 모두 끝나면 결과를 자동으로 합칠 수 있습니다.
  • 다른 방법을 시도하려면 답변에서 새 세션을 Fork하세요. 원래 세션에는 영향이 없습니다.
  • 에이전트가 방향을 벗어나면 끝날 때까지 기다릴 필요가 없습니다. Steer로 즉시 바로잡거나, 이전 메시지를 편집하고 다시 실행하세요. 에이전트와 함께 작업하기를 참고하세요.

알맞은 권한 선택

새 세션은 기본적으로 Full access를 사용하므로 에이전트가 단계마다 묻지 않습니다. 클라우드 서버에서 에이전트가 스스로 완료하기를 원하는 작업에 적합합니다. 클라우드 서버의 세션은 내 컴퓨터에 전혀 접근하지 않습니다. 다음과 같은 경우에는 Ask for approval 또는 Approve for me로 전환하세요.
  • 세션이 내 컴퓨터에서 실행되며 중요한 파일이나 시스템 설정과 관련된 경우.
  • 프로젝트에 에이전트가 마음대로 사용하지 않기를 원하는 시크릿이 있는 경우. Full access에서는 에이전트가 프로젝트의 모든 시크릿을 읽을 수 있습니다.
  • 작업이 외부 서비스나 웹사이트에 연결되며, 에이전트가 실행하기 전에 확인하고 싶은 경우.

반복 작업에는 예약 작업 사용

“평일 오전 9시마다 의존성 업데이트를 확인해 줘”처럼 정기적으로 해야 하는 작업은 세션에서 에이전트에게 평소 말로 알려 주세요. 에이전트가 예약 작업 초안을 만들며, Create를 클릭해야 적용됩니다. “30분 뒤에 배포를 다시 확인해 줘”처럼 현재 세션과 관련된 후속 작업은 에이전트에게 세션 타이머를 설정하도록 요청하세요. 예약 작업은 클라우드 서버에서 실행되므로 내 컴퓨터가 꺼져 있어도 계속 실행됩니다. 예약 작업을 참고하세요.

에이전트에게 PR을 열게 하기

변경이 끝나면 세션에서 에이전트에게 커밋, 푸시, PR 생성을 요청하세요. 예: “테스트가 통과하면 수정 내용을 설명하는 제목으로 PR을 만들어 줘.” 기본 동작은 프로젝트 설정의 Ship behavior에 따릅니다. PR 생성, 브랜치 푸시, 직접 작성한 프롬프트에 따른 커밋 중 하나입니다. 연결된 원격 저장소가 없는 업로드 프로젝트는 변경 사항이 패치로 전달됩니다. 변경 사항을 검토하고 결과를 전달하는 방법은 결과 검토 및 전달을 참고하세요.