add-global-variable

Add Global Variable

Create a global variable that persists across all topics within a conversation.

Instructions

1. Auto-discover the agent directory:

   Glob: **/agent.mcs.yml
   

   Use the top-level agent. NEVER hardcode an agent name.

2. Read settings.mcs.yml to get the schemaName prefix:

   Read: <agent-dir>/settings.mcs.yml
   

   Extract the root-level schemaName value (e.g., copilots_header_cre3c_fullagent).

3. Determine from the user:

   • Variable name (PascalCase, e.g., LastDiscussedCity)
   • Description of what it stores
   • Whether the AI orchestrator should be aware of it (aIVisibility)
   • Default value (if any)
   • DO NOT skip any of these properties. If the user doesn't provide them, ask follow-up questions to get the necessary information.

4. Create the variable file at <agent-dir>/variables/<VariableName>.mcs.yml:

# Name: <Human-readable Name>
# <Description>
name: <VariableName>
aIVisibility: <UseInAIContext or HideFromAIContext>
scope: Conversation
description: <Description of what the variable stores>
schemaName: <prefix>.globalvariable.<VariableName>
kind: GlobalVariableComponent
defaultValue: <DEFAULT or specific value>

1. Key fields explained:
   • name — PascalCase identifier. This is how topics reference the variable: Global.<name> (e.g., Global.LastDiscussedCity).
   • aIVisibility — Controls orchestrator awareness:
     • UseInAIContext — The orchestrator can read and reason about this variable. Use when the variable influences routing or response generation (e.g., user preferences, conversation state the AI should track).
     • HideFromAIContext — The variable exists but the orchestrator doesn't see it. Use for internal bookkeeping (e.g., counters, flags) that topics use but the AI doesn't need to reason about.
   • scope: Conversation — Always Conversation for global variables (persists for the session).
   • schemaName — Must follow the pattern <agent-schemaName>.globalvariable.<VariableName>. Read the prefix from settings.mcs.yml.
   • defaultValue — Initial value. Use DEFAULT if no specific initial value is needed.