Member Junction
    Preparing search index...

    Details of an action within an agent

    interface AgentActionSpec {
        ActionID: string;
        AgentActionID: string;
        CompactLength?: number;
        CompactMode?: "AI Summary" | "First N Chars";
        CompactPromptID?: string;
        MaxExecutionsPerRun?: number;
        ResultExpirationMode?: "Compact" | "None" | "Remove";
        ResultExpirationTurns?: number;
        Status: "Active" | "Pending" | "Revoked";
    }
    Index

    Properties

    ActionID: string

    The unique ID of the Action that this agent action maps to

    AgentActionID: string

    The unique ID of the AIAgentAction record in the database

    CompactLength?: number

    Number of characters to keep when CompactMode=FirstNChars. Required when CompactMode is FirstNChars, ignored otherwise.

    CompactMode?: "AI Summary" | "First N Chars"

    How to compact results when ResultExpirationMode=Compact: FirstNChars (truncate to CompactLength characters, fast and free), AISummary (use LLM to intelligently summarize with CompactPromptID or Action.DefaultCompactPromptID).

    CompactPromptID?: string

    Optional override for AI summarization prompt when CompactMode=AISummary. Lookup hierarchy: this field -> Action.DefaultCompactPromptID -> system default. Allows agent-specific summarization focus (e.g., technical vs. marketing perspective).

    MaxExecutionsPerRun?: number

    Maximum number of times this action can be executed per agent run

    ResultExpirationMode?: "Compact" | "None" | "Remove"

    How to handle expired action results: None (no expiration, default), Remove (delete message entirely), Compact (reduce size via CompactMode while preserving key information).

    ResultExpirationTurns?: number

    Description: Number of conversation turns before action results expire from conversation context. NULL = never expire (default). 0 = expire immediately after next turn.

    Status: "Active" | "Pending" | "Revoked"

    Status of Active means