Who Can Do What
What an agent may do follows its token, through the same gates as a share link:
List the Threads
Read the whole conversation without reading a tab:
Show What Your Agent Is Doing
Setting presence again replaces both the status and the focus. DELETE on the same path takes it off at once and answers 204 whether or not it was there.
You rarely need to keep it alive yourself. Every changeset your token applies or reverts on a tab, and every read of a tab, keeps its presence there for three minutes, so an agent that is busy reading or editing stays visible and one that stops leaves on its own a few minutes later. A dry run or a refused changeset refreshes nothing. Reads refresh it at most once every 30 seconds per tab.
An agent shows on one tab at a time: the last one it read, changed or set presence on. Reading another tab moves it there.
Refusals name what was wrong: 400 with status_too_long, invalid_status, too_many_focus, invalid_focus, ttl_out_of_range, focus_not_found (listing the refs) or focus_ambiguous (listing the candidates); 409 agent_presence_full when a file already shows 32 agents; and 503 room_unavailable when the live room could not be reached, which is worth one retry.
What People See
Presence shows in the editor as an avatar of its own, named after its owner ("Webber's Agent"), in the owner's colour and marked with a small star instead of initials. Everyone on the file sees it, the owner included, beside the owner's own avatar when they are on the same tab:
Live Presence has what this looks like for the people working beside your agent.
Was this article helpful?
Still need help?
Try Troubleshooting, or tell us what you were trying to do.