Skip to main content
A person describes someone your agent can interact with through the world’s tools. The person’s accounts must already exist in the selected starter data. Saving a person does not create a real account or start an agent.

​
Write the people file

Save this as people.yaml:
The file is an array of person definitions. Do not wrap it in people:. JSON arrays work too. $slack_laura names an account in the Slack starter data; it is not the person’s ref.

​
Create and inspect the world

The result includes the world’s id, revision, pinned tool configuration and people. Use the returned ID to inspect the saved definition:
Use --definition configuration.json instead of --tools slack to select a pinned sandbox configuration. --people works with either option. It does not configure the model that generates people’s replies. When a reply needs a model and none is available, the world reports the missing model. Ancha rejects malformed files, unknown person fields, duplicate refs and accounts absent from the world’s data before saving. An empty array ([]) creates a world without people.

​
Change people later

Save a world patch as patch.yaml:
Unlike the creation flag’s array, the update file is an object with a people field. Pass the revision shown by world show:
The update creates a new revision. Existing tests and past runs keep their pinned definitions. Set people: [] in the patch to remove people from the new revision. See Worlds for dataset refs and revisions, and ancha world for the command reference.