> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 입력 필요: 명령 승인, 질문 답변, 시크릿 제공, 직접 처리

> 에이전트가 사용자를 기다리며 일시 중지할 때 나타나는 요청입니다. 명령 승인, 질문 답변, 시크릿 추가, 직접 처리하는 단계, 민감한 위치 접근 요청, 이메일 전송 전 확인, 그리고 세션을 보고 있지 않을 때 알 수 있는 방법을 설명합니다.

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

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 세션이 이 컴퓨터에서 실행될 때는 민감한 위치 접근 요청도 이 컴퓨터에 팝업으로 표시됩니다 |
| 웹 앱 | 지원 | |
| 모바일 웹 | 지원 | |

## 요청이 표시되는 위치

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

## 개입 카드의 공통 작업

| 작업 | 방법 |
| - | - |
| 제출 / 허용 | 카드 오른쪽 아래의 주요 버튼 또는 `⌘Enter`(Windows `Ctrl+Enter`) |
| 거부 / 건너뛰기 / 나중에 | 카드 아래쪽의 보조 버튼 |
| 나중에 처리 | 카드 오른쪽 위의 × 또는 `Esc`. 카드가 "Needs your input · N pending" 으로 접힙니다. 클릭하면 다시 펼쳐집니다 |
| 항목 간 전환 | 카드 머리글의 **Previous request**, **Next request**. 항목은 어떤 순서로든 처리할 수 있으며, 모두 처리한 후에만 세션이 계속됩니다 |

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

### 키보드

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

| 요청 | 키 |
| - | - |
| 명령 승인 | `Enter` 또는 `1` 로 허용, `2` 로 이 작업에 허용, `Esc` 또는 `3` 으로 거부 |
| 질문과 선택 | `1`–`9` 로 N번째 옵션 선택, `Enter` 로 제출 또는 계속, `Esc` 로 카드 전체 건너뛰기 |

## 요청 유형

| 유형 | 카드 제목 | 주요 버튼 | 기타 버튼 |
| - | - | - | - |
| 명령 승인 | **Approval** | **Allow** | **Deny**, **Allow for this task**, **Something else…** 입력란 |
| 자유 형식 답변 | **Question** | **Submit** | **Skip** |
| 선택 | **Choose an option** | **Submit**(질문이 여러 개이면 **Continue**) | **Skip**, **Previous** |
| 시크릿 추가 | **Add secret** | **Submit** | **Skip** |
| 직접 처리 필요 | **Needs your input** | **Done** | **Not now**, **View cloud server**, **Take control** |
| 접근 요청 | **Access request** | **Allow once** | **Deny** |

### 명령 승인

권한이 **Ask for approval** 이거나 **Approve for me** 가 안전하지 않을 수 있는 작업을 감지하면, 에이전트는 실행 전에 승인을 요청합니다. 카드에는 실행할 명령이 표시됩니다.

* **Allow**: 이번 한 번만 승인합니다.
* **Allow for this task**: 이번 한 번을 승인하고, 이 세션에서 이후의 비슷한 작업은 자동으로 허용됩니다.
* **Deny**: 명령이 실행되지 않으며, 에이전트는 다른 방법으로 계속 진행하려고 합니다.
* **Something else…**: 요청을 입력하고 `Enter` 를 누릅니다. 명령을 거부하고 에이전트에게 요청을 전달합니다.

권한 선택은 [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)을 참고하세요.

### 질문과 선택에 답하기

에이전트는 정보가 부족하면 직접 질문합니다. 방안을 골라야 할 때는 선택지를 제시합니다.

* 카드 하나에 질문이 여러 개 있을 수 있습니다. 한 번에 하나씩 표시되며, **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. 작업을 완료합니다. 클라우드 서버를 조작하는 동안 에이전트는 일시 중지되지 않습니다. [클라우드 서버 데스크톱](https://docs.aihubmix.com/ko/cloud/cloud-host/desktop.md)을 참고하세요.
3. 카드로 돌아와 **Done** 을 클릭합니다. 에이전트가 계속 진행합니다.

해당 단계가 필요 없으면 **Not now** 를 클릭합니다. 에이전트는 다른 방법으로 계속 진행하려고 합니다.

### 민감한 위치 접근 요청

세션이 내 기기에서 실행되고 해당 기기의 **Sensitive locations** 가 매번 묻도록 설정되어 있으면, 에이전트는 이런 위치(예: SSH, 키체인, 시스템 구성)에 접근하기 전에 사용자에게 묻습니다.

* 카드에는 이유와 경로, 만료 카운트다운이 표시됩니다.
* **Allow once** 는 이번 접근만 허용하며 기기의 권한 설정은 바뀌지 않습니다. 접근을 수행하는 기기에서 허용하면 시스템이 한 번 더 확인을 요청합니다.
* 응답하기 전에 만료되면 거부로 처리되며, 타임라인에 **Access request expired; access was not granted** 가 기록됩니다. 필요하면 에이전트에게 다시 시도하라는 메시지를 보내세요.
* 웹 앱과 다른 기기에서도 응답할 수 있습니다. 접근을 수행하는 기기의 데스크톱 앱에도 동시에 확인이 표시되며, 먼저 들어온 답변이 적용됩니다.

기기의 **Sensitive locations** 설정은 [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)을 참고하세요.

### 이메일 전송 전 확인(Gmail)

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

## 입력창 및 중지와의 관계

* 요청이 대기 중일 때도 입력창은 평소처럼 작동합니다. [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)을 참고하세요.
* 에이전트가 직접 처리 단계를 기다리는 동안 대기열 메시지의 **Steer** 를 클릭하면, 먼저 요청이 **Not now** 로 종료된 다음 메시지가 삽입됩니다.
* **Stop this turn** 을 클릭하면 아직 대기 중인 요청이 취소됩니다.

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

| 위치 | 표시 내용 |
| - | - |
| 사이드바 | 세션 행 끝에 **Needs your input** 라벨. 접힌 프로젝트에서는 프로젝트 제목 오른쪽에도 표시됩니다 |
| 단축키 | `⌥⌘A`(Windows `Ctrl+Alt+A`)로 사용자를 기다리는 다음 세션으로 이동합니다 |
| 시스템 알림 | **Approval needed**, **Input needed**, **Action needed**. [알림](https://docs.aihubmix.com/ko/cloud/settings/notifications.md)을 참고하세요 |

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

## 자주 묻는 질문

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

입력창 위의 "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." 만 기록됩니다.

## 관련 문서

* [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)
* [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)
* [오류 및 복구](https://docs.aihubmix.com/ko/cloud/sessions/errors-and-recovery.md)
* [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)
* [클라우드 서버 데스크톱](https://docs.aihubmix.com/ko/cloud/cloud-host/desktop.md)
* [알림](https://docs.aihubmix.com/ko/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.