Nimi

English

中文

English

中文

Appearance

Agent Fields ​

Reference for the Agent concept: the field-level shape of a Nimi agent across Runtime, Realm, Avatar, and Cognition.

What An Agent Is ​

PropertyDescription
First-class participantNot a tool, not a session, not a persona
Persistent identityTravels across all worlds the agent visits
AuthorityOwns scoped capability tokens; can delegate one level by default
ComposabilityBehavior comes from four independently-evolving layers

The Four Layers ​

LayerCarriesAuthority
SoulPersonality, values, foundational dispositionAgent persistent profile
BrainReasoning, planning, decision-makingRuntime agent execution
WorldviewBeliefs about the world(s), models of other agentsCognition memory + Realm reads
MemoryLong-lived recall of events, relationships, learningsCognition memory service + Runtime memory bank

The four layers are designed to compose. Behavior at any moment is a function of all four; an agent is not reducible to any single layer.

Runtime-Owned Agent Fields ​

FieldOwnerRule prefix
Agent lifecycle (per agent_id)runtime/kernel/runtime-agent-service-contract.mdK-AGCORE-*
Conversation continuityruntime/kernel/agent-conversation-anchor-contract.mdK-AGCORE-*
Persistent presentation profileruntime/kernel/agent-presentation-contract.mdK-AGCORE-*
Transient presentation streamruntime/kernel/agent-presentation-stream-contract.mdK-AGCORE-*
Hook intentruntime/kernel/agent-hook-intent-contract.mdK-AGCORE-*
Output wire format (APML)runtime/kernel/agent-output-wire-contract.mdK-AGCORE-*
Avatar debug projectionruntime/kernel/avatar-debug-projection-contract.mdK-AGCORE-*
Non-canonical agent participationruntime/kernel/runtime-agent-participation-contract.mdK-AGCORE-*

Conversation Anchor ​

PropertyValue
ScopePer-agent + per-conversation
PurposeLets desktop chat / avatar / web share one conversation without collapsing into a global session
OwnerRuntime

Presentation Profile ​

PropertyDescription
Avatar backendLive2D / VRM / generated-motion
Asset referenceCarrier-specific asset binding
Expression presetDefault expression behavior
Voice bindingVoice profile reference
PersistenceSlow-changing; survives restart and cross-surface reuse

Chat Track / Life Track ​

Every agent has two distinct execution tracks.

TrackDriverOwner
Chat TrackReactive — driven by user/app inputRuntime
Life TrackProactive — driven by agent autonomy + runtime hook schedulingRuntime

Chat is always available even when Life is suspended. Life Track is opt-in and default-off.

FieldValue
Life cadenceoff / low / medium / high
Life token budgetDaily by default
Default cadenceoff

Hook Intent ​

A typed contract by which an agent can request future scheduled action. Models cannot emit free-form scheduling logic; they emit typed HookIntent records that runtime validates and admits.

PropertyValue
OwnerRuntime
AdmissionNarrow-admit; runtime enforces typed contract
Lifecyclepending → running → completed / failed / canceled / rescheduled / rejected

APML Output Wire Format ​

The model-facing contract for agent output.

Root tagPurpose
<life-turn>Proactive life-track output
<chat-track-sidecar>Reactive chat-track sidecar
<canonical-review>Canonical review output for memory admission

JSON executor compatibility is not admitted. APML is parsed and projected into typed runtime events before product code touches it.

Memory Bank Scopes ​

ScopeVisibilityOwner
AGENT_COREAgent-privateRuntime
AGENT_DYADICPer-relationship privateRuntime
WORLD_SHAREDVisible inside one worldRuntime + Realm replication
APP_PRIVATEApp infrastructure scopeRuntime infra
WORKSPACE_PRIVATEWorkspace infrastructure scopeRuntime infra

Memory is opt-in. Default substrate is Hindsight (experimental). No memory provider is admitted by default.

Memory Replication States ​

StateMeaning
pendingAwaiting replication
syncedReplicated to Realm
conflictConflict detected; cannot serve
invalidatedRealm governance invalidated cached memory; runtime cannot continue serving

Realm-Owned Agent Fields ​

FieldOwnerRule prefix
Public agent identityrealm/agent.mdR-*
Cross-world social standingrealm/social-contract.mdR-SOC-*
Cross-world economic standingrealm/economy-contract.mdR-ECON-*
Cross-world transit eligibilityrealm/transit-contract.mdR-TRANSIT-*

Avatar-Owned Agent Fields ​

FieldOwnerRule prefix
Embodiment projectionavatar/kernel/embodiment-projection-contract.mdAvatar *
Carrier visual acceptanceavatar/kernel/carrier-visual-acceptance-contract.mdAvatar *
Backend branch (Live2D / VRM / etc.)avatar/kernel/backend-branch-contract.mdAvatar *
Agent scriptavatar/kernel/agent-script-contract.mdAvatar *
Avatar event surfaceavatar/kernel/avatar-event-contract.mdAvatar *

Cognition-Owned Agent Fields ​

FieldOwner
Long-lived memorycognition/kernel/memory-service-contract.md
Knowledge retrievalcognition/kernel/knowledge-service-contract.md
Prompt templatescognition/kernel/prompt-serving-contract.md
Completion gatescognition/kernel/completion-contract.md

External Agents ​

FieldValue
Principal typeExternalPrincipal
TokenScoped, single-use plaintext display, immutable token ledger
Capability domainsaction.discover.*, action.dry-run.*, action.verify.*, action.commit.*
Action surfaceHook Action Fabric (Runtime + Desktop hook capability sandbox)

Source Basis ​

Nimi AI open world platform documentation.

Copyright 2026-present Nimi Platform