forge_context_graph_update
Update a context graph by providing a new version with state definitions, guidelines, and initial states to control agent conversation flow.
Instructions
Update a context graph by creating a new version. All fields are required. The terminal state must have exactly one action.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context_graph_id | Yes | The context graph ID to update | |
| description | Yes | Description of the conversation flow | |
| new_user_initial_state | Yes | State name for new users (must be an action state, alphanumeric and underscores only) | |
| returning_user_initial_state | Yes | State name for returning users (must be an action state, alphanumeric and underscores only) | |
| terminal_state | Yes | Name of the terminal state (must have exactly one action, alphanumeric and underscores only) | |
| references | No | References to other state machines: { ref_name: [machine_id, version] } | |
| global_intra_state_navigation_guidelines | Yes | Navigation guidelines applied to all states | |
| global_action_guidelines | Yes | Action guidelines applied to all states | |
| global_boundary_constraints | Yes | Boundary constraints applied to all states | |
| states | Yes | Array of state definitions (action, decision, recall, annotation, reflection, or tool-call) | |
| org_id | No | Org ID (uses active org if omitted) |