Configuration

The short list that is environment, and the long list that is not.

Configuration is split by a single rule:

If it decides how a call runs, it travels with the call. If it decides how the process runs, it is an environment variable.

That split is why the environment list below is so short, and why the same binary can serve agents belonging to different customers at the same time. The per-call half is documented under the agent profile.

The process prints its whole configuration at boot, including which variables are set but not read — usually a rename, or a setting that has moved to the call:

[env] ---- agent server configuration ----
[env]   APP_GRPC_LISTEN_PORT             50052   # gRPC port, all interfaces
[env]   ULAI_GRPC_API_KEY                set len=64 sha256:57a4cbf1   # demanded of callers; unset = NO AUTH
[env]   ONNXRUNTIME_LIB                  /usr/local/lib/libonnxruntime.so (file present)   # Smart Turn and Silero; the image sets it
...
[env] ---- end agent server configuration ----

Process

This is the whole list. Nothing else in the environment is read.

VariableDefaultWhat it does
APP_GRPC_LISTEN_PORT50052The gRPC control surface. Binds all interfaces inside the container.
APP_HTTP_PORT8080/health, and nothing else.
ULAI_GRPC_API_KEY(none)Required as x-api-key on every RPC. Unset means no authentication.
PROMPT_LOG(on)Logs every text turn and tool result sent to the model. off stops it. Audio is never logged.
APP_PPROF_PORT6060pprof. Binds container-loopback, so publishing the port does nothing.
PROFILER_ENABLEDfalseStarts pprof at all.
ONNXRUNTIME_LIB(set by the image)Where ONNX Runtime is, for the turn and voice-activity models cascade calls use. Leave it alone.
GOMAXPROCS, GOMEMLIMIT, GOGC(auto)Runtime tuning. GOMEMLIMIT is derived from the cgroup limit when unset.

No longer read

Earlier images also read call settings from the environment. These are now ignored, because every call setting arrives with the call:

AI_BACKEND, AI_CLASSIFY_BACKEND, AI_TRANSCRIBE_MODEL, ULAI_LIVE_*, CASCADE_*, AMD_ENABLED, AUDIO_NOTHING, LOST_UTTERANCE_REPLAY, GEMINI_PROJECT_ID, GEMINI_LIVE_LOCATION, GOOGLE_APPLICATION_CREDENTIALS.

Remove them from your deployment. While they are set, the boot report lists the AI_*, GEMINI_*, GOOGLE_* and ULAI_* ones on its NOT READ BY THIS PROCESS line.

A call that arrives with no project or no key is refused with a message naming the field and both places it can be set. It is not quietly run against whatever ambient identity the host happens to carry — on a GCE instance that succeeds at authentication and then fails the Live handshake with insufficient authentication scopes, which describes neither the missing setting nor the account it borrowed.