자동화

Console 봇

범위가 한정된 Archibot 봇 작업을 채팅에서 초안으로 작성하고 작업 패킷을 검토한 뒤, 고객 정책, 프로필, 청사진 게이트가 허용할 때만 실행합니다.

고객 관리자플랫폼 운영자

마지막 업데이트 2026년 6월 18일

안전한 데이터를 사용한 Console 렌더링 예시: 봇 화면은 작업 채팅 빌더에서 열리며, 워크스페이스 핸드오프가 활성화될 때까지 설정 전용 배너가 표시됩니다.

봇의 용도

Console 봇은 범위가 한정되고 잘 설명된 변경을, Console 병합 이벤트, 검토, QA, 사람 승인으로 끝나는 Archibot 작업으로 바꿉니다. 봇 작업은 작업할 리포지토리와 브랜치, 그 안에 머물러야 할 경로 범위, 그리고 이후 QA 단계가 실행해야 할 QA 메모를 담습니다.

작업을 저장한다고 코드가 병합되지는 않습니다. 계정이 설정 전용 모드인 동안, 화면에는 Setup only 배너가 표시되며 검토 가능한 작업 레코드를 담고 있을 뿐입니다. 실행이 활성화되어도, Console은 워크스페이스가 시작되기 전에 봇 정책, 선택된 프로필, 허용된 청사진, 동시 실행 제한, 월간 예산을 여전히 확인합니다.

봇을 사용할 수 있는 사람

고객 관리자는 자신의 계정에 대한 봇 작업을 초안으로 작성하고 관리할 수 있습니다. 플랫폼 운영자는 선택한 고객 계정에 대해 동일한 작업을 할 수 있으며, 실행을 게이트하는 정책, 프로필, 청사진 설정도 관리합니다.

고객 구성원은 봇 페이지를 열 수 없습니다. 구성원이 봇 작업이 필요하면 고객 관리자에게 검토 및 초안 작성을 요청하세요.

페이지 구성 방식

Console 사이드바에서 Bots를 엽니다. 헤더 배너에는 계정에 따라 Setup only 또는 Workspace handoff enabled가 표시되며, 오른쪽 상단에 New bot task 버튼과 Refresh가 있습니다.

헤더 아래에는 각각 카운트가 있는 섹션 탭의 행이 있습니다.

탭	담고 있는 것
Task chat	귀하가 형성 중인 초안의 채팅 빌더와 작업 패킷.
Bot tasks	초안 및 완료된 봇 작업과 검토, QA, 로그, 승인 상태.
Run history	실행 요청과 그 러너, 활동, 정제된 로그.
Bot policy	실행을 게이트하는 고객별 스위치와 제한.
Bot profiles	워커 템플릿, 추론, 제한을 정의하는 고객 프로필.
Blueprints	고정된 워크플로 템플릿과 각각이 고객에게 활성화되어 있는지 여부.

Setup only 배너, New bot task 버튼, Chat with Archibot에서 열린 작업 채팅 빌더가 있는 Console 봇 헤더.

채팅에서 작업 형성하기

Task chat 탭은 Chat with Archibot에서 열립니다. 이는 이전의 고정 양식을 대체합니다. 대화로 작업을 설명하면, 세부 사항이 명확해짐에 따라 Archibot이 작업 패킷을 채웁니다.

Bots를 열고 Task chat 탭에 머무릅니다.
Chat with Archibot 하위 탭을 사용합니다. 무엇을 변경해야 하는지, 무엇이 완료로 간주되는지, QA가 어떻게 증명해야 하는지 묻는 시작 메시지를 읽습니다.
시작 칩을 사용해 대화의 초점을 좁히거나, 직접 메시지를 입력합니다.
- Acceptance criteria는 설명을 합격/불합격 기준으로 바꿉니다.
- QA plan은 브라우저 점검, 데이터 설정, 실행을 실패시켜야 할 조건을 초안으로 작성합니다.
- Add evidence는 메모나 붙여넣은 증거로부터 작업을 형성합니다.
- Narrow scope는 봇이 건드릴 수 있는 리포지토리 경로, 브랜치, 파일을 좁힙니다.
Message Archibot에 입력하고 Send를 선택합니다(또는 Ctrl+Enter를 누릅니다). 각 메시지는 QA 메모를 업데이트하고 제목이나 범위를 제안할 수 있습니다.
Task packet 하위 탭으로 전환하여 저장 전에 Archibot이 담은 내용을 검토합니다.

요청은 구체적으로 유지하세요. 명확한 수용 기준을 갖춘 “Space Console에 필드 추가”는 작동하지만, “앱 수정”이나 “리포지토리 정리”는 작동하지 않습니다.

작업 패킷 검토 및 완성

Task packet 하위 탭은 작업과 함께 저장되어 워크스페이스로 전달될 값을 보여줍니다. 오른쪽 상단에 필드 수가 나타나며, 상단의 세 가지 요약 카드는 Customer, Profile, Source를 보여줍니다.

Overview, Source, Product, QA & save 하위 탭 위에 Customer, Profile, Source 요약 카드가 있는 작업 패킷 보기.

패킷은 각각 카운트가 있는 자체 하위 탭으로 구성됩니다.

Overview는 고객, 프로필, 작업 제목, 기본 브랜치를 포함한 패킷 필드를 나열합니다.
Source는 봇이 작업하는 Repository URL과 Base branch, 그리고 변경이 특정 폴더 내에 머물러야 할 때의 Path scope(예: src/, docs/)를 담습니다.
Product는 선택 사항입니다. 봇이 런타임 리포지토리에 의존하는 제품 리포지토리를 편집해야 할 때 Add dependent product repository를 켭니다. 그런 다음 제품 리포지토리 URL, 기본 브랜치, Checkout path, Deploy command를 설정합니다. 런타임 리포지토리가 먼저 준비된 다음, 제품 리포지토리가 체크아웃, 배포되고 워크트리 및 병합 이벤트 소스로 사용됩니다.
QA & save는 QA notes(브라우저 점검, 데이터 설정, 엣지 케이스)와 저장 컨트롤을 담습니다.

준비가 되면, QA & save의 버튼은 계정 상태에 따라 레이블이 지정됩니다.

설정 전용 모드에서는 Save draft로 표시되며 검토 가능한 작업 레코드만 저장합니다. 워크스페이스 실행, 예산, 병합 이벤트 핸드오프는 비활성화 상태로 유지됩니다.
워크스페이스 핸드오프가 활성화되면 Start bot으로 표시됩니다.

버튼은 작업 제목과 필수 필드가 설정될 때까지 비활성화 상태로 유지됩니다. 플랫폼 운영자는 먼저 Customer 계정도 선택해야 합니다.

봇 작업

Bot tasks 탭은 초안 및 완료된 작업을 그 검토, QA, 로그, 승인 상태와 함께 나열합니다. 작업을 열어 그 패킷과 이력을 확인합니다. 더 이상 원하지 않는 초안을 중지하려면 취소하세요. 취소는 감사 레코드를 유지하며 작업을 삭제하는 대신 상태를 canceled로 설정합니다.

실행 이력

실행이 활성화되면, 실행은 브랜치를 만들고, 워크스페이스를 준비하고, 그 결과를 병합 이벤트로 Console에 전달할 수 있습니다. Run history 탭은 각 실행 요청을 왼쪽에, Run detail 패널을 오른쪽에 표시합니다.

왼쪽에 실행 요청 목록, 오른쪽에 모드, 브랜치, 활동, Open merge request 액션을 보여주는 Run detail 패널이 있는 Run history 탭.

세부 정보 패널은 실행 상태, Mode, Branch, 러너 작업, Activity 타임라인, 정제된 실행 로그를 보여줍니다. 병합 이벤트가 존재하면 Open merge request가 그것에 연결됩니다. Console은 검토 레이어로 유지됩니다. 필요한 검토와 QA 게이트가 통과한 후, 사람이 Console에서 검토 승인하고 병합합니다. 검토 흐름은 영구 환경 및 CI 검토를 참조하세요.

봇 정책(운영자)

Bot policy 탭은 워크스페이스 실행이 허용되기 전에 고객이 어떤 봇을 요청할 수 있는지 제어합니다. 배지는 Customer enabled 또는 Customer disabled를 보여줍니다.

Allow bot runs 토글, 기본 프로필과 워크스페이스 대상, 예산과 동시 실행 프리셋, 보존, 워크스페이스 정리 컨트롤이 있는 Bot policy 탭.

주요 컨트롤:

Allow bot runs for this customer는 고객 스위치입니다. 워크스페이스가 시작되기 전에 글로벌 플랫폼 스위치와 실행 오케스트레이터도 활성화되어 있어야 함을 메모가 상기시킵니다.
Default profile과 Workspace target은 새 실행에 적용되는 기본값을 설정합니다.
Monthly bot budget units와 Concurrent runs는 프리셋 선택지와 자유 입력을 제공합니다.
Log and artifact retention days는 로그와 증거를 보관하는 기간을 설정합니다.
Workspace cleanup은 각 실행 후 워크스페이스를 삭제할지, 디버깅을 위해 실패한 것을 유지할지, 수동으로 삭제할 때까지 모두 유지할지 선택합니다.
Artifact handling은 Shared Drive로 보관하는 것을 포함해 증거가 보존되는 방식을 선택합니다.
Allowed blueprints는 이 고객이 실행할 수 있는 청사진을 제한합니다.

설정을 저장하려면 Save policy를 선택합니다.

봇 프로필(운영자)

Bot profiles 탭은 작업 초안에 사용되는 워커 템플릿, 추론, 도구, 제한을 정의하는 고객별 프로필을 만듭니다.

고객 선택기, 프로필 이름과 청사진 필드, 설명, Make this profile selectable 토글, 템플릿 및 런타임 설정이 있는 Bot profiles 탭.

프로필을 소유하는 Customer 계정을 선택합니다.
New profile을 선택한 다음, Profile name과 사용할 Blueprint을 설정합니다.
프로필이 변경할 수 있는 것과 QA가 그 작업을 어떻게 다뤄야 하는지에 대한 Profile description을 추가합니다.
Make this profile selectable를 켜서 새 실행에 사용할 수 있도록 합니다. 비활성화된 프로필은 설정을 위해 표시된 상태로 유지되지만 사용해서는 안 됩니다.
Workspace target, Template, Reasoning effort, Runtime cap (seconds), Monthly budget units, Concurrent runs, Tool allowlist를 설정합니다.
Save profile을 선택합니다. 기존 프로필은 Edit profile, Use as template, Delete profile을 제공합니다.

청사진(운영자)

Blueprints 탭은 Console managed feature, Console managed fix, Console managed docs 같은 고정된 워크플로 템플릿을 나열합니다. 각 카드는 그 검토 모델, QA 단계, 런타임 제한, 파일 예산을 Enabled 또는 Setup only 배지와 함께 보여줍니다.

검토, QA, 런타임, 파일 예산 세부 정보와 활성화 컨트롤이 있는 Console managed feature, fix, docs 워크플로를 나열하는 Blueprints 탭.

Enable for customer 또는 Disable for customer를 사용하여 고객이 실행할 수 있는 워크플로를 제어합니다. 여기서 청사진을 활성화한다고 작업이 시작되지는 않습니다. 정책과 프로필이 선택할 수 있는 범위를 넓힐 뿐입니다.

안전한 콘텐츠

비밀번호, API 키, 쿠키, 초대 링크, 웹훅 비밀, 비공개 리포지토리 토큰, 데이터베이스 URL, 파드 환경 변수, 원시 로그, 고객 데이터를 봇 작업, QA 메모, 프로필, 청사진 설정에 넣지 마세요.

안전한 콘텐츠에는 리포지토리 URL, 브랜치 이름, 이슈 참조, 경로 범위, 비밀이 아닌 설정 메모, 표시되는 Console 오류, 검증할 브라우저 동작이 포함됩니다.

이후에 일어나는 일

계정에 봇 실행이 활성화되면, 저장된 작업은 제어된 워크플로의 시작점이 될 수 있습니다. 워크스페이스 설정, 구현, 병합 이벤트 생성, 검토, QA, 사람 승인입니다. 각 단계는 무언가가 병합되기 전에 여전히 일반 Console 검토 게이트를 통과합니다.

완료 기준

귀하는 고객 관리자 또는 플랫폼 운영자입니다.
작업 제목, 리포지토리, 브랜치, 경로 범위, QA 메모에 비밀 정보가 없습니다.
워크스페이스나 병합 이벤트가 시작되기를 기대하기 전에, 고객 정책과 ISM에 의해 봇 실행이 활성화되어 있습니다.
검토 승인과 Console에서의 병합은 여전히 사람 검토자가 처리합니다.