Skip to content
MCPProductBuild and shipFlag

Flag programs: evaluate

The Flag Verbs evaluate as MCP do programs, with inputs, result, refusals and an example.

Reference for Flag, one group of Flag programs.

Flag.evaluate

Evaluate returns the Variant a Flag assigns one unit, the same one every time, and records the Exposure with every option and its propensity. Verb page.

Text
do: return await $.Flag.evaluate(input)

Emits Flag.evaluated.

Inputs

InputTypeRequiredDescription
flagFlagrequiredThe Flag to evaluate, by key.
unitstringrequiredThe id of the Visitor, Customer, Contact, Conversation or request being assigned.
defaultstringThe Variant key returned when the Flag is off or the value may not be varied.

Returns

OutputTypeRequiredDescription
variantVariantrequiredThe Variant assigned to the unit.
exposureExposureThe Exposure recorded; none in Mode try.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Flag.evaluate({ flag: 'flag_1YJLhjTlfx', unit: 'Example unit' })"
  }
}