메인 콘텐츠로 건너뛰기
입력 필요는 세션 실행 중에 에이전트가 일시 중지하고 사용자의 결정이나 정보 제공을 기다리는 상태입니다. 예를 들어 명령 승인, 질문 답변, 시크릿 제공이 필요하거나, 로그인처럼 에이전트가 대신 할 수 없는 작업을 사용자가 완료해야 하는 경우입니다. 응답하면 세션이 자동으로 계속됩니다.

적용 범위

요청이 표시되는 위치

  • 개입 카드: 세션 페이지의 입력창 바로 위에 있는 카드입니다. 모든 요청이 여기에 표시됩니다. 여러 개가 있으면 같은 카드 안에서 넘겨 가며 확인합니다.
  • 타임라인: 명령 승인을 제외한 요청은 발생한 위치에 Waiting for your reply · Respond 와 같은 한 줄을 남깁니다. Respond 를 클릭하면 개입 카드가 펼쳐집니다. 요청을 처리한 후에는 타임라인에 기록 줄이 남습니다.
  • 이메일 전송 전 확인(Gmail) 은 예외로, 확인 카드가 타임라인에 바로 표시됩니다. 아래를 참고하세요.

개입 카드의 공통 작업

  • 답변이 전달되지 않으면 Reply timed out. You can retry. 가 표시됩니다. 다른 기기에서 이미 처리된 항목이면 Handled on another device 가 표시됩니다.
  • Full access 로 전환해도 이미 대기 중인 요청은 자동으로 승인되지 않습니다. 하나씩 직접 처리해야 합니다.

키보드

포커스가 입력창에 있지 않을 때 현재 항목을 키보드로 바로 처리할 수 있습니다.

요청 유형

명령 승인

권한이 Ask for approval 이거나 Approve for me 가 안전하지 않을 수 있는 작업을 감지하면, 에이전트는 실행 전에 승인을 요청합니다. 카드에는 실행할 명령이 표시됩니다.
  • Allow: 이번 한 번만 승인합니다.
  • Allow for this task: 이번 한 번을 승인하고, 이 세션에서 이후의 비슷한 작업은 자동으로 허용됩니다.
  • Deny: 명령이 실행되지 않으며, 에이전트는 다른 방법으로 계속 진행하려고 합니다.
  • Something else…: 요청을 입력하고 Enter 를 누릅니다. 명령을 거부하고 에이전트에게 요청을 전달합니다.
권한 선택은 새 세션을 참고하세요.

질문과 선택에 답하기

에이전트는 정보가 부족하면 직접 질문합니다. 방안을 골라야 할 때는 선택지를 제시합니다.
  • 카드 하나에 질문이 여러 개 있을 수 있습니다. 한 번에 하나씩 표시되며, Previous 를 클릭해 다시 확인할 수 있습니다.
  • 선택해도 자동으로 전송되지 않습니다. 각 질문에서 Continue 를 클릭하고, 마지막 질문에서 Submit 을 클릭합니다.
  • 질문이 허용하는 경우 옵션 끝에 Other… 가 있어 직접 답변을 작성할 수 있습니다.
  • 기밀 유지가 필요한 질문은 비밀번호 입력란을 사용하며, 제출 후 답변은 페이지에 남지 않습니다.

시크릿 추가

에이전트에게 시크릿(예: SENTRY_AUTH_TOKEN)이 없으면 제공을 요청합니다. 카드에는 이유, 시크릿 이름, 입력란이 표시되며 Used only for this task. Its value won’t appear in the chat. 라는 안내가 있습니다. 카드를 접거나 다른 요청으로 전환하면 다시 입력해야 합니다. 오래 사용할 시크릿은 설정의 시크릿 페이지에 저장하세요.

직접 처리 필요

로그인이나 2단계 인증 코드 입력처럼 에이전트가 대신 완료할 수 없는 단계가 있습니다. 카드에 해야 할 일이 안내됩니다.
  1. 클라우드 서버의 세션: View cloud server 또는 Take control 을 클릭해 클라우드 서버 화면을 엽니다. 기기에서 실행되는 세션: 해당 컴퓨터에서 직접 조작합니다.
  2. 작업을 완료합니다. 클라우드 서버를 조작하는 동안 에이전트는 일시 중지되지 않습니다. 클라우드 서버 데스크톱을 참고하세요.
  3. 카드로 돌아와 Done 을 클릭합니다. 에이전트가 계속 진행합니다.
해당 단계가 필요 없으면 Not now 를 클릭합니다. 에이전트는 다른 방법으로 계속 진행하려고 합니다.

민감한 위치 접근 요청

세션이 내 기기에서 실행되고 해당 기기의 Sensitive locations 가 매번 묻도록 설정되어 있으면, 에이전트는 이런 위치(예: SSH, 키체인, 시스템 구성)에 접근하기 전에 사용자에게 묻습니다.
  • 카드에는 이유와 경로, 만료 카운트다운이 표시됩니다.
  • Allow once 는 이번 접근만 허용하며 기기의 권한 설정은 바뀌지 않습니다. 접근을 수행하는 기기에서 허용하면 시스템이 한 번 더 확인을 요청합니다.
  • 응답하기 전에 만료되면 거부로 처리되며, 타임라인에 Access request expired; access was not granted 가 기록됩니다. 필요하면 에이전트에게 다시 시도하라는 메시지를 보내세요.
  • 웹 앱과 다른 기기에서도 응답할 수 있습니다. 접근을 수행하는 기기의 데스크톱 앱에도 동시에 확인이 표시되며, 먼저 들어온 답변이 적용됩니다.
기기의 Sensitive locations 설정은 실행 환경을 참고하세요.

이메일 전송 전 확인(Gmail)

Gmail을 연결하면 에이전트는 이메일을 보내기 전에 항상 확인을 요청합니다. 타임라인에 Confirm before sending 카드가 나타나며 보내는 사람, 받는 사람, 참조, 숨은 참조, 제목, 본문 요약이 표시됩니다. Send 를 클릭해야만 이메일이 전송됩니다. Don’t send 를 클릭하면 전송되지 않습니다. Gmail 연결은 커넥터를 참고하세요.

입력창 및 중지와의 관계

  • 요청이 대기 중일 때도 입력창은 평소처럼 작동합니다. 입력창을 참고하세요.
  • 에이전트가 직접 처리 단계를 기다리는 동안 대기열 메시지의 Steer 를 클릭하면, 먼저 요청이 Not now 로 종료된 다음 메시지가 삽입됩니다.
  • Stop this turn 을 클릭하면 아직 대기 중인 요청이 취소됩니다.

세션을 보고 있지 않을 때 알 수 있는 방법

알림을 확인해도 요청은 처리되지 않습니다. 세션으로 돌아가 처리해야 합니다.

자주 묻는 질문

개입 카드를 접었습니다. 어떻게 다시 여나요?

입력창 위의 “Needs your input · N pending” 을 클릭하거나, 타임라인의 해당 줄에서 Respond 를 클릭하세요.

Allow와 Allow for this task는 무엇이 다른가요?

Allow 는 이번 한 번만 승인합니다. Allow for this task 는 이 세션에서 이후의 비슷한 작업도 자동으로 허용합니다. 현재 세션에만 적용됩니다.

거부하면 세션이 실패하나요?

반드시 그렇지는 않습니다. 에이전트는 다른 방법으로 작업을 완료하려고 합니다. 정말 계속할 수 없으면 답변에서 설명합니다. 에이전트에게 할 일을 알려 주려면 Something else… 를 사용하세요.

입력한 시크릿이 채팅 기록에 표시되나요?

아니요. 채팅에는 “secret name provided. The value stays out of the chat.” 만 기록됩니다.

관련 문서