AppConfigure
AI Agent용 안내: 이 페이지의 Markdown 버전은 https://ankole.agentbull.com/ko-KR/docs/app-configuration/index.md, 전체 문서 색인은 https://ankole.agentbull.com/ko-KR/llms.txt에 있습니다.
사이트 관리자는 Console → AppConfigure에서 사이트 기본값, 워크스페이스 정책과 공유 실행 설정을 관리합니다. Pod 관리자는 Pod 설정에 부여된 기존 관리 권한을 사용합니다.
설정 찾기와 범위 선택
편집 전에 사이트 설정 및 기본값 또는 현재 워크스페이스 재정의를 선택하세요. 데이터 워크스페이스 이름은 항상 표시됩니다. 사이트 기본값은 재정의가 없는 워크스페이스에 적용되며 강제 상한은 아닙니다.
기본 작업 보기에서는 관련 설정을 한 폼에서 편집하고 활성 상태, 재정의와 적용 상태를 확인합니다. 읽기 전용 키 목록은 등록된 키와 동적 규칙의 범위, 값 출처, 암호화 상태와 담당 관리 화면을 보여 줍니다. 검색은 폼 내부 필드와 이전 키 이름도 찾아 해당 필드를 엽니다. 관리 링크는 관련 Console 화면과 탭으로 이동합니다.
사이트 설정은 저장된 사이트 값, 코드 기본값 순서로 해석합니다. 테넌트 설정은 실제 지원되는 Agent 재정의, 워크스페이스 재정의, 사이트 기본값, 코드 기본값 순서입니다. Pod 설정은 워크스페이스 값과 코드 기본값만 사용합니다. 지원되는 다섯 키에서는 Agent 적용 값을 읽기 전용으로 조회할 수 있습니다.
변경과 초기화
한 범위에서 단위를 확인한 뒤 저장하세요. 그룹 설정은 한 번에 커밋되며 필드 하나가 거부되면 전체를 변경하지 않고 초안을 유지합니다. 비밀 값은 명시적으로 표시하기 전까지 가려집니다. 초기화 확인창은 현재 값과 재정의 제거 후 실제 값 및 출처를 보여 줍니다. 기본값과 같은 값을 저장한 경우에도 재정의를 제거할 때까지 독립 설정으로 유지합니다.
시간은 저장 단위를 유지하면서 읽기 쉬운 단위로 입력합니다. 출력 제한 없음(null)과 숫자 상한을 구분하고, 무응답 시간 제한은 명시적으로 끌 수 있습니다(0). 삭제 데이터 보관 기간을 줄이면 영구 삭제에 미치는 영향을 안내합니다.
Trace와 Control Plane Plugin의 재시작 대기 상태는 실행 프로세스와 저장 값이 일치할 때까지 표시합니다. Brain Tick은 공유 BM25 인덱스를 매분 확인하고 토크나이저가 변경되면 다시 만듭니다. 유지보수 중 검색을 사용할 수 없거나 쓰기가 대기할 수 있습니다. 실패하면 Brain 상태 화면과 서버 Tick 로그를 확인하세요.
SMTP는 저장 전 초안으로 테스트 메일을 보내며 저장 설정이나 OTP를 변경하지 않습니다. 비밀번호를 새로 입력하지 않으면 저장된 값을 유지합니다. 성공은 메일 전송 서비스가 수락했다는 뜻이며 초안을 바꾸면 결과가 무효화됩니다.
환경 변수와의 차이
AppConfigure는 제품 설정을 PostgreSQL에 저장하며 대부분의 변경은 이후 작업에 적용됩니다. 배포 환경 변수는 시작 기반을 설정합니다. 도구에 필요한 인증 정보는 Agent 환경 변수에서 관리하세요.
현재 내장 AppConfigure 키
아래 표는 Ankole에 기본 내장된 AppConfigure 키 목록입니다. 설치된 Control Plane Plugin에 따라 추가 키가 등록될 수 있으므로, 실제 운영 인스턴스에서는 AppConfigure 화면에 표시되는 목록을 최종 기준으로 삼으세요.
Agent 런타임
| 키 | 범위 | 용도 |
|---|---|---|
ai_agent.max_iterations |
테넌트 | Agent 단일 턴에서 허용하는 최대 모델 추론 반복 횟수 |
ai_agent.max_output_tokens |
테넌트 | 단일 모델 응답의 최대 출력 토큰 수 |
ai_agent.inactivity_timeout_ms |
테넌트 | 응답이 없는 모델이나 제공자를 기다린 뒤 턴을 종료하기까지의 제한 시간(밀리초) |
ai_agent.library.agent_plugin_defaults |
테넌트 | Agent Plugin의 기본 활성화 상태 |
background_agent_jobs.max_running_per_agent |
테넌트 | Agent당 동시 실행 가능한 최대 BackgroundAgentJob 수(기본값 3, 유효 범위 1–64) |
sessions.wake_recycle |
테넌트 | 콜드 복귀 모델 대화 순환 임계값(기본값 min_cold_gap_seconds: 3600, min_context_tokens: 128000, im_max_idle_seconds: 259200). 프롬프트 캐시가 식은 대용량 모델 대화나 며칠간 유휴 상태였던 외부 IM 세션을 후속 브랜치로 전환하고 상한이 정해진 <wake-briefing>을 주입함 |
Pod, Base, Applet 및 Drive
| 키 | 범위 | 용도 |
|---|---|---|
pod.allow_external_guests |
테넌트 | 초대받은 외부 게스트가 공유된 Pod 페이지에 접근하도록 허용할지 여부(기본값 true) |
pod.applet.limits |
테넌트 | Applet 실행 한도(기본값 timeout_ms: 60000, heap_mb: 128) |
pod.base.limits |
테넌트 | Base 쿼리 및 레코드 한도(기본값 query_rows: 1000, record_bytes: 1000000, group_count: 1000, statement_timeout_ms: 5000) |
pod.office.limits |
테넌트 | Office 페이지(스프레드시트, Word 문서, 프레젠테이션) 한도: 브라우저에서 열 수 있는 최대 파일 크기(max_file_bytes: 20971520)와 편집 내용을 파일에 반영하는 시점(compaction_idle_seconds: 30, compaction_op_threshold: 100, compaction_structural_threshold: 10) |
drive.trash_retention_days |
테넌트 | 삭제된 Drive 노드를 자동으로 영구 삭제하기 전까지 보관하는 일수. 기본값은 30이며, 0으로 설정하면 설정을 바꿀 때까지 무기한 보관 |
drive.vfs_max_upload_bytes |
사이트 | Worker /drive VFS 업로드당 최대 바이트 수. 기본값 0은 객체 저장소 업로드 한도를 사용 |
pod.ot_replay_window |
테넌트 | OT 재생을 위해 보관하는 최근 문서 변경 배치 수(기본값 1000) |
pod.ocr_existing_scans |
테넌트 | 업로드할 때 OCR로 읽지 못한 스캔 PDF 페이지를 OCR 모델로 전송. OCR 제공업체가 페이지마다 요금 부과. 휴지통에 있는 PDF(휴지통 폴더 안의 PDF 포함)는 전송하지 않음(기본값 false) |
Workflow
| 키 | 범위 | 용도 |
|---|---|---|
workflow.max_concurrency_per_run |
테넌트 | 단일 Workflow 실행(run)에서 요청할 수 있는 최대 동시 태스크 수(기본값 8, 범위 1–32) |
workflow.max_running_per_agent |
테넌트 | 한 Agent의 전체 Workflow에 걸쳐 동시에 실행할 수 있는 최대 태스크 수(기본값 8, 범위 1–64) |
workflow.max_agent_calls_per_run |
테넌트 | 단일 Workflow 실행에서 허용되는 총 agent() 호출 횟수(기본값 32, 범위 1–1,024) |
Workflow 생성 시 이 설정보다 높은 값을 요청할 수는 없습니다. 요청된 concurrency나 max_agent_calls가 테넌트 상한을 초과하면 Ankole이 자동으로 테넌트 상한 값으로 낮추어 저장합니다. 작업 분할 방식과 실행 결과 확인은 Workflows를 참조하세요.
Brain
Brain은 테넌트의 ankole_brain 시스템 주체로 모델을 호출합니다. 추출(light), 분석(heavy), URL 가져오기(web_fetch), 재순위화(rerank) 프로필은 Console의 모델 설정에서 관리하며 Pod와 사이트 설정을 상속합니다.
| 키 | 범위 | 용도 |
|---|---|---|
brain.enabled |
테넌트 | Brain 검색, 학습, 유지 관리를 활성화합니다. 비활성화하더라도 이미 저장된 지식은 보존됩니다. |
brain.embedding_model |
사이트 | 벡터 검색에 사용할 Provider, 모델, 벡터 차원 수입니다. 비워 두면 벡터 검색이 비활성화됩니다. |
brain.search_tokenizer |
사이트 | BM25 검색 토크나이저(icu, jieba, lindera_japanese, lindera_korean). 값을 변경한 뒤에는 BM25 인덱스를 재구축해야 합니다. |
brain.chunking |
테넌트 | Source 문서의 청크 크기, 중첩 길이(overlap), 최대 입력 크기 상한입니다. |
brain.forgetting |
테넌트 | 기억 유형별 감쇠 반감기 |
brain.dreaming_task_cron |
테넌트 | 정기 지식 통합(Dreaming) 작업의 실행 스케줄입니다. |
brain.self_healing_task_cron |
테넌트 | 오래된 청크, 임베딩, 검색 인덱스 투영을 재구축하는 자가 복구 스케줄입니다. |
brain.signal_channel_batch_idle_time |
테넌트 | 대화방의 대기 메시지가 학습 배치로 넘어가기까지의 유휴 대기 시간(초)입니다. 대화가 종료될 때도 즉시 학습이 시작됩니다. |
brain.skill_learning_enabled |
테넌트 | Skill 교훈(lesson) 학습 및 주입 기능을 활성화합니다. 비활성화하면 기존 교훈은 보존되지만 실행 시 제공되지 않습니다. |
brain.skill_learning_reflection_threshold |
테넌트 | 단일 Agent에서 Skill 교훈 회고(reflection)를 시작하기 위해 누적되어야 하는 미소비 Signal Job 수입니다(최솟값 2). |
지식 저장·회상 방식과 모델 요구 사항은 Brain을, Skill 실행 시 함께 주입되는 교훈은 Skill lessons를 참조하세요.
AI Gateway 및 observability
| 키 | 범위 | 용도 |
|---|---|---|
ai_gateway.compaction |
사이트 | 대화 히스토리 자동 압축 정책 |
observability.traces.enabled |
사이트 | 다음 컨트롤 플레인 시작 시 프로세스 전체 OpenTelemetry 내보내기를 켤지 여부 |
observability.traces.provider |
사이트 | langfuse, langsmith 또는 일반 opentelemetry 트레이스용 시맨틱 매핑 방식 |
observability.traces.otlp_endpoint |
사이트 | 선택적 트레이스 전송을 위한 기본 OTLP/HTTP 엔드포인트 |
observability.traces.otlp_headers |
사이트 | 선택적 트레이스 전송에 사용할 암호화된 인증 헤더 |
Langfuse, LangSmith, VictoriaTraces 및 기타 OTLP/HTTP 수집기 연동 방법은 LLM observability를 참조하세요.
패스워드리스 Email OTP 및 Pod 로그인 정책
| 키 | 범위 | 용도 |
|---|---|---|
authn.email.mail |
사이트, 암호화 | 패스워드리스 Email OTP 로그인용 SMTP 발송 설정(server, from, port, ssl 및 선택적 자격 증명). 비워 두면 Email OTP 로그인이 비활성화됨 |
authn.email.code_ttl_seconds |
사이트 | 이메일 인증 코드 유효 시간(초, 기본값 600) |
authn.email.send_limits |
사이트 | 공유 전송 시간 범위와 이메일, 요청 출처 및 채널별 한도 |
authn.email.failure_limits |
사이트 | 공유 인증 실패 시간 범위와 이메일 및 요청 출처별 한도 |
principals.pod_login_policy |
테넌트, 다른 곳에서 관리 | Pod 구성원 로그인 및 초대 정책(allow_email_otp, allow_member_credential_change, allowed_email_domains, require_sso_for_members, allow_invite_links). Pod Settings에서 관리 |
Identity, 플러그인, 기능 플래그 및 테넌트 기본값
| 키 | 범위 | 용도 |
|---|---|---|
principals.identity_providers.active |
테넌트, 읽기 전용 | Pod 워크스페이스 구성원과 관리자를 인증하는 활성 테넌트 Identity Provider(Pod Settings 및 Identity Provider 페이지에서 관리) |
principals.identity_providers.directory_full_sync_interval_minutes |
테넌트 | 조직 디렉터리 전체 동기화 주기(분) |
tenants.privileged_tenant_id |
사이트, 읽기 전용 | 사이트 관리 권한을 가진 siteadmin 그룹이 소속된 특권 테넌트 ID |
plugins.enabled_ids |
사이트, 다른 곳에서 관리 | 다음 시작 시 활성화할 :optional Control Plane Plugin 목록(:always 플러그인은 빌드 시 포함되며 상시 활성 유지) |
features.<flag> |
사이트 | OpenFeature 기반 기능 플래그 배포 정책({enabled, percent, targets}, Ankole.Features.Config) |
signals.show_dead_letter_error_details |
사이트 | Conversation에 전송되는 데드레터 안내 메시지에 길이 제한 및 마스킹 처리된 Session 턴 오류 요약을 포함할지 여부(기본값 false) |
system.timezone |
테넌트 | 스케줄러 및 각종 컨트롤 플레인 기능에 적용할 기본 시간대 |
i18n.default_locale |
Pod | 해당 Pod 워크스페이스의 인터페이스, 알림 메일, Agent 메시지 기본 표시 언어(Pod 관리자는 Pod Settings에서도 변경 가능) |
Workers, 웹 읽기 및 보안
| 키 | 범위 | 용도 |
|---|---|---|
agent_workers.ready_timeout_seconds |
사이트 | 시작된 Worker가 ready 상태에 도달할 때까지 기다리는 최대 시간(초, 기본값 600). 초과 시 새 캐시 디스크로 인스턴스를 재생성함 |
agent_workers.rendered_fetch_idle_ttl_ms |
테넌트 | 내장 web_fetch 브라우저 렌더링 폴백 인스턴스의 유휴 유지 시간(밀리초) |
security.ssrf_filter |
사이트 | 모델이 호출하는 URL fetch 요청에서 사설망(private), 루프백(loopback), 링크 로컬(link-local), CGNAT 대역 접근을 차단할지 여부 |
참고로 security.ssrf_filter를 끄더라도 클라우드 인스턴스 메타데이터 주소 접근은 항상 차단됩니다.
agent_workers.ready_timeout_seconds은 기동이 지연되어 준비 완료 상태에 이르지 못한 비정상 인스턴스를 복구하기 위한 설정이며, 정상 유휴 인스턴스의 자동 회수는 provider YAML의 idleReleaseAfter 항목으로 제어합니다. 자세한 내용은 Worker를 참조하세요.
최초 실행 상태
| 키 | 범위 | 용도 |
|---|---|---|
setup.bootstrap_activation_code |
사이트, 읽기 전용 | 최초 실행 설정 화면에서 요구하는 일회성 임시 활성화 코드 |
setup.completed |
사이트, 읽기 전용 | 인스턴스의 최초 실행 설정 완료 여부 |
이 두 키는 최초 실행 설정 절차에서 자동으로 관리됩니다. 초기 활성화 코드를 확인해야 할 때는 kit show bootstrap-activation-code 명령을 실행하고, AppConfigure 화면에서는 직접 수정하지 마세요.
암호화된 설정
Ankole은 자격 증명 성격의 설정값을 암호화해 저장하며 목록과 편집 화면에는 마스킹된 형태로만 표시합니다. 마스킹된 상태 그대로 저장하면 기존 값이 유지되고, 새 값을 입력해 저장할 때만 교체됩니다.
현재 저장된 원문을 꼭 확인해야 할 때만 Reveal 기능을 사용하고, 화면에 표시된 자격 증명을 채팅방이나 스크린샷, 이슈 티켓에 붙여 넣지 마세요.