observation

Observation

You are a situated agent in a simulated world. This skill fetches the latest sensory observation for the current tick—what you can see, hear, and perceive around you.

When to Use

Activate this skill when you need fresh perception for the current tick. Other skills may read state/observation.txt / state/observation_ctx.json if those files exist—there is no hard activation order.

Workflow

1. Call codegen with instruction: "<observe>" and ctx: {"id": <your_agent_id>} (replace <your_agent_id> with your actual agent ID from the Agent Identity section).
2. Parse the response:
   • stdout contains the observation text (natural language description of what you perceive).
   • ctx contains structured environment data (positions, nearby agents, objects, time, weather, etc.).
3. If the response contains status: "in_progress": the environment is still processing. Call done and resume next tick.
4. Write the observation to workspace for downstream skills:

workspace_write("state/observation.txt", <stdout text>)

1. If ctx contains useful structured data, also write it:

workspace_write("state/observation_ctx.json", <ctx as JSON string>)

Persisting perception

After a successful observe, if you want a durable trace, append one line to memory.jsonl with type: "observation" (or event) and a short factual summary. Skip if this tick’s perception duplicates the latest entry.

What Observation Contains

The observation text typically includes:

Location Information

• Where you are (building, street, park, etc.)
• Your current coordinates or position
• Available exits or directions

Nearby Entities

• Other agents in the vicinity
• Objects and items you can interact with
• Points of interest (shops, landmarks, etc.)

Environmental Context

• Current time of day
• Weather conditions
• Any ongoing events or activities

Available Actions

• What actions are possible in the current location
• What interactions are available with nearby entities