# Secrets and machine-specific values. Nothing else belongs here. # # Everything this agent needs at runtime lives in kubernetes/configmap.yaml — # its name, its model, its guard rails, its observability backend. That file is # not Kubernetes-only: Kubernetes injects it with `envFrom: configMapRef`, # and ./run-local.sh passes each key through as -e. One file, and the local # container and the deployed pod agree. # # This file holds only what a ConfigMap cannot hold: # # * secrets — a ConfigMap is stored unencrypted and is readable by # anyone who can list ConfigMaps in the namespace # * your machine — a gateway URL that is yours and nobody else's # # If you are looking for a setting and it is not here, it is in the ConfigMap, # and that is where to change it. Values used to be listed in both files; they # drifted, and the drift was silent, which is why they are not any more. # # Precedence, when the same key appears in more than one place: # # shell environment > this file > kubernetes/configmap.yaml # # So `LITELLM_MODEL=claude-sonnet-4-6 ./run-local.sh` overrides everything for one run # without editing anything. # # The agent-creation page renders this file as a form, so the conventions below # are read by a machine as well as by you: # # KEY="" empty value -> you must supply it; the form marks it required # KEY="default" has a value -> optional; leaving it alone keeps the default # # KEY="v" commented -> optional and switched off; supplying a value # in the form uncomments it # # optional in a comment -> overrides the empty-value rule above # # fixed in a comment -> set by the template; not shown in the form # # configmap in a comment -> owned by kubernetes/configmap.yaml, which is # what Kubernetes and run-local.sh actually # read; not shown in the form # # A comment block directly above a key becomes that field's help text, and the # first sentence of a block that opens a new topic becomes a section heading. # # .env is gitignored and is never copied into the image. Commit .env.example. # Gateway — where this agent sends its model calls. # # required # # The Create Agent page fills in the gateway its own platform uses, so a new # agent reaches a model as generated. Outside the platform the placeholder # below stays: it is not a working value -- an agent started with it fails on # the first request -- so replace it in `.env` before you expect an answer. LITELLM_PROXY_BASE="will provide later" # The gateway key. # # optional # # Not asked for on the creation page, and deliberately: a key typed into a web # form also lives in the browser's autofill, in the request that carried it, # and in whatever logged that request — none of which you chose. So the project # ships this empty and you set it here, on your machine: # # LITELLM_MASTER_KEY="sk-..." # # `.env` is gitignored and is never copied into the image, so the key stays # where you put it. ./run-local.sh stops with "set LITELLM_MASTER_KEY (see # .env.example)" until you do. LITELLM_MASTER_KEY="" # MCP agent key — optional, and issued by the MCP Gateway when the agent is # created rather than supplied by you. The platform writes the # real key into .env at scaffold time and leaves it blank in .env.example, so # the key never reaches git. Leave this line in place: removing it is what # would break the injection. MCP_AGENT_API_KEY="" # Local only. "true" restarts the server when app/, schemas/, agent.yaml or # prompt.md changes. # DEV_RELOAD="true" # configmap — Changing something while you build and test. # # Uncomment a line and it wins for this machine only. You do not need to open # kubernetes/ — that directory is generated and maintained by the platform, and # nothing in it needs editing to try something locally. # # The values shown are the template's starting points, not necessarily what # your agent is set to; the live value is whatever the ConfigMap holds, and an # uncommented line here beats it. # Point it at a different model. (To rename the agent, or change its # description or version, edit agent.yaml.) # LITELLM_MODEL="gpt-5.4" # LITELLM_TEMPERATURE="0.0" # LITELLM_MAX_TOKENS="16384" # Where the MCP tools declared in agent.yaml (`mcp:`) are reached, and where # telemetry goes. On a cluster the platform sets these for every agent and the # agent cannot change them; these lines are only for running on your machine. # MCP_GATEWAY_URL="http://localhost:8000" # Telemetry: "otel" (to an OpenTelemetry Collector, at # OTEL_EXPORTER_OTLP_ENDPOINT) or "none". The collector forwards to Langfuse # and holds its keys; an agent has none. A setting that cannot work turns # telemetry off with a log line, never a 500. # OBSERVABILITY_TYPE="otel" # OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318" # OBSERVABILITY_CAPTURE_CONTENT="true" # Loop bounds, if an agent is running longer than you want to wait. # AGENT_MAX_ITERATIONS="25" # AGENT_MAX_REQUEST_MODEL_CALLS="100" # AGENT_MAX_DURATION_SECONDS="1500" # LOG_LEVEL="INFO" # Log format. "console" is easier to read on your machine; the default, "json", # is one object per line for a log store. # LOG_FORMAT="console" # Signs the conversation the agent hands over when it pauses for a person's # approval, so it can carry on from there (runtime 0.28.0 or later). Optional # locally: unset, the agent makes one at start-up. # AGENT_CONTINUATION_KEY=""