Interface AgentInterface

Agent entity interface

Mirrors macs-node-sdk/lib/ai/models/agent.js. Required on create: name, description. model is an array of Model ObjectIds in priority order.

interface AgentInterface {
    external_id?: string;
    extensors?: { [key: string]: string };
    record_history?: RecordHistory;
    id?: string;
    org?: string;
    user?: string;
    name: string;
    description: string;
    readme?: string;
    image?: string;
    model?: string[];
    system_message?: string;
    max_tokens?: number;
    temperature?: number;
    public?: boolean;
    mia?: boolean;
    forked?: AgentForkedRef;
    featured?: boolean;
    active?: boolean;
    tags?: string[];
    keywords?: string[];
    chat?: any;
    tasks?: any;
    logs?: any;
}

Hierarchy (View Summary)

Properties

external_id?: string

External system identifier for integration with third-party systems

extensors?: { [key: string]: string }

Extended properties for custom integrations

record_history?: RecordHistory

Record history tracking information

id?: string

Unique identifier for the entity

org?: string
user?: string
name: string

Agent name (required, regex [a-zA-Z0-9_-]+)

description: string

One-line description (required)

readme?: string

Markdown README shown on the agent profile

image?: string
model?: string[]

Models in priority order. Defaults to [DEFAULT_LLM_MODEL] when omitted.

system_message?: string

System message injected at the top of every completion

max_tokens?: number

Max output tokens

temperature?: number

Sampling temperature (0–2, default 0)

public?: boolean

Public listing flag

mia?: boolean

Built-in "Mia" assistant flag — set server-side, never by clients

Origin agent if this one was forked

featured?: boolean

Featured listing flag

active?: boolean

Whether the entity is active

tags?: string[]
keywords?: string[]
chat?: any
tasks?: any
logs?: any