a13nDocs

Service 设置参考

Service 设置的每个字段，及其环境变量、类型、范围和默认值。

说明

从 Service 加载器使用的 Settings 定义生成。修改定义后，请运行 uv run --locked python scripts/docs/references.py，不要直接编辑表格行。

优先级、示例、角色和存储要求、跨字段校验请参阅配置 Service。下列类型和字段约束不能替代联合校验。Schema 会隐藏密钥默认值；本参考不会读取部署环境变量值。默认值适用于源码版本，并非所有历史版本。

完整的机器可读验证 schema，包括命名枚举和联合定义，见 Service 设置 JSON。

server

设置环境变量类型 / 选项约束与默认值
server.hostA13N_SERVER__HOST字符串default="127.0.0.1"
server.portA13N_SERVER__PORT整数minimum=1; maximum=65535; default=8000
server.public_urlA13N_SERVER__PUBLIC_URL字符串maxLength=2048; default="http://127.0.0.1:8000"
server.trusted_proxiesA13N_SERVER__TRUSTED_PROXIES字符串数组default=[]
server.request_bytesA13N_SERVER__REQUEST_BYTES整数minimum=1024; maximum=33554432; default=2097152
server.request_timeoutA13N_SERVER__REQUEST_TIMEOUT数值maximum=60; exclusiveMinimum=0; default=10
server.readiness_timeoutA13N_SERVER__READINESS_TIMEOUT数值maximum=30; exclusiveMinimum=0; default=2
server.shutdown_timeoutA13N_SERVER__SHUTDOWN_TIMEOUT整数minimum=1; maximum=300; default=15
server.tls_certificateA13N_SERVER__TLS_CERTIFICATE字符串或 nullformat="path"; default=null
server.tls_keyA13N_SERVER__TLS_KEY字符串或 nullformat="path"; default=null

database

设置环境变量类型 / 选项约束与默认值
database.urlA13N_DATABASE__URL字符串format="password"; default="**********"
database.auto_migrateA13N_DATABASE__AUTO_MIGRATE布尔值default=true
database.pool_sizeA13N_DATABASE__POOL_SIZE整数minimum=1; maximum=100; default=5
database.connect_timeoutA13N_DATABASE__CONNECT_TIMEOUT整数minimum=1; maximum=60; default=5
database.statement_timeoutA13N_DATABASE__STATEMENT_TIMEOUT整数minimum=1; maximum=300; default=10
database.migration_advisory_lock_timeoutA13N_DATABASE__MIGRATION_ADVISORY_LOCK_TIMEOUT整数minimum=1; maximum=3600; default=900
database.migration_lock_timeoutA13N_DATABASE__MIGRATION_LOCK_TIMEOUT整数minimum=1; maximum=60; default=3
database.migration_statement_timeoutA13N_DATABASE__MIGRATION_STATEMENT_TIMEOUT整数minimum=1; maximum=3600; default=900
database.migration_idle_transaction_timeoutA13N_DATABASE__MIGRATION_IDLE_TRANSACTION_TIMEOUT整数minimum=1; maximum=300; default=30

objects

设置环境变量类型 / 选项约束与默认值
objects.backendA13N_OBJECTS__BACKEND"local", "s3"default="local"
objects.rootA13N_OBJECTS__ROOT字符串format="path"; default="var/service/objects"
objects.bucketA13N_OBJECTS__BUCKET字符串或 nulldefault=null
objects.prefixA13N_OBJECTS__PREFIX字符串default=""
objects.endpoint_urlA13N_OBJECTS__ENDPOINT_URL字符串或 nulldefault=null
objects.path_styleA13N_OBJECTS__PATH_STYLE布尔值default=false
objects.regionA13N_OBJECTS__REGION字符串或 nulldefault=null
objects.access_key_idA13N_OBJECTS__ACCESS_KEY_ID字符串或 nullformat="password"; default=null
objects.secret_access_keyA13N_OBJECTS__SECRET_ACCESS_KEY字符串或 nullformat="password"; default=null
objects.max_bytesA13N_OBJECTS__MAX_BYTES整数minimum=65536; maximum=67108864; default=16777216
objects.timeoutA13N_OBJECTS__TIMEOUT数值maximum=60; exclusiveMinimum=0; default=5
objects.upload_bytesA13N_OBJECTS__UPLOAD_BYTES整数minimum=1; maximum=33554432; default=1048576
objects.upload_limitA13N_OBJECTS__UPLOAD_LIMIT整数minimum=1; maximum=1000; default=60
objects.upload_window_secondsA13N_OBJECTS__UPLOAD_WINDOW_SECONDS整数minimum=1; maximum=3600; default=60

redis

设置环境变量类型 / 选项约束与默认值
redis.urlA13N_REDIS__URL字符串format="password"; default="**********"
redis.timeoutA13N_REDIS__TIMEOUT数值maximum=30; exclusiveMinimum=0; default=2

auth

设置环境变量类型 / 选项约束与默认值
auth.session_secondsA13N_AUTH__SESSION_SECONDS整数minimum=60; maximum=604800; default=43200
auth.login_limitA13N_AUTH__LOGIN_LIMIT整数minimum=1; maximum=1000; default=10
auth.login_window_secondsA13N_AUTH__LOGIN_WINDOW_SECONDS整数minimum=1; maximum=3600; default=60
auth.invitation_secondsA13N_AUTH__INVITATION_SECONDS整数minimum=3600; maximum=2592000; default=604800
auth.link_secondsA13N_AUTH__LINK_SECONDS整数minimum=300; maximum=86400; default=3600
auth.expiry_scan_secondsA13N_AUTH__EXPIRY_SCAN_SECONDS数值maximum=3600; exclusiveMinimum=0; default=60
auth.mail.smtp_hostA13N_AUTH__MAIL (JSON 字段 smtp_host)字符串或 nullmaxLength=253; default=null
auth.mail.smtp_portA13N_AUTH__MAIL (JSON 字段 smtp_port)整数minimum=1; maximum=65535; default=587
auth.mail.smtp_securityA13N_AUTH__MAIL (JSON 字段 smtp_security)"starttls", "tls"default="starttls"
auth.mail.smtp_usernameA13N_AUTH__MAIL (JSON 字段 smtp_username)字符串或 nullmaxLength=320; default=null
auth.mail.smtp_passwordA13N_AUTH__MAIL (JSON 字段 smtp_password)字符串或 nullformat="password"; default=null
auth.mail.senderA13N_AUTH__MAIL (JSON 字段 sender)字符串或 nullmaxLength=320; default=null
auth.mail.timeoutA13N_AUTH__MAIL (JSON 字段 timeout)数值maximum=60; exclusiveMinimum=0; default=10

encryption

设置环境变量类型 / 选项约束与默认值
encryption.active_key_idA13N_ENCRYPTION__ACTIVE_KEY_ID字符串或 nullminLength=1; maxLength=128; default=null
encryption.keysA13N_ENCRYPTION__KEYS对象—
encryption.key_fileA13N_ENCRYPTION__KEY_FILE字符串或 nullformat="path"; default=null

control

设置环境变量类型 / 选项约束与默认值
control.scan_secondsA13N_CONTROL__SCAN_SECONDS数值maximum=60; exclusiveMinimum=0; default=1
control.sweep_batchA13N_CONTROL__SWEEP_BATCH整数minimum=1; maximum=10000; default=100
control.inbox_countA13N_CONTROL__INBOX_COUNT整数minimum=1; maximum=10000; default=128
control.inbox_bytesA13N_CONTROL__INBOX_BYTES整数minimum=1024; maximum=16777216; default=2097152
control.subscriptionsA13N_CONTROL__SUBSCRIPTIONS整数minimum=1; maximum=1000; default=32
control.webhook_timeoutA13N_CONTROL__WEBHOOK_TIMEOUT数值maximum=30; exclusiveMinimum=0; default=10
control.import_timeoutA13N_CONTROL__IMPORT_TIMEOUT数值maximum=120; exclusiveMinimum=0; default=30
control.stream_refresh_secondsA13N_CONTROL__STREAM_REFRESH_SECONDS数值maximum=60; exclusiveMinimum=0; default=2

outbox

设置环境变量类型 / 选项约束与默认值
outbox.purge_interval_secondsA13N_OUTBOX__PURGE_INTERVAL_SECONDS数值maximum=3600; exclusiveMinimum=0; default=60
outbox.purge_batchA13N_OUTBOX__PURGE_BATCH整数minimum=1; maximum=10000; default=1000
outbox.purge_budget_secondsA13N_OUTBOX__PURGE_BUDGET_SECONDS数值maximum=60; exclusiveMinimum=0; default=5
outbox.defaults.delivered_retention_secondsA13N_OUTBOX__DEFAULTS (JSON 字段 delivered_retention_seconds)整数minimum=1; maximum=31536000; default=86400
outbox.defaults.dead_retention_secondsA13N_OUTBOX__DEFAULTS (JSON 字段 dead_retention_seconds)整数minimum=1; maximum=31536000; default=1209600
outbox.defaults.max_attemptsA13N_OUTBOX__DEFAULTS (JSON 字段 max_attempts)整数minimum=1; maximum=100; default=12
outbox.defaults.batchA13N_OUTBOX__DEFAULTS (JSON 字段 batch)整数minimum=1; maximum=1000; default=32
outbox.defaults.parallelA13N_OUTBOX__DEFAULTS (JSON 字段 parallel)整数minimum=1; maximum=128; default=8
outbox.defaults.lease_secondsA13N_OUTBOX__DEFAULTS (JSON 字段 lease_seconds)数值minimum=10; maximum=600; default=60
outbox.defaults.backlog_countA13N_OUTBOX__DEFAULTS (JSON 字段 backlog_count)整数minimum=1; maximum=1000000; default=10000
outbox.defaults.backlog_age_secondsA13N_OUTBOX__DEFAULTS (JSON 字段 backlog_age_seconds)数值maximum=86400; exclusiveMinimum=0; default=300
outbox.defaults.backlog_alert_secondsA13N_OUTBOX__DEFAULTS (JSON 字段 backlog_alert_seconds)数值maximum=86400; exclusiveMinimum=0; default=300
outbox.by_kindA13N_OUTBOX__BY_KIND对象—

worker

设置环境变量类型 / 选项约束与默认值
worker.slotsA13N_WORKER__SLOTS整数minimum=1; maximum=128; default=4
worker.max_attemptsA13N_WORKER__MAX_ATTEMPTS整数minimum=1; maximum=20; default=3
worker.lease_secondsA13N_WORKER__LEASE_SECONDS整数minimum=3; maximum=300; default=30
worker.scan_secondsA13N_WORKER__SCAN_SECONDS数值maximum=30; exclusiveMinimum=0; default=1
worker.authority_secondsA13N_WORKER__AUTHORITY_SECONDS数值maximum=30; exclusiveMinimum=0; default=1
worker.drain_secondsA13N_WORKER__DRAIN_SECONDS数值maximum=300; exclusiveMinimum=0; default=10
worker.delivery_countA13N_WORKER__DELIVERY_COUNT整数minimum=1; maximum=128; default=8
worker.delivery_bytesA13N_WORKER__DELIVERY_BYTES整数minimum=1024; maximum=16777216; default=262144
worker.output_bytesA13N_WORKER__OUTPUT_BYTES整数minimum=1024; maximum=16777216; default=1048576
worker.page_itemsA13N_WORKER__PAGE_ITEMS整数minimum=16; maximum=4096; default=256
worker.page_bytesA13N_WORKER__PAGE_BYTES整数minimum=65536; maximum=16777216; default=1048576
worker.content_bytesA13N_WORKER__CONTENT_BYTES整数minimum=1024; maximum=16777216; default=65536
worker.compression_levelA13N_WORKER__COMPRESSION_LEVEL整数minimum=1; maximum=19; default=3
worker.stream_lengthA13N_WORKER__STREAM_LENGTH整数minimum=16; maximum=100000; default=10000
worker.stream_ttlA13N_WORKER__STREAM_TTL整数minimum=1; maximum=86400; default=600
worker.stream_coalesce_secondsA13N_WORKER__STREAM_COALESCE_SECONDS数值minimum=0; maximum=1; default=0.1
worker.stream_trim_secondsA13N_WORKER__STREAM_TRIM_SECONDS数值minimum=0; maximum=600; default=10
worker.child_depthA13N_WORKER__CHILD_DEPTH整数minimum=0; maximum=16; default=4
worker.child_countA13N_WORKER__CHILD_COUNT整数minimum=0; maximum=256; default=16

environments

设置环境变量类型 / 选项约束与默认值
environments.scan_secondsA13N_ENVIRONMENTS__SCAN_SECONDS数值maximum=300; exclusiveMinimum=0; default=5
environments.batchA13N_ENVIRONMENTS__BATCH整数minimum=1; maximum=1000; default=16
environments.operation_secondsA13N_ENVIRONMENTS__OPERATION_SECONDS数值maximum=3600; exclusiveMinimum=0; default=120
environments.renewal_secondsA13N_ENVIRONMENTS__RENEWAL_SECONDS数值maximum=60; exclusiveMinimum=0; default=20
environments.wait_secondsA13N_ENVIRONMENTS__WAIT_SECONDS数值maximum=3600; exclusiveMinimum=0; default=300
environments.managed_countA13N_ENVIRONMENTS__MANAGED_COUNT整数minimum=1; maximum=100000; default=100
environments.docker_hostA13N_ENVIRONMENTS__DOCKER_HOST字符串或 nullminLength=1; maxLength=2048; default=null
environments.docker_mount_rootsA13N_ENVIRONMENTS__DOCKER_MOUNT_ROOTS字符串数组maxItems=64; default=[]

provisioning

设置环境变量类型 / 选项约束与默认值
provisioning.local.enabledA13N_PROVISIONING__LOCAL (JSON 字段 enabled)布尔值default=false
provisioning.local.rootA13N_PROVISIONING__LOCAL (JSON 字段 root)字符串或 nullformat="path"; default=null
provisioning.docker.enabledA13N_PROVISIONING__DOCKER (JSON 字段 enabled)布尔值default=false
provisioning.docker.imageA13N_PROVISIONING__DOCKER (JSON 字段 image)字符串或 nullminLength=1; maxLength=1024; default=null
provisioning.docker.pull_policyA13N_PROVISIONING__DOCKER (JSON 字段 pull_policy)"never", "if_missing"default="if_missing"

memory

设置环境变量类型 / 选项约束与默认值
memory.max_file_bytesA13N_MEMORY__MAX_FILE_BYTES整数minimum=1024; maximum=1048576; default=65536
memory.revisions_per_fileA13N_MEMORY__REVISIONS_PER_FILE整数minimum=1; maximum=1000; default=10
memory.max_total_bytesA13N_MEMORY__MAX_TOTAL_BYTES整数minimum=65536; maximum=1073741824; default=33554432
memory.mounts_per_threadA13N_MEMORY__MOUNTS_PER_THREAD整数minimum=1; maximum=32; default=8
memory.guide_bytesA13N_MEMORY__GUIDE_BYTES整数minimum=256; maximum=65536; default=4096
memory.context_bytesA13N_MEMORY__CONTEXT_BYTES整数minimum=1024; maximum=1048576; default=32768
memory.always_load_bytesA13N_MEMORY__ALWAYS_LOAD_BYTES整数minimum=0; maximum=1048576; default=8192
memory.description_charsA13N_MEMORY__DESCRIPTION_CHARS整数minimum=1; maximum=1000; default=200
memory.frontmatter_bytesA13N_MEMORY__FRONTMATTER_BYTES整数minimum=128; maximum=16384; default=2048
memory.path_bytesA13N_MEMORY__PATH_BYTES整数minimum=16; maximum=1024; default=256
memory.write_retriesA13N_MEMORY__WRITE_RETRIES整数minimum=0; maximum=10; default=3
memory.recall_limitA13N_MEMORY__RECALL_LIMIT整数minimum=1; maximum=50; default=5
memory.recall_bytesA13N_MEMORY__RECALL_BYTES整数minimum=512; maximum=65536; default=8192
memory.recall_secondsA13N_MEMORY__RECALL_SECONDS数值maximum=30; exclusiveMinimum=0; default=2
memory.record_charsA13N_MEMORY__RECORD_CHARS整数minimum=1; maximum=8000; default=8000
memory.default_guide.fileA13N_MEMORY__DEFAULT_GUIDE (JSON 字段 file)字符串或 nullmaxLength=65536; default=null
memory.default_guide.recordA13N_MEMORY__DEFAULT_GUIDE (JSON 字段 record)字符串或 nullmaxLength=65536; default=null

providers

设置环境变量类型 / 选项约束与默认值
providers.http_originsA13N_PROVIDERS__HTTP_ORIGINS字符串数组default=[]
providers.require_httpsA13N_PROVIDERS__REQUIRE_HTTPS布尔值default=true
providers.return_urlsA13N_PROVIDERS__RETURN_URLS字符串数组default=[]
providers.mcp_serversA13N_PROVIDERS__MCP_SERVERS对象数组default=[]
providers.flow_secondsA13N_PROVIDERS__FLOW_SECONDS整数minimum=30; maximum=1800; default=600
providers.operation_secondsA13N_PROVIDERS__OPERATION_SECONDS数值minimum=2; maximum=30; default=10
providers.operation_scan_secondsA13N_PROVIDERS__OPERATION_SCAN_SECONDS数值maximum=3600; exclusiveMinimum=0; default=30
providers.discovery_ttlA13N_PROVIDERS__DISCOVERY_TTL整数minimum=1; maximum=86400; default=300
providers.tool_call_secondsA13N_PROVIDERS__TOOL_CALL_SECONDS数值maximum=600; exclusiveMinimum=0; default=60
providers.model_timeoutA13N_PROVIDERS__MODEL_TIMEOUT数值maximum=3600; exclusiveMinimum=0; default=300
providers.response_bytesA13N_PROVIDERS__RESPONSE_BYTES整数minimum=65536; maximum=268435456; default=16777216
providers.chatgpt_client_idA13N_PROVIDERS__CHATGPT_CLIENT_ID字符串或 nullminLength=1; maxLength=256; default=null
providers.chatgpt_redirect_uriA13N_PROVIDERS__CHATGPT_REDIRECT_URI字符串maxLength=2048; default="http://127.0.0.1:1456/auth/callback"

plugins

设置环境变量类型 / 选项约束与默认值
plugins.keysA13N_PLUGINS__KEYS字符串数组default=[]

composer

设置环境变量类型 / 选项约束与默认值
composer.modelsA13N_COMPOSER__MODELS字符串数组default=["gpt-5.6-luna", "claude-sonnet-5", "deepseek-v4.1-flash", "gemini-3.8-flash"]

telemetry

设置环境变量类型 / 选项约束与默认值
telemetry.log_levelA13N_TELEMETRY__LOG_LEVEL"DEBUG", "INFO", "WARNING", "ERROR"default="INFO"
telemetry.log_formatA13N_TELEMETRY__LOG_FORMAT"pretty", "json"default="json"
telemetry.log_stdoutA13N_TELEMETRY__LOG_STDOUT布尔值default=true
telemetry.log_fileA13N_TELEMETRY__LOG_FILE字符串或 nullformat="path"; default=null
telemetry.log_file_max_mbA13N_TELEMETRY__LOG_FILE_MAX_MB整数minimum=1; maximum=10240; default=100
telemetry.log_file_backupsA13N_TELEMETRY__LOG_FILE_BACKUPS整数minimum=1; maximum=100; default=5
telemetry.metrics_portA13N_TELEMETRY__METRICS_PORT整数或 nullminimum=1; maximum=65535; default=null
telemetry.trace_backendA13N_TELEMETRY__TRACE_BACKEND"none", "langfuse", "logfire"default="none"
telemetry.trace_urlA13N_TELEMETRY__TRACE_URL字符串或 nullmaxLength=2048; pattern="^https?://[^\\s?#@]+$"; default=null
telemetry.langfuse_public_keyA13N_TELEMETRY__LANGFUSE_PUBLIC_KEY字符串或 nullmaxLength=256; default=null
telemetry.langfuse_secret_keyA13N_TELEMETRY__LANGFUSE_SECRET_KEY字符串或 nullformat="password"; default=null
telemetry.logfire_write_tokenA13N_TELEMETRY__LOGFIRE_WRITE_TOKEN字符串或 nullformat="password"; default=null
telemetry.logfire_read_tokenA13N_TELEMETRY__LOGFIRE_READ_TOKEN字符串或 nullformat="password"; default=null
telemetry.trace_contentA13N_TELEMETRY__TRACE_CONTENT"none", "standard", "full"default="standard"
telemetry.trace_query_timeoutA13N_TELEMETRY__TRACE_QUERY_TIMEOUT数值maximum=60; exclusiveMinimum=0; default=10

本页目录

serverdatabaseobjectsredisauthencryptioncontroloutboxworkerenvironmentsprovisioningmemoryproviderspluginscomposertelemetry