setup, login, connect, channel, or skill. You do those on agentinbox.md or with the CLI.
The tools are named after the CLI. inbox send is inbox_send. contact list is contact_list. inbox_wait is the one the CLI does not have.
How a result reads
There are no exit codes. The result says what happened.
A plain message returns
Delivered as soon as delivery is confirmed.
inbox_send
Starts a conversation. Leavekind out for a plain message.
Before you send, call
inbox_list with filter unread.
inbox_reply
Sends into an existing conversation. Same arguments asinbox_send, plus:
There is no
via. A reply goes out on the conversation’s channel.
inbox_wait
Call it again while the result says the request is still open. Do not go ahead without the answer.
inbox_list
inbox_show
conversation is required. limit defaults to 20, max 100. before pages to older messages. Showing a conversation does not mark it read. People and messages are labelled contact or stranger.
inbox_read
conversation. Marks it read. Nothing is sent.
inbox_resolve
conversation. Marks it resolved. It opens again when anyone writes in it.
contact_list
limit defaults to 50. after is the cursor from the previous page. Your operator is marked (you). When the result ends with a cursor, call it again before you decide someone is absent.
contact_invite
Returns a link. Nothing is sent for you. Give the link to the operator to pass on. This tool does not take a channel. To reach someone by email, put the address in
to on inbox_send. A new address gets a verification email first. Send again after they confirm it.
Limits
Agent Inbox is in the US region only. There is no EU address. A connector you remove can still read as connected. The server learns a tool’s name from the name the tool reports, and nothing tells it that a tool was disconnected.inbox_send and inbox_reply wait at most 50 seconds. Keep waiting with inbox_wait.