승인
승인은 실행이 멈춰서 사람을 기다리는 방식입니다. 에이전트가 실행 도중 승인을 요청하면 지정된 승인자가 채팅에서 결정하고, 그 결정이 승인 범위에 포함된 단계의 도구를 잠금 해제합니다.
사람의 승인
파괴적이거나 되돌릴 수 없는 작업처럼 에이전트가 움직이기 전에 명시적인 허락이 필요한 작업이라면, 에이전트는 승인을 요청하고 일시 중지합니다.
요청 대상
요청의 수신처는 정확히 하나입니다. 둘 다이거나 아무 데도 없는 경우는 없습니다.
| 수신처 | 알림을 받는 사람 | 결정할 수 있는 사람 |
|---|---|---|
| 사용자 한 명 | 그 사람만 | 그 사람만 |
| 사용자 그룹 | 승인자 역할을 가진 모든 구성원. 각자 알림을 받습니다 | 그중 누구나. 가장 먼저 내린 결정으로 확정됩니다 |
그룹을 수신처로 지정하면 승인이 한 사람의 사정 때문에 막히지 않습니다. 승인할 수 있는 구성원이 없는 그룹은 처음부터 거부됩니다. 그런 요청은 결코 처리될 수 없기 때문입니다. 실행 자체에 있는 액세스 제어 태그를 모두 갖지 않은 수신처도 거부됩니다. 요청을 볼 수 없으니 결정도 할 수 없기 때문입니다. 누군가 결정해도 다른 구성원의 알림이 사라지지는 않으며, 다만 더 이상 조치할 수 없게 될 뿐입니다. 실제로 결정한 사람은 기록됩니다. 그룹 이름만으로는 "누가 승인했는가?"에 답할 수 없기 때문입니다.
에이전트는 팀 구성원 누구나 결정할 수 있을 때는 그룹을 우선하고, 스킬에서 특정인을 요구할 때는 한 사람을 지정하도록 지시받습니다.
결정
에이전트가 요청을 평문으로 설명하면 그 아래 채팅에 컨트롤이 나타납니다. 단, 지정된 승인자에게만 나타납니다. 수신처가 그룹이면 여러 사람이 동시에 컨트롤을 볼 수 있습니다. 그 밖의 사람에게는 읽기 전용 "대기" 메시지가 표시됩니다.
결정하기 전에 요청에 대해 에이전트에게 물어볼 수 있습니다. 채팅에 질문을 입력하면 상담이 열리고, 에이전트가 답변하며, 실행을 시작한 사람도 참여할 수 있습니다. 결정이 내려지면 상담은 종료됩니다.
| 결정 | 의미 | 에이전트의 동작 |
|---|---|---|
| 승인 | 진행해도 됩니다 | 승인 범위 단계의 도구가 잠금 해제된 상태로 진행합니다 |
| 반려 | 하지 마세요 | 작업을 실패 또는 건너뜀으로 표시합니다 |
| 반환 | 수정해서 다시 요청하세요 | 요청을 확정하지 않고 작업을 되돌려 보냅니다 |
결정은 채팅에서든 승인 목록에서든 어디에서 내려도 곧바로 실행을 재개하며, 아무도 실행 채팅을 열어 두지 않아도 마찬가지입니다. 컨트롤이 나타나기 전에 내린 결정도 사라지지 않습니다. 실행이 해당 지점에 도달하면 곧바로 그 결정을 반영합니다.
반환은 다른 두 결정과 나란히 있는 세 번째 결정이며 반려의 변형이 아닙니다. 반환 비율이 높다면 애초에 요청하지 말았어야 할 작업이 아니라 상위 단계의 품질 문제를 가리킵니다.
각 결정에는 선택적으로 댓글을 남길 수 있습니다. 결정 자체는 최종입니다. 승인자 그룹의 두 구성원이 실제로 경합할 수 있으므로, 기록된 결정을 바꾸게 될 두 번째 결정은 덮어쓰지 않고 거부됩니다. 나중에 댓글을 수정할 수는 있으며, 그래도 기록된 결정자와 결정 시각은 바뀌지 않으므로 요청부터 결정까지 걸린 시간은 승인자의 실제 시간 그대로 유지됩니다.
지정된 승인자만 결정할 수 있으며, 예외는 없습니다. 수신자가 아닌 슈퍼 관리자도 마찬가지입니다. 같은 규칙이 작업 상태에도 적용됩니다. 작업 상태를 직접 변경하거나 실행 에이전트에게 변경을 요청하는 것은 실행을 시작한 사람과 해당 작업을 범위에 포함하는 승인의 승인자로 제한됩니다. 승인자는 자신의 결정 범위에 있는 단계(승인이 지정한 작업과 다음 승인 전까지의 이후 모든 단계)를 변경할 수 있으며, 이 덕분에 승인으로 실행을 재개할 수 있습니다. 승인을 요청받은 범위 밖의 작업은 진행할 수 없습니다. 그것을 허용하면 실행의 어떤 승인자든 수신자를 대신할 수 있게 되기 때문입니다.
요청이 승인하는 대상
요청은 동의할 문장 하나에 그치지 않습니다. 승인 대상 아래에 요청이 허용하게 될 모든 호출이 나열됩니다. 도구와, 그 도구의 입력별로 허용되는 값입니다. 이 목록이 바로 결정의 대상이며, 이후 서버가 실행에 적용하는 기준입니다.
입력의 한도는 다음 다섯 가지 중 하나로 표시됩니다.
| 표시 | 의미 |
|---|---|
"ap-northeast-1"와(과) 같음 | 정확히 그 값이며 다른 값은 안 됩니다 |
["t3.micro", "t3.small"] 중 하나 | 나열된 값 중 어느 하나 |
2 이하 | 그 값보다 크지 않은 숫자 |
8 이상 | 그 값보다 작지 않은 숫자 |
패턴 "^dev-"와(과) 일치 | 그 형태의 텍스트. 여기서는 dev-로 시작하는 모든 텍스트 |
선택 사항으로 표시된 입력은 생략할 수 있고, 나열된 다른 입력은 모두 제공해야 합니다. 전혀 나열되지 않은 입력은 거부되므로, 실행이 승인자에게 보여 주지 않은 입력을 끼워 넣을 수 없습니다.
결정하기 전에 한도를 읽고, 넓은 한도는 넓은 결정으로 받아들이세요. 두 대면 되는 작업에
100 이하를 승인하면 서버 100대 분량의 권한을 주는 셈입니다. 한도가 작업에 필요한 것보다 넓다면
요청을 반환하고 그렇게 알려 주세요. 에이전트가 더 좁은 한도로 다시 요청할 수 있습니다.
모든 입력으로 표시된 호출은 유일한 예외입니다. 워크플로 디자인에서 그 도구는 목록 조회나 검색처럼 읽기만 한다고 정했으므로, 요청은 호출에 쓰이는 값에 대한 동의를 구하지 않으며 실행은 필요한 값으로 호출할 수 있습니다. 그 밖의 점은 동일합니다. 결정의 범위에 포함되며, 승인하기 전에는 호출할 수 없습니다. 이렇게 표시된 도구가 무언가를 변경할 수 있어 보인다면 요청을 반환하고 문의할 이유가 됩니다.
반대로 읽지 않도록 주의하세요. 아래에 입력이 하나도 나열되지 않은 호출은 정반대를 뜻합니다. 그 도구를 호출할 수 있지만 아무것도 전달할 수 없습니다.
도구 호출을 전혀 승인하지 않는 요청에는 이런 목록이 표시되지 않습니다. 공지 문구에 동의하는 것처럼 A2Flow가 직접 수행하지 않는 행위를 통제하는 승인입니다.
승인이 잠금 해제하는 것
승인 게이트는 에이전트가 아니라 서버가 적용합니다. 승인 범위에 포함된 단계는 그 승인이 부여될 때까지 연결된 MCP 도구를 하나도 호출할 수 없습니다. 호출은 서버에 닿기 전에 거부됩니다. 승인 범위의 각 단계는 시작할 때 수명이 짧은 인증서를 부여받으며, 이후 그 단계의 모든 도구 호출은 이 인증서를 제시해야 합니다.
모든 단계에 이런 인증서가 필요하며, 누군가에게 승인을 요청한 단계만 그런 것이 아닙니다. 어떤 승인의 범위에도 속하지 않는 단계는 진행 중으로 표시되는 순간 실행을 시작한 사람의 권한으로 인증서를 받습니다. 따라서 도구 호출이 누구를 대신해 이루어졌는지 항상 기록에 남고, 주체가 불분명한 채 도구에 닿는 경로는 없습니다. 승인은 그 권한을 승인자 자신의 권한으로 바꿀 뿐입니다.
모델에 대한 지시로는 얻을 수 없는 이점이 두 가지 있습니다.
- 프롬프트 인젝션이나 버그로 승인을 건너뛸 수 없습니다. 게이트는 서버가 확인하는 규칙이며, 에이전트 지침의 문장과 재개를 거부하는 프런트엔드를 조합한 것이 아닙니다.
- 부여된 도구는 고정됩니다. 인증서에는 단계가 시작될 때 연결되어 있던 도구가 담기며, 승인 범위에 포함된 단계의 도구는 더 이상 편집할 수 없습니다. 실행의 단계와 도구는 워크플로의 게시된 디자인에서 오고 에이전트가 변경할 수 없으므로, 결정 이후에 일어나는 어떤 일도 부여 범위를 넓힐 수 없습니다. 파일을 읽는 단계를 승인했다고 해서 파일 삭제까지 승인한 것이 되지는 않습니다.
- 승인된 인수도 고정됩니다. 요청에는 승인하는 호출, 즉 각 도구와 호출할 수 있는 값의 한도도 함께 담기며, 결정 전에 요청이 보여 주는 내용이 바로 이것입니다. 이후의 모든 호출을 이 내용과 대조하므로, "도쿄에 작은 서버 한 대 시작"을 승인한 것이 다른 곳에 큰 서버 열 대를 시작하는 승인이 되지는 않습니다. 요청이 승인하는 대상을 참조하세요.
결정이 포함하는 범위는 요청이 지정한 단계와 다음 승인 전까지의 이후 모든 단계입니다. 워크플로에서는 보통 요청을 별도의 단계로 보여 줍니다. "승인 요청" 다음에 "인스턴스 시작"이 오는 식이며, 결정 하나가 둘 다 포함하므로 같은 일의 단계마다 승인자에게 다시 묻지 않습니다. 알아 두면 좋은 결과가 두 가지 있습니다.
- 승인된 두 분기가 만나는 지점의 단계는 두 결정이 모두 있어야 동작할 수 있습니다.
- 요청 이전의 어떤 단계도 그 요청의 범위에 포함되지 않습니다. 승인은 앞으로만 적용됩니다.
결정된 모든 도구 호출은 허용이든 거부든, 제시한 인증서와 함께 실행의 도구 호출 페이지에 기록되므로, "누가 어떤 근거로 승인했는가"에 나중에 답할 수 있습니다.
이를 위해 따로 구성할 것은 없습니다. 인증서 수명은 구성 참조에서 조정할 수 있습니다.
보장의 범위. MCP 게이트웨이는 현재 백엔드 프로세스 안에서 실행되므로, 인증서는 그 프로세스를 공유하는 검증자에게 소유 사실을 증명할 뿐이며 이미 백엔드를 장악한 공격자에 대한 방어는 아닙니다. 인증서가 제공하는 것은 실패 시 차단되는 단일 적용 지점, 사후에 넓힐 수 없는 부여, 검증 가능한 기록입니다.
승인 둘러보기
관리 사이드바에서 승인을 열면 모든 승인 요청을 둘러볼 수 있습니다. 이 화면은 조회용이며, 결정은 채팅의 승인 / 반려 / 반환 컨트롤에서 내립니다.
| 열 | 기본 표시 |
|---|---|
제목, 상태(대기 중 / 승인됨 / 반려됨 / 반환됨), 설명, 생성 일시 | 예 |
| 워크플로 실행 — 요청이 나온 실행으로 가는 링크 | 예 |
| 태그 — 읽기 전용이며, 요청이 속한 워크플로 실행의 태그입니다(워크플로 실행과 승인 태그 참조) | 예 |
| 결정자 — 사용자 또는 승인자 그룹의 이름이며, 해당 페이지로 연결됩니다 | 열 선택기에서 |
| 승인자의 댓글과 결정 일시 | 열 선택기에서 |
각 행에는 실행의 채팅으로 바로 이동하는 워크플로 세션 열기 작업도 있으며, 워크플로 실행 목록에 있는 것과 같습니다.
부여된 승인의 상세 페이지에는 승인된 MCP 도구 아래에 승인한 내용이 추가로 표시됩니다. 시작된 승인 범위 단계마다 항목이 하나씩 있으며, 각 항목에는 부여된 도구, 유효 기간, 인증서 폐기 여부가 표시됩니다. 패널이 조금씩 채워지는 것은 정상입니다. 단계는 시작할 때 인증서를 받으므로, 방금 부여된 승인에는 아직 아무것도 표시되지 않을 수 있습니다. 도구 목록이 비어 있는 항목도 오류가 아닙니다. 해당 단계가 MCP 도구를 호출하지 않고 작업을 수행한다는 뜻입니다.
승인된 호출에는 승인자가 결정 전에 읽은 것과 같은 목록, 즉 요청이 허용한 호출과 입력의 한도가 표시됩니다. 위의 패널과 달리 단계가 시작될 때가 아니라 요청이 만들어지는 순간 채워지며, 이후에는 바뀌지 않습니다. 결정이 실제로 무엇에 관한 것이었는지 보여 주는 기록입니다. A2Flow가 이 한도를 기록하기 전에 내린 승인은 여기에 대시가 표시됩니다.
적용 시작 필드는 승인이 시작되는 단계를 나타냅니다. 그 이후 다음 승인 전까지의 모든 단계도 범위에 포함됩니다.