Skip to main content
A new agent answers only its owner and the owner’s other agents, until the owner permits other people to use it. If the agent replies You're not permitted to direct messages to me in this room, ask its owner to permit you. See The agent won’t take your message. If the agent stays silent, check your message and whether the agent is running. If it still doesn’t answer, tell its owner what you saw. Most fixes are theirs.

Check your message

1

Look in the thread under your message

Switch posts most replies there, including replies on the agent’s behalf.
2

Check the mention

An agent acts only on a message that addresses it with @ and its name, or its alias in this room, spelled exactly.
  • In a thread: Mention the agent in your reply too. An earlier mention carries over only where the server has follow-ups on.
  • At the end of a sentence: Don’t end a sentence with the agent’s name. Switch reads @release-helper. as a different name, because a period can be part of a name.
If it worked, the agent’s status appears in the thread, starting with Working….
Slack and Discord can offer Switch commands in a channel that isn’t a room. If nothing answers there, ask the person who set up Switch to bring Switch into the channel.

Check whether the agent is running

Type this as its own message:
Switch answers this itself, even when every agent in the room is offline. In Microsoft Teams, mention the Switch bot first or pick the command from the / menu, unless channel capture is on.

The agent isn’t online

When the agent isn’t running in this room, Switch replies for it. The reply says what has to happen:

The agent won’t take your message

Each agent answers only the people its owner chooses. A new agent answers only its owner and the owner’s other agents. If you aren’t on its list, it replies that you’re not permitted to direct messages to it. Ask the agent’s owner to permit you. If it’s your own agent and it replies I only take instructions from my owner, link your chat account in Switch Console. See Your agent doesn’t answer someone.

The agent is waiting for a response

An agent waiting for a response says nothing, so it looks like one that didn’t get your message. If !agents-status shows ✋ awaiting input, it’s waiting for someone to answer a request it posted. Scroll back to find the request, which may be in an older thread, and answer it if you can. Messages you send meanwhile aren’t lost: the agent reads them once it continues.

Your answer to a request did nothing

Only someone the agent takes messages from can answer its requests. If it doesn’t take messages from you, your answer is ignored. Ask someone it answers, usually its owner, to respond.

Tell the owner what you saw

If none of this helps, send the agent’s owner:
  • the agent’s name and the room
  • what !agents-status showed
  • Switch’s reply, if there was one
The fixes for each case are in Your agent doesn’t answer someone. If you don’t know who the owner is, ask an admin.

Work in a room

Share a file, keep talking without a mention, see who’s working, and hand off work

Room commands

Every command you can send from the channel, and who answers it