genai.ini

genai.ini#

As genai is a containerized service, the configuration does not rely on providing a genai.ini file. Instead, the configuration is provided through environment variables that are made available to the container.

Notes for administrators

  • A /etc/squirro/genai.ini file exists in most Squirro deployments, but it should not be used to configure the service.

  • Version 3.13.0 includes breaking changes that may require adjustments if you are upgrading from an earlier version. Learn more

Environment variables allow you to customize how the GenAI Docker image behaves and connects to external services. Some of these variables are mandatory. If they are not set or are misconfigured, the service may fail to start or function correctly.

Variable Name

Type

Required

Description

Example Value

SQ_DATABASE_URL

string

Yes

Database URL for the GenAI service (currently only supports the pymysql connector).

mysql+pymysql:///genai.db

SQ_TOPIC_API_ENDPOINT

string

Yes

Endpoint for the Squirro topic API.

https://my-instance.squirro.cloud/api/topic

SQ_USER_API_ENDPOINT

string

Yes

Endpoint for the Squirro user API.

https://my-instance.squirro.cloud/api/user

SQ_USER_SERVICE_CLIENT_ID

string

Yes

Value of the genai.client_id configuration in the [clients] section of the Squirro platform user.ini. Required to run query processing.

myclientid

SQ_USER_SERVICE_CLIENT_SECRET

string

Yes

Value of the genai.client_secret configuration in the [clients] section of the Squirro platform user.ini. Required to run query processing.

myclientsecret

SQ_CLUSTER

string

Yes (for remote clusters)

Fallback Squirro cluster URL, used if it is not specified in the request. Default value is http://localhost.

https://my-instance.squirro.cloud/

SQ_DECRYPT_COMMAND

string

No

Path to the command that resolves the CK_CMD variables in the Squirro config files.

/opt/squirro/container/squirro_container_ck_cmd.sh

SQ_LOG_LEVEL

string

No

Log level for the genai service.

INFO

SQ_CA_FILE

string

No

Path to file containing certificates that should be added to the container.

/etc/certs/selfsigned_ca.pem

SQ_DATABASE_SSL_CA

string

No

Path to file containing certificates that should be added to the database connection (alternative to setting the file in SQ_DATABASE_URL; injects value into SQLAlchemy connect_args).

/etc/certs/selfsigned_ca.pem

SQ_REDIS_CACHE_HOST

string

No

Redis server host used for caching (if not specified, some caching may not be performed).

127.0.0.1

SQ_REDIS_CACHE_PORT

int

No

(see above)

6380

SQ_REDIS_CACHE_PASSWORD

string

No

(see above)

redis-password

SQ_REDIS_CACHE_DB

int

No

(see above)

7

SQUIRRO_REFRESH_TOKEN

string

No

Fallback refresh token, used if it is not specified in the request.

myrefreshtoken

SQUIRRO_PROJECT_ID

string

No

Fallback project ID, used if it is not specified in the request.

myprojectid

SQUIRRO_SEARCH_MODE

string

No

Fallback search mode, used if it is not specified in the request.

hybrid, dense_only or sparse_only.

OPENAI_API_KEY

string

No

Fallback API key for OpenAI, used if it is not specified in the request.

sk-secret-key

OPENAI_MODEL

string

No

Fallback OpenAI model, used if it is not specified in the request.

gpt-4o

SQ_DISABLE_AUTHENTICATION

string

No

For testing pruposes only - If set to true, the service does not require authentication (a true value is NOT FOR PRODUCTION ENVIRONMENTS).

false

SQ_ROOT_PATH

string

No

root_path provided to FastAPI, for serving behind a proxy

/api/v1

SQ_GENAI_AUTO_POPULATE_DEFAULT_AGENTS

string

No

If set to true, the service automatically populates the default agents in the database.

true (default)

SQ_LLM_RATE_LIMIT_ERROR_MESSAGE

string

No

Error message to return when the rate limit is exceeded.

Rate limit exceeded

SQ_GENERIC_ERROR_MESSAGE

string

No

Error message to return when an error occurs.

An error occurred