Member Junction
    Preparing search index...

    Interface MJApplicationEntity_IAgentSettings

    App-scoped agent configuration.

    Stored as a JSON object in the AgentSettings column of the Applications entity. CodeGen emits a strongly-typed AgentSettingsObject accessor on ApplicationEntity that returns MJApplicationEntity_IAgentSettings | null.

    Read by the conversations default-agent resolver (for the app's default/lead agent) and by the realtime co-agent cascade (relevant agents, app-scoped client tools, and realtime persona/disclosure overrides). Every field is optional — an app opts into exactly what it needs.

    Disclosure values ('silent' | 'mention' | 'hand-voice') mirror the AgentDisclosurePolicy union declared in @memberjunction/ai-core-plus. Keep the two in lockstep.

    interface MJApplicationEntity_IAgentSettings {
        ClientTools?: {
            ClientToolDefinitionID?: string;
            Name?: string;
            Priority?: number;
        }[];
        DefaultAgentID?: string;
        Realtime?: {
            Disclosure?: "silent"
            | "mention"
            | "hand-voice";
            ModelPreference?: string;
            Persona?: { SpeakingStyle?: string; Tone?: string };
        };
        RelevantAgents?: {
            Advertised?: boolean;
            AgentID: string;
            Disclosure?: "silent"
            | "mention"
            | "hand-voice";
            Label?: string;
        }[];
    }
    Index

    Properties

    ClientTools?: {
        ClientToolDefinitionID?: string;
        Name?: string;
        Priority?: number;
    }[]

    App-scoped static client tools, by tool-definition reference. Surfaced to every agent acting in this app and resolved by the unified client-tool resolver.

    Type Declaration

    • OptionalClientToolDefinitionID?: string

      References MJ: AI Client Tool Definitions by ID (preferred) or Name.

    • OptionalName?: string
    • OptionalPriority?: number

      Optional app-level priority for first-match-wins resolution.

    DefaultAgentID?: string

    The app's default/lead agent (conversational default AND realtime lead identity). Agent ID.

    Realtime?: {
        Disclosure?: "silent" | "mention" | "hand-voice";
        ModelPreference?: string;
        Persona?: { SpeakingStyle?: string; Tone?: string };
    }

    Realtime co-agent overrides that layer into the config cascade above the agent's own TypeConfiguration (and below runtime overrides). Only keys set here override; unset keys fall through to the agent / type defaults.

    Type Declaration

    • OptionalDisclosure?: "silent" | "mention" | "hand-voice"

      Default delegation disclosure for this app's co-agent.

    • OptionalModelPreference?: string

      Model preference override (AI Models Name or ID).

    • OptionalPersona?: { SpeakingStyle?: string; Tone?: string }

      Persona override folded into the session system prompt at mint.

    RelevantAgents?: {
        Advertised?: boolean;
        AgentID: string;
        Disclosure?: "silent" | "mention" | "hand-voice";
        Label?: string;
    }[]

    Agents relevant to this app — the static allowed-target set for the co-agent. Union-accumulated at runtime with agent-type defaults and dynamic (channel) registrations.

    Type Declaration

    • OptionalAdvertised?: boolean

      If true, surfaced in pickers / proactively offered; if false, available but not advertised.

    • AgentID: string

      Agent ID (loop or flow — transparent to the co-agent).

    • OptionalDisclosure?: "silent" | "mention" | "hand-voice"

      Per-target disclosure override; falls back to the effective default disclosure.

    • OptionalLabel?: string

      Optional friendly label for the capability manifest / disclosure ("Skip", "Query Builder").