본문으로 건너뛰기

구성 참조

아래의 모든 설정은 환경 변수입니다. 백엔드는 backend/.env에서 읽습니다(주석이 달린 템플릿은 backend/.env.example입니다). 프런트엔드 변수 두 개는 프런트엔드 자체의 프로세스 환경에서 읽습니다. 모델과 API 키 설정은 LLM 설정 페이지에서 따로 다룹니다.

서버 설정​

변수기본값설명
HOST0.0.0.0백엔드가 바인딩하는 주소
PORT8000백엔드가 바인딩하는 포트
RELOADfalse로컬 개발용 uvicorn 자동 리로드입니다. 백엔드를 python -m backend.main으로 시작할 때만 읽으며, Docker 이미지 자체의 시작 명령은 어느 쪽이든 영향을 받지 않습니다
TIMEZONEUTC배포의 현지 시간대를 나타내는 IANA 이름입니다. 운영 메트릭에서 달력상의 하루가 시작되는 시점, 즉 "오늘" 집계와 리드 타임 추세의 일별 버킷을 결정하며, 작업의 시간 요구 사항에 시간대가 명시되지 않았을 때 워크플로 에이전트가 그 요구 사항을 해석하는 시간대이기도 합니다. 인식할 수 없는 이름은 시작 실패 대신 UTC로 대체되므로, 오타가 있으면 앱이 멈추는 대신 현지 시간이 어긋납니다
APP_BASE_URL—사용자가 브라우저에서 이 배포를 여는 주소입니다. 스킴, 호스트, 필요하면 포트만 쓰고 경로는 붙이지 않습니다(예: https://a2flow.example.com). 알림 이메일의 링크가 이 주소 아래의 받는 사람 테넌트 주소를 가리키고, 싱글 사인온의 리디렉션 URI도 이 주소로 만들어지며, CORS_ORIGINS와 SESSION_COOKIE_SECURE의 기본값도 정해집니다. 다른 형태이면 백엔드가 시작되지 않습니다. 없으면 앱으로 돌아가는 링크 없이 메시지가 전송되고 싱글 사인온을 사용할 수 없습니다. 각 테넌트는 그 아래의 전용 주소(테넌트 이름, 점, 호스트를 이은 것. 예: acme.a2flow.example.com)로도 열 수 있습니다. 그 호스트 아래의 모든 이름(*.a2flow.example.com)을 다루는 DNS와 TLS 인증서가 필요합니다(테넌트 주소에서 로그인하기 참고). 호스트가 IP 주소이면 사용할 수 없습니다

프런트엔드 설정​

변수기본값설명
BACKEND_BASE_URLhttp://localhost:8000리버스 프록시가 먼저 /api/*를 백엔드로 라우팅하지 않을 때(컨테이너 없이 실행할 때) 프런트엔드가 /api/*를 전달하는 대상이며, API 문서 페이지가 로그인한 세션을 확인하는 대상이기도 합니다. 프로세스 시작 시 한 번만 읽습니다. Docker Compose 스택에서는 공개 주소가 아니라 내부 네트워크상의 백엔드 주소입니다
APP_PORT3000Docker Compose 전용입니다. 앱이 공개되는 호스트 포트, 즉 화면과 API를 모두 제공하는 ingress 서비스의 포트입니다. .env에서 APP_BASE_URL을 설정하지 않으면 http://localhost: 뒤에 이 포트를 붙인 값이 기본 URL로 전달됩니다
OPENBAO_PORT8200--profile openbao를 사용하는 Docker Compose 전용입니다. OpenBao UI가 공개되는 호스트 포트입니다. OpenBao로 Vault 시크릿 사용해 보기를 참조하세요. A2Flow는 이 값과 관계없이 내부 네트워크로 접근합니다

애플리케이션 데이터베이스​

변수기본값설명
DB_URLsqlite:///a2flow.db데이터베이스 URL입니다. SQLite(작업 디렉터리 기준 상대 경로)와 PostgreSQL을 지원합니다
DB_POOL_SIZE5PostgreSQL 전용입니다. 백엔드 프로세스의 연결 풀 두 개가 각각 열어 두는 연결 수입니다. 최소 1입니다. 레플리카 전체에서 합산되는 방식은 연결 풀링을 참조하세요
DB_MAX_OVERFLOW10PostgreSQL 전용입니다. 부하가 높을 때 각 풀이 DB_POOL_SIZE에 더해 추가로 열 수 있는 연결 수이며, 부하가 지나가면 다시 닫힙니다. 최소 0입니다

비동기 드라이버 접미사(sqlite+aiosqlite / postgresql+asyncpg)는 자동으로 추가되므로 일반 스킴만으로 충분합니다.

DB_URL=postgresql://user:password@localhost:5432/a2flow

스키마 변경은 버전이 지정된 Alembic 마이그레이션으로 관리되며 시작 시 자동으로 적용되므로, 앱을 다시 배포하면 스키마가 최신 상태가 됩니다. 백엔드 레플리카를 둘 이상 실행하려면 PostgreSQL이 필요합니다. 수평 확장을 참조하세요. 각 테이블의 내용은 데이터베이스에 있습니다.

초기 사용자​

시작 시 백엔드는 숨겨진 시스템 사용자와 실제 계정 두 개를 생성합니다. 각 계정은 대상 레코드가 없음을 발견한 최초의 시작에서만 생성됩니다.

  • 슈퍼 관리자 역할을 가진 초기 root 사용자입니다(권한 부여 참조). 플랫폼 범위입니다(tenantId: null). 실제(시스템 외) 사용자가 한 명이라도 있으면 건너뛰므로 맨 처음 시작할 때만 실행됩니다.
  • Default 테넌트(slug: default)와 그 안에서 관리자 역할을 가진 초기 admin 사용자입니다. 테넌트(slug 기준)와 사용자(해당 테넌트 내 username 기준)는 각각 따로 확인하므로, 어느 한쪽을 다시 만들어도 다른 쪽이 중복되지 않습니다.

숨겨진 시스템 사용자는 부트스트랩 레코드를 소유합니다(로그인할 수 없으며 사용자 목록에서 제외됩니다).

변수기본값설명
ROOT_PASSWORD자동 생성초기 root 사용자의 비밀번호
ADMIN_PASSWORD자동 생성Default 테넌트에 있는 초기 admin 사용자의 비밀번호

둘 중 하나라도 설정되지 않았거나 비어 있으면 임의의 비밀번호가 생성되어, 해당 사용자를 만들 때 WARNING 수준으로 한 번만 로그에 기록됩니다. 그 로그 줄이 지나가고 나면 복구할 수 없습니다. 로컬 시험 이상의 용도라면 첫 실행 전에 둘 다 명시적으로 설정하거나, 시작 로그에서 생성된 비밀번호를 즉시 확보한 뒤 나중에 변경하세요. 사용자 이름은 root와 admin으로 고정되어 있습니다.

세션 수명​

변수기본값설명
SESSION_IDLE_TIMEOUT_SECONDS28800(8시간)요청마다 연장되는 유휴 타임아웃입니다. 인증된 요청은 세션의 마지막 활동 시각을 갱신하는데, 갱신은 최대 5분에 한 번(이 값의 절반이 더 짧으면 그 간격에 한 번)이므로 세션이 그만큼 일찍 끝날 수 있습니다. 이 시간보다 오래 유휴 상태로 둔 세션은 거부되고 삭제됩니다
SESSION_COOKIE_SECUREAPP_BASE_URL이 https://로 시작하면 true, 아니면 false세션 및 CSRF 쿠키에 Secure(HTTPS 전용)를 표시합니다. 그 기본값을 바꿀 때만 설정합니다

쿠키 자체는 세션 쿠키(Max-Age/Expires 없음)이므로 브라우저를 닫을 때도 지워집니다. 브라우저는 프런트엔드와 같은 오리진으로 백엔드에 접근하므로(/api/*가 리버스 프록시 또는 프런트엔드 자체에서 경로 기준으로 백엔드로 라우팅됩니다) 쿠키는 퍼스트 파티가 되고 SameSite=Lax가 문제없이 적용됩니다.

CORS​

변수기본값설명
CORS_ORIGINSAPP_BASE_URL, 없으면 http://localhost:3000백엔드 API 호출을 허용할 오리진의 쉼표 구분 목록

프런트엔드를 제공하는 오리진을 모두 추가하세요.

CORS_ORIGINS=https://app.example.com,http://localhost:3000

*는 시작 시 거부됩니다. allow_credentials=True가 항상 활성화되어 있으며, 와일드카드 오리진과 함께 쓰는 것은 CORS 사양상 유효하지 않기 때문입니다.

싱글 사인온​

변수기본값설명
OIDC_ALLOWED_PRIVATE_HOSTS비어 있음쉼표로 구분한 호스트 이름(예: keycloak.internal,localhost). 테넌트의 싱글 사인온 발급자 URL이 사설 주소로 확인되더라도 이 호스트는 쓸 수 있습니다. 온프레미스 IdP용입니다. 그 밖의 발급자는 공개 주소로 확인되어야 합니다

싱글 사인온은 배포의 기본 URL인 APP_BASE_URL에도 의존합니다(서버 설정 참조). 없으면 싱글 사인온을 사용할 수 없고 관리자 설정에 리디렉션 URI 대신 경고가 표시됩니다. 요건은 두 가지입니다.

  • 기본 URL은 오리진만 — 스킴, 호스트, 필요하면 포트만 쓰고(예: https://a2flow.example.com) 경로는 붙이지 않습니다. 다른 값이면 백엔드가 시작되지 않습니다.
  • 백엔드가 공개 오리진을 볼 수 있어야 합니다. 리버스 프록시 뒤에서는 프록시가 요청을 전달할 때 원래의 Host 헤더를 유지하고 X-Forwarded-Proto를 원래 스킴으로 설정하게 하며, 프록시 주소를 FORWARDED_ALLOW_IPS에 적어 백엔드가 프록시를 신뢰하게 하세요(기본값으로는 127.0.0.1만 신뢰합니다). 그러지 않으면 SSO 로그인마다 리디렉션이 한 번 더 일어납니다.

에이전트 스킬 스토어​

변수기본값설명
SKILLS_DIRbackend/.skills에이전트 스킬 저장소를 얕은 복제로 가져오는 스토어의 루트입니다. docker compose에서는 /var/lib/a2flow/skills이며 skills 명명된 볼륨을 사용합니다
SKILLS_PRUNE_GRACE_SECONDS3600참조 여부와 관계없이 리비전 디렉터리가 유지되는 시간입니다. 풀을 하면 어떤 실행도 고정하지 않은 리비전을 정리하는데, 이 유예 시간은 실행이 현재 리비전을 읽은 뒤 그것을 가리키는 행을 삽입하기까지의 틈을 메웁니다
SKILLS_CLONE_TIMEOUT_SECONDS120복제의 개별 HTTP 요청에 걸 수 있는 시간의 상한입니다. 이 값이 없으면 응답하지 않는 원격 저장소 때문에 복제가 무기한 멈추고 스킬이 복제 중 상태로 남습니다

스토어는 리비전마다 변경되지 않는 디렉터리를 하나씩 가지며, 게시된 리비전은 이후 수정되지 않으므로 풀이 기존 리비전을 로드 중인 에이전트를 방해하지 않습니다.

$SKILLS_DIR/<agent_skill_id>/<commit_sha>/

이것은 캐시가 아니라 지속되는 상태입니다. 워크플로 실행은 시작 시의 리비전에 고정되므로, 디렉터리를 지우면 관리자가 스킬을 다시 풀할 때까지 기존 실행은 스킬을 로드할 수 없습니다(HTTP 409 SKILL_NOT_READY). 게다가 풀은 고정된 리비전이 아니라 저장소의 현재 HEAD를 가져옵니다. 이 디렉터리를 백업하고(백업 및 복원), 모든 백엔드 레플리카에 같은 디렉터리를 제공하세요(수평 확장).

지식 베이스​

변수기본값설명
KNOWLEDGE_SOURCE_MAX_BYTES20971520(20 MiB)지식 베이스에 업로드할 수 있는 문서와, 지식 베이스용으로 가져오는 웹 페이지의 최대 크기입니다. 이를 넘는 업로드는 넘는 즉시 거부됩니다
KNOWLEDGE_INGEST_CHUNK_CHARS40000LLM이 한 번에 읽는 소스의 문자 수입니다. 더 긴 소스는 여러 부분으로 나누어 차례로 읽습니다. 컨텍스트 창이 작은 모델에서는 값을 낮추세요
KNOWLEDGE_FETCH_TIMEOUT_SECONDS30웹 페이지 소스를 가져올 때 요청당 허용되는 시간

소스와 페이지는 세션 파일처럼 데이터베이스에 저장되므로 별도의 볼륨이 필요 없습니다. 소스를 읽을 때는 에이전트에 구성된 LLM(LLM 설정)을 호출하며, 큰 문서에서는 여러 번 호출합니다.

세션 파일​

변수기본값설명
SESSION_FILE_MAX_BYTES20971520(20 MiB)워크플로 세션에 첨부할 수 있는 파일 하나의 최대 크기입니다. 이를 넘는 즉시 업로드가 거부되므로 더 큰 본문이 통째로 메모리에 유지되는 일은 없습니다
SESSION_FILES_MAX_TOTAL_BYTES209715200(200 MiB)세션 하나가 보유하는 모든 파일의 합계 크기입니다. 파일은 해당 실행이 삭제될 때만 제거되므로, 오래 실행되는 세션의 상한은 이 값으로 정해집니다

세션 파일은 디스크가 아니라 데이터베이스에 저장되므로 전용 디렉터리도, 레플리카 간 공유 볼륨도 필요 없으며 데이터베이스 백업 외의 백업 단계도 없습니다(백업 및 복원). 이 제한을 높이면 실행 하나가 차지할 수 있는 데이터베이스 용량과 업로드나 다운로드 한 번에 드는 메모리가 늘어납니다. 바이트를 통째로 읽기 때문입니다.

시크릿 관리​

변수기본값설명
SECRET_ENCRYPTION_KEY—local 시크릿을 저장하기 전에 암호화하는 데 쓰는 Fernet 키
SECRET_KEY_FILE.secret_key디스크의 키 파일 경로로, SQLite 데이터베이스 파일 옆에 있습니다. docker compose에서는 /var/lib/a2flow/secret-key/.secret_key이며, 백엔드와 이메일 워커가 공유하는 secret-key 명명된 볼륨을 사용합니다

암호화 키는 처음 사용할 때 다음 순서로 결정됩니다.

  1. SECRET_ENCRYPTION_KEY. 유효한 Fernet 키여야 합니다.
  2. SECRET_KEY_FILE의 키 파일.
  3. 둘 다 없으면 키를 생성해 그 파일에 저장하고 WARNING을 로그에 남깁니다.

키를 백업하세요. 키를 잃으면 저장된 로컬 시크릿을 모두 복호화할 수 없으며, 승인 CA의 서명 키도 같은 키로 보호됩니다.

HashiCorp Vault용 환경 변수는 없습니다. 테넌트 전용 Vault는 해당 테넌트의 관리자가 관리자 설정에서, 전역 Vault의 주소는 슈퍼 관리자가 시스템 설정에서 설정하며, 전역 Vault에 대한 각 테넌트의 자격 증명은 테넌트 페이지에서 설정합니다. 테넌트 전용 Vault 주소는 사용자가 입력하는 다른 URL과 같은 SSRF 검사를 거치므로 공개 주소여야 합니다. 전역 Vault 주소는 슈퍼 관리자만 설정할 수 있고 Vault는 보통 사설 주소에 있으므로 이 검사에서 제외됩니다.

MCP 도구와 승인​

모든 MCP 도구 호출은 호출하는 작업을 위해 발급된 수명이 짧은 X.509 인증서를 제시해야 합니다. 인증서는 작업의 승인이 부여될 때, 또는 아무도 승인을 요청받지 않은 작업이 시작될 때 부여됩니다. 서명 루트는 처음 사용할 때 생성되어 로컬 시크릿과 같은 키로 암호화되어 저장되므로, 이 기능을 쓰기 위해 여기서 구성할 것은 없습니다.

변수기본값제한 대상
MCP_TOOL_CERT_TTL_SECONDS3600작업의 인증서가 유효한 시간으로, 작업이 도구를 호출할 수 있는 기간입니다
MCP_TOOL_CERT_SIGNATURE_WINDOW_SECONDS60프록시를 거치는 각 호출에 첨부되는 소유 증명 서명에 허용되는 시계 오차
MCP_CA_COMMON_NAME / MCP_CA_VALIDITY_DAYSA2Flow MCP Approval CA / 3650생성되는 루트의 주체와 유효 기간입니다. 루트를 처음 생성할 때만 읽으며, 나중에 바꿔도 기존 루트에는 영향이 없습니다
MCP_REGISTRY_URLhttps://registry.modelcontextprotocol.io레지스트리 찾아보기 대화 상자가 검색하는 레지스트리의 기본 URL
MCP_ELICITATION_TIMEOUT_SECONDS900MCP 서버의 확인 요청에 실행 시작자가 답하기를 도구 호출이 기다리는 시간으로, 이 시간이 지나면 질문이 만료됩니다. 시작자는 방금 작업을 재개한 상태이므로 이 값은 방치된 질문에만 적용됩니다
AGENT_TURN_TIMEOUT_SECONDS3600실행의 에이전트 턴 하나가 지속될 수 있는 최대 시간으로, 대기 시간도 포함됩니다. 도구 호출이 사람을 기다리는 턴도 여전히 실행 중이므로 MCP_ELICITATION_TIMEOUT_SECONDS보다 충분히 크게 유지하세요

MCP 프록시​

등록된 MCP 서버는 A2Flow의 코드가 아니므로 에이전트 및 그 시크릿과 분리된 곳에서 실행됩니다. Docker Compose 배포는 이 모든 것을 설정해 둡니다. 컨테이너를 직접 구성하는 배포는 여기서 설정합니다.

설정하지 않으면(일반 로컬 실행이 이 경우입니다) 에이전트가 자체 프로세스 안에서 MCP 서버에 직접 접근합니다. 개발에는 편리하지만, 누구나 서버를 등록할 수 있는 환경에서는 바람직하지 않습니다.

변수기본값설명
MCP_PROXY_URL미설정프록시의 위치입니다. 이 값을 설정하면 MCP 서버가 에이전트 프로세스 밖으로 옮겨집니다
MCP_PROXY_SERVER_NAME / MCP_PROXY_PORTmcp-proxy / 8443프록시에 접근할 때 쓰는 이름과 프록시가 수신 대기하는 포트입니다. 이름은 인증서의 일부이므로 양쪽이 일치해야 합니다
MCP_PROXY_TLS_DIR애플리케이션 옆의 디렉터리프록시가 자신을 증명하는 데 필요한 자료를 에이전트가 게시하는 위치입니다. 프록시는 같은 디렉터리를 읽기 전용으로 읽습니다
MCP_BACKEND_TLS_DIR애플리케이션 옆의 디렉터리에이전트가 자신의 키를 보관하는 위치입니다. 의도적으로 위의 디렉터리와 분리되어 있으며, 프록시에서 실행되는 어떤 것도 이 키를 읽을 수 없어야 합니다
MCP_TRANSPORT_CERT_VALIDITY_DAYS365그 자료의 수명입니다. 남은 기간이 30일 미만이 되면 자동으로 재발급되므로 신경 쓸 필요가 없습니다
MCP_SANDBOX_DIR미설정샌드박스화된 서버 실행에 쓰이는 테넌트별 홈 디렉터리의 위치입니다. 테넌트의 서버가 다운로드한 패키지가 테넌트별 디렉터리로 나뉘어 이곳에 보관됩니다. 설정하면 로컬에서 시작하는 모든 서버가 각자의 샌드박스에서 실행되며, 프록시는 이 값 없이 시작하지 않습니다. 일반 로컬 실행에서는 설정하지 않으며, 이때 서버는 샌드박스 없이 시작됩니다

LLM​

시스템의 기본 LLM(모든 테넌트의 에이전트가 실행되는 모델과 그 모델에 접속하는 키)은 시스템 설정 화면에서 편집합니다. 아래 두 변수를 사용하면 아래의 알림 이메일 설정처럼 환경에서 설정할 수도 있습니다. 제공자 설정 방법은 LLM 설정에서 설명합니다.

변수기본값역할
SYSTEM_DEFAULT_LLM_MODEL—Gemini 모델 이름, 또는 다른 제공자라면 litellm:<제공자>/<모델>. 이 변수도 화면도 지정하지 않으면 기본 제공 기본값 gemini-3.8-flash를 사용합니다
SYSTEM_DEFAULT_LLM_API_KEY—해당 제공자의 API 키. 암호화하여 저장되며 로그에 기록되지 않고 어떤 API 응답에도 반환되지 않습니다

아래의 알림 이메일 설정과 마찬가지로 이 변수들은 시작할 때마다 다시 적용됩니다.

  • 백엔드가 시작될 때 시스템 설정에 적용됩니다. 설정된 변수는 관리자가 화면에서 저장한 값을 덮어쓰므로, 키를 교체하려면 변수를 바꾸고 재시작합니다. 설정하지 않았거나 비어 있는 변수는 해당 필드를 건드리지 않으므로 화면에서 관리할 수 있습니다.
  • 형식이 잘못된 값은 경고로 로그에 기록하고 건너뜁니다. 예를 들어 200자를 넘는 모델 이름입니다. 알림 이메일 설정은 그대로 적용되고 앱도 시작됩니다.
  • 설정하지 않으면 예전처럼 제공자 자체의 환경 변수를 읽습니다. 저장된 키가 없는 동안에는 GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, AWS_BEARER_TOKEN_BEDROCK 중 하나가 사용됩니다. Vertex AI처럼 하나의 키로 표현되지 않는 자격 증명도 이렇게 전달합니다.

알림 이메일​

이 값들은 관리 UI의 시스템 설정에서 편집하는 값과 같으며, 배포가 메일 구성을 수동 단계로 남겨 두지 않고 함께 제공할 수 있도록 환경 변수로도 설정할 수 있습니다.

변수기본값설명
SMTP_ENABLEDfalse이메일 전송의 마스터 스위치입니다. 명시적으로 true여야 하며, 다른 변수가 설정되어 있다고 해서 자동으로 추론되지 않습니다
SMTP_HOST / SMTP_PORT— / 587메시지를 넘겨줄 릴레이입니다. 여기에는 내부 호스트 이름만 써도 됩니다. 이 값은 SMTP 클라이언트에 넘겨질 뿐 가져오기 대상이 아닙니다
SMTP_SECURITYstarttlsnone, starttls, ssl 중 하나
SMTP_USERNAME / SMTP_PASSWORD—SMTP AUTH 자격 증명입니다. 비밀번호는 암호문으로만 저장되며, 로그에 남지 않고 어떤 API 응답으로도 반환되지 않습니다
SMTP_FROM_EMAIL / SMTP_FROM_NAME—보내는 주소(전송을 켜면 필수)와 그 옆에 표시되는 선택적 표시 이름

이 페이지의 다른 설정과 달리 이 값들은 사용할 때마다 새로 읽지 않고 단일 설정 레코드에 기록됩니다. 그래서 별도의 규칙이 적용됩니다.

  • 처음뿐 아니라 시작할 때마다 다시 적용됩니다. 따라서 릴레이 비밀번호 교체는 재배포로 이루어집니다.
  • 실제로 설정한 변수만 기록됩니다. 설정하지 않은 변수는 관리자가 UI에서 직접 구성한 내용을 포함해 저장된 값을 그대로 유지합니다.
  • 잘못된 값은 경고로 로그에 남고 통째로 건너뜁니다. 잘못된 포트나 주소, 또는 호스트 없는 SMTP_ENABLED=true는 저장된 구성을 건드리지 않으며, 앱은 그대로 시작됩니다.

활성화 플래그가 분리되어 있으므로, 릴레이의 호스트와 자격 증명을 한 번의 배포에서 미리 준비해 두고 전송은 이후 배포에서 켤 수 있습니다.

발신 이메일 대기열​

릴레이로 내보내는 대기열의 조정 값입니다. 동작은 전송 대기열을 참조하세요. 일반적인 배포에서는 여기서 설정할 것이 없습니다.

변수기본값설명
EMAIL_WORKER_IN_PROCESStrueAPI 프로세스가 대기열 처리 워커도 실행할지 여부입니다. 켜져 있으면 uvicorn main:app만으로 메일이 전송됩니다. 전용 워커 프로세스를 실행할 때는 false로 설정하세요. 프로세스 구성을 참조하세요. 둘 다 켜 두어도 안전하지만 의미는 없습니다. 권고 잠금이 배포 전체에서 정확히 하나의 발신자를 선출합니다
EMAIL_SEND_RATE_PER_SECOND5.0릴레이에 넘기는 초당 메시지 수입니다. 워커는 보내기 전마다 1 / rate만큼 쉽니다. 릴레이 제한이 더 엄격하면 그 아래로 낮추세요
EMAIL_QUEUE_BATCH_SIZE / EMAIL_QUEUE_POLL_INTERVAL_SECONDS20 / 5.0대기열 처리 한 번에 가져오는 메시지 수와, 대기열이 비어 있을 때 워커가 잠자는 시간입니다. 폴링 간격은 워커가 잠든 동안 생성된 알림의 전송 지연 하한입니다
EMAIL_MAX_ATTEMPTS9메시지가 데드 레터가 되기 전까지의 전송 시도 횟수입니다. 백오프는 15초, 30초, 1분, 2분 순으로 늘어나 1시간에서 멈추므로, 기본값이면 약 1시간의 릴레이 중단을 버틸 수 있습니다. 릴레이가 영구 실패로 보고한 경우는 횟수와 상관없이 첫 시도에서 포기합니다
EMAIL_SENT_RETENTION_DAYS30전송된 메시지를 워커가 삭제하기 전까지 보관하는 기간입니다. 대기열 상태가 아니라 무엇을 보냈는지에 대한 기록입니다. 데드 레터는 삭제되지 않습니다

에이전트​

변수기본값설명
EXECUTION_MAX_PARALLEL_SESSIONS4워크플로 실행 하나가 동시에 작업하는 세션의 최대 수로, 기본 세션과 작업 그래프가 분기할 때 포크되는 분기 세션을 합한 수입니다. 한도에 도달하면 준비된 작업은 새로 포크하지 않고 자신의 세션을 기다립니다. 1은 포크를 끕니다. 최소 1입니다
ROLE_DESCRIPTION일반적인 어시스턴트 설명에이전트의 시스템 프롬프트를 구성하는 기반이 되는 역할 텍스트로, 워크플로 규칙 및 인터페이스 스키마와 함께 쓰입니다
SESSION_RUNNER_CONCURRENCY4레플리카 하나가 실행 자체를 위해 동시에 처리하는 턴의 수입니다. 대상은 시작 턴과 승인 결정 후의 재개입니다. 각 턴은 모델과의 실시간 대화이므로, 이 값은 아무도 보고 있지 않은 실행에 대해 레플리카가 하는 모델 호출을 제한합니다. 최소 1입니다