Skip to main content
A . Floats should use the environment transport as they are never large enough to use the filesystem transport.
Option valuetransport = "fs"transport = "env"
(IEEE 754 -precision, big-endian)(utf8)

​
Full example

[options.EXAMPLE_F32_OPTION]
type = "f32"
required = false
default = 3.14159265359

display.label = "Example f32 Option"
display.description = "This is an example f32 option."
display.group = "Example Group"

# If variants are defined, min/max should not be defined
# validation.variants = [0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0]

validation.min = -10.0
validation.max = 10.0

​
option.type

required 
type = "f32"

​
option.default

optional
An float specifying the default value for this option. If this is specified, setting required = true will have no effect.
default = 3.14159265359

​
option.required

default false
optional If required = true this option is not optional and must be specified. Setting required = true for an option that has a default value has no effect. 
required = true

​
option.validation

The server performs option validation before running an agent. The Coral server will never launch an agent with option values that do not pass the validation rules given for an option. The absence of a validation rule indicates that the absent validation rule should not be performed. No validation rules have default values. For list types, validation will be performed on each item on the list. A single invalid item will reject the entire list.

​
option.validation.variants

optional An array of floats that specify valid values for this option. If variants is specified, the value for this option must be one of the entries in variants. This is usually used to construct an enum. 
validation.variants = [3.14159265359, 2.71828182846, 1.41421356237]

​
option.validation.min

optional A float specifying the minimum allowed value for this option. 
validation.min = -100.0

​
option.validation.max

optional A float specifying the maximum allowed value for this option. 
validation.max = 100.0

​
option.transport

default env
optional Controls how the option value is sent to the agent.

​
Environment transport

transport = "env"
The environment transport will send the option value to the agent via an environment variable. The name of the environment variable will match the option name, and the value will be encoded in UTF-8. For lists, multiple values will be sent delimited by a comma ,. It is recommended to use option.base64 = true when there is a chance the value will contain a comma.

​
Filesystem transport

transport = "fs"
The filesystem transport will send the option value to the agent via a file. An environment variable matching the name of this option will be sent to the agent, the value of the environment variable will be the path to the file that contains the value for the option. For lists, multiple files will be created. A list of paths will be provided in the environment variable, delimited by either:
  • ; on Windows
  • : on Unix-like operating systems

​
option.display

Display options are used to configure how the option should render in the Coral console. They may also be used in other third-party interfaces.

​
option.display.label

optional A string literal specifying the label for this option. Coral console will display this label instead of the option’s name if it is specified. 
display.label = "My option"

​
option.display.description

optional A string literal specifying a description for this option. The description will appear as a tooltip for this option in the Coral console. 
display.description = "My option is used for ..."

​
option.display.group

optional A string literal specifying the group that this option belongs to. Options with the same group will appear grouped in the Coral console. 
display.group = "Prompts"