결정 게이트

에이전트는 사람이 정해야 할 일을 만나면 게이트를 열고 멈춥니다. 폰, 데스크탑 앱, 웹 터미널, st gate answer 가운데 어디서든 답하면 그 답이 에이전트의 다음 메시지로 들어갑니다.

에이전트는 설계 방향이나 위험한 작업처럼 사람이 정해야 할 일을 만나면 게이트를 열고 턴을 멈춥니다. 어디에 있든 답하면 st가 그 답을 에이전트에게 입력하고, 에이전트는 일을 이어 갑니다. 코디네이터와 워커 모두 게이트를 열 수 있습니다. st 0.3.83 이상에서 됩니다.

st gate ask "이미지는 어떻게 다룰까요?" --title "이미지" \
  --option "A: 첨부로만 보관" --option "B: OCR로 글자 추출" --text
st gate list                     # 열린 게이트
st gate answer <id> 2            # 여기서 답하기(번호는 1부터)

묻기

st gate ask "<질문>"은 그 명령을 실행한 pane에서 묻습니다.

  • --option "<글>": 선택지마다 한 번씩 줍니다.
  • --title "<몇 마디>": 질문을 몇 마디로 가리키는 제목입니다.
  • --text: 선택지 대신, 또는 선택지와 함께 글로 답할 수 있게 합니다.

물은 뒤 에이전트는 턴을 멈추고, 답은 다음 메시지로 들어옵니다.

답하기

  • 폰에서. 선택지가 버튼으로 달린 푸시 알림이 옵니다.
  • 데스크탑 앱과 웹 터미널에서. 질문이 화면에 뜨고, 그 에이전트의 창에 ? 표시가 붙습니다.
  • 터미널에서. st gate answer <id> <번호>는 그 번호(1부터 셉니다)의 선택지를 고르고, st gate answer <id> "<글>"은 글로 답합니다. 번호 뒤에 글을 붙이면 둘 다 합니다.

어디서 답해도 됩니다. 답이 들어오면 st가 에이전트에게 "Decision gate … answered: B — …"를 다음 메시지로 입력하고, 에이전트는 그 답을 받아 일을 이어 갑니다.

보기와 거두기

st gate list            # 열린 게이트
st gate list --all      # 답했거나 거둔 게이트까지
st gate show <id>       # 게이트 하나와 선택지, 답
st gate cancel <id>     # 거두기

워커와 함께

  • 워커가 게이트에서 기다리고 있으면 st worker wait와 st task wait가 "워커가 묻는 중"(종료 코드 3)으로 돌아옵니다. 그래서 코디네이터는 지금 워커가 아니라 사람의 답을 기다리고 있다는 것을 압니다.
  • 열린 게이트는 st를 다시 시작해도 남아 있습니다.
  • 게이트 명령은 모두 --json을 받습니다.

폰에서 에이전트의 질문에 답하는 과정을 단계별로 보려면 따라 하기 문서 폰에서 에이전트의 질문에 답하기를 보세요.