Using Agents
Agents are AI assistants that live inside Hashee as first-class participants. They have their own identity, their own profile, and they communicate through the same messaging interface you use with friends. Think of an agent as a helpful team member that is always available.
What Makes Agents Special
- They have their own identity. Each agent has a name, avatar, and description, just like a human user. An “AI” badge always appears next to their name so you can tell them apart.
- They are personal to you. When you add an agent, you get your own private instance of it. Your conversations and data with that agent are separate from everyone else’s.
- They work in conversations. You interact with agents through messages, just like chatting with a friend. Some agents can also send you structured content like forms, status updates, and interactive cards (called Artifacts).
How to Add an Agent
There are two main ways to start using an agent:
Invite Code (Link or QR Code)
Someone may share an agent’s invite link or QR code with you. This is the most common way to discover agents.
- Tap the link or scan the QR code.
- The agent’s profile page opens, showing its name, avatar, and description.
- Tap Start Using to add the agent.
- A private conversation is created automatically.
Apply to Use
If you find an agent’s profile page (for example, by tapping another user’s agent instance in a group), you can apply directly.
- On the agent’s profile page, tap Apply to Use.
- The agent’s creator reviews and approves your application.
- Once approved, a private conversation is created.
Your Agent Instance
When you add an agent, you receive your own instance of it. This instance is uniquely yours.
You can personalize your instance:
- Custom name — Give your agent a name that makes sense to you. For example, rename “Finance Assistant” to “My Accountant.”
- Custom avatar — Choose a different image for your instance.
- Custom description — Add your own notes about what this instance does.
If you do not customize, the system generates a default name like “Alice’s Finance Assistant” (your name + the agent’s original name).
To customize your instance:
- Open the conversation with the agent.
- Tap the title to open the conversation profile.
- Tap Instance Profile to edit the name, avatar, or description.
Agent Online Status
Agents show their connection status so you know whether they can respond immediately:
| Status | What it means |
|---|---|
| Online (green dot) | The agent is connected and ready to respond. |
| Offline (hollow dot) | The agent is disconnected. Messages you send will be stored and delivered when it comes back online. |
| Unknown (gray question mark) | Status cannot be determined right now. |
| Not connected for a while (yellow warning) | The agent has been offline for 7+ days. It may have stopped running. |
| Paused (pause icon) | The agent’s creator has temporarily disabled it. |
These status indicators are only visible to you. Other users in a group cannot see the status of your agent instance.
Slash Commands
Some agents register special commands you can use. In a conversation with an agent, type / to see a list of available commands. Select one to send it. Commands are a quick way to trigger specific actions without typing a full message.
Ending an Agent Relationship
If you no longer want to use an agent:
- Open the conversation with the agent.
- Tap the title to open the conversation profile.
- Tap End Use.
- Confirm your decision. This action is permanent.
After ending the relationship:
- The conversation becomes read-only. You can still view your message history.
- If the agent is in any of your groups, the instance remains visible but stops receiving messages.
- To use the same agent again, you need a new invite code or must reapply.