Skip to main content

Update Name

[MODE:DIALOG] Tier: base. Not idempotent.

Renames the current Agent through PATCH /api/agents/:id with name and an optional agent_rename_context payload identifying the conversation that prompted the change.

When to use​

  • First non-trivial Player message — set a meaningful name reflecting current focus.
  • Conversation pivots to a new topic that changes scope (per system.md <your_status>).
  • Agent default name is generic ("agent-42") and Player just gave it a topic.

When NOT to use​

  • During [SYSCHECK] — the system explicitly excludes that.
  • Trivial follow-ups within the same topic.

Inputs​

FieldTypeRequiredNotes
namestringyesNew display name

agent_id is read from FIBE_AGENT_ID env; CONVERSATION_ID env, when set, is forwarded as agent_rename_context.conversation_client_id so Fibe can record which conversation triggered the rename.

Output​

The updated Agent's full JSON.

Gotchas​

  • FIBE_AGENT_ID env required; missing → fail-fast.
  • Name uniqueness is enforced server-side per Player; collisions return VALIDATION_FAILED.
  • Slug-safe characters preferred, but any non-empty string is accepted.
  • The agent_rename_context is informational; it's stored to track who/what renamed the agent. Without CONVERSATION_ID env, just the bare rename happens.
  • fibe_resource_mutate(resource:"agent", operation:"update") — non-self updates and other field changes.
  • fibe_doctor — pre-flight check that you have an Agent identity.