Member Junction
    Preparing search index...

    Interface ActionChange

    Represents a runtime modification to an agent's available actions.

    Action changes allow callers to dynamically customize which actions are available to agents at runtime, without modifying the agent's database configuration. This is particularly useful for multi-tenant scenarios where different executions of the same agent need access to different integrations.

    // Add CRM and LMS actions to all agents in the hierarchy
    const change: ActionChange = {
      scope: 'global',
      mode: 'add',
      actionIds: ['crm-search-action-id', 'lms-query-action-id']
    };

    // Remove dangerous actions from sub-agents only
    const restrictChange: ActionChange = {
      scope: 'all-subagents',
      mode: 'remove',
      actionIds: ['delete-record-action-id', 'execute-sql-action-id']
    };

    // Add special actions to a specific sub-agent
    const specificChange: ActionChange = {
      scope: 'specific',
      mode: 'add',
      actionIds: ['special-data-action-id'],
      agentIds: ['data-gatherer-sub-agent-id']
    };

    2.123.0

    interface ActionChange {
        actionIds: string[];
        actionLimits?: Record<string, number>;
        agentIds?: string[];
        mode: ActionChangeMode;
        scope: ActionChangeScope;
    }
    Index

    Properties

    actionIds actionLimits? agentIds? mode scope

    Properties

    actionIds: string[]

    Array of Action entity IDs to add or remove. These must be valid Action IDs from the Actions table.

    actionLimits?: Record<string, number>

    Optional execution limits for actions being added. Maps action IDs to their maximum executions per agent run. Only applies when mode is 'add'. Ignored for 'remove' mode.

    const change: ActionChange = {
      scope: 'global',
      mode: 'add',
      actionIds: ['search-action-id', 'email-action-id'],
      actionLimits: {
        'search-action-id': 10,    // Max 10 searches per run
        'email-action-id': 5       // Max 5 emails per run
      }
    };
    agentIds?: string[]

    Array of Agent IDs that this change applies to. Required when scope is 'specific', ignored otherwise.

    mode: ActionChangeMode

    Mode of the action change.

    • 'add': Add actions to the agent's available actions
    • 'remove': Remove actions from the agent's available actions
    scope: ActionChangeScope

    Scope of the action change - determines which agents it applies to.

    • 'global': All agents in the hierarchy
    • 'root': Only the root agent
    • 'all-subagents': All sub-agents but not the root
    • 'specific': Only agents listed in agentIds

    Settings

    Member Visibility

    On This Page

    Properties