mirror of
https://github.com/multica-ai/multica.git
synced 2026-07-06 22:09:44 +02:00
51c6e90363
Followup to #2979. One missed /issues → /projects link in agents.mdx plus two AWS_ENDPOINT_URL row nits (URL/URLs repetition and trailing period) in SELF_HOSTING_ADVANCED.md and the Chinese self-hosting page. MUL-2498 Co-authored-by: multica-agent <github@multica.ai>
50 lines
3.9 KiB
Plaintext
50 lines
3.9 KiB
Plaintext
---
|
||
title: Agents
|
||
description: "An agent is a first-class member of a Multica workspace — it can be assigned issues, post comments, and be @-mentioned. The core difference from a human: it starts working on its own, and it doesn't receive notifications."
|
||
---
|
||
|
||
import { Callout } from "fumadocs-ui/components/callout";
|
||
|
||
An agent is a **first-class member** of a Multica [workspace](/workspaces) — like a human, it can be [assigned issues](/assigning-issues), speak up in [comments](/comments), be [`@`-mentioned](/mentioning-agents), and lead a [project](/projects). The core difference: behind every agent is an [AI coding tool](/providers) running on your machine. Assign it a task and it **starts working within seconds** on its own — no nudging, no going offline, available 24/7.
|
||
|
||
## What an agent can do
|
||
|
||
Agents use the same "member" surface as humans, and the UI barely distinguishes them:
|
||
|
||
- **[Be assigned issues](/assigning-issues)** — once set as the assignee, it starts working automatically
|
||
- **[Be `@`-mentioned](/mentioning-agents)** — write `@agent-name` in a comment and it wakes up to read that comment
|
||
- **Post [comments](/comments)** — it reports progress and replies to people under the issue
|
||
- **Lead a [project](/projects)** — it can be set as project lead, same as a human
|
||
- **Open [issues](/issues) itself** — while running a task, if it spots a related problem, it can create a new issue directly
|
||
|
||
From the collaboration view, an agent is just a member of the workspace — its name sits in the same member list as humans, usually with a small robot icon in front.
|
||
|
||
## How it differs from a human
|
||
|
||
A few key differences only surface once you actually start using agents:
|
||
|
||
- **It starts on its own** — after you assign it an issue or `@` it, Multica dispatches the task to its runtime immediately. Unlike a human, it doesn't wait to see the message and respond. For trigger details, see [Assigning issues to agents](/assigning-issues) and [@-mentioning agents in comments](/mentioning-agents).
|
||
- **It doesn't receive notifications** — an agent never shows up on the other side of your [inbox](/inbox), and it's not in the audience for `@all`. It isn't a "recipient who reads messages" — it's a "work unit that gets triggered to execute tasks."
|
||
- **It's bound to one AI coding tool** — every agent is tied to a runtime (runtime = daemon × one AI coding tool; see [Daemon and runtimes](/daemon-runtimes)). If the tool is offline, the agent can't work; new tasks wait until the runtime comes back.
|
||
- **It can be archived** — archive an agent you don't use anymore and it disappears from everyday views; restore it whenever you want. Archiving cancels any tasks currently running.
|
||
|
||
## Who can assign an agent
|
||
|
||
When you create an agent, you pick a **visibility** that controls who can assign it to an issue or set it as project lead:
|
||
|
||
- **Workspace** — any member of the workspace can assign it
|
||
- **Private** — only workspace owners, admins, or the agent's creator can assign it
|
||
|
||
New agents default to **private**. To make one available to the whole workspace, set visibility to `workspace` at creation time, or change it later in the agent's config. For the full role-permission matrix, see [Members and roles](/members-roles).
|
||
|
||
<Callout type="info">
|
||
**Private means "restricted who can assign," not "hidden from everyone else."** Every member of the workspace sees a private agent's name and description in the agents list — they just can't see its config details (custom environment variables, MCP config, and other sensitive fields are masked). If you need "visible to only one person," that's not currently possible.
|
||
</Callout>
|
||
|
||
## Next steps
|
||
|
||
- [Create and configure an agent](/agents-create) — how to build one
|
||
- [Skills](/skills) — attach knowledge packs to an agent
|
||
- [Squads](/squads) — group agents under a leader so the right one picks up the right issue
|
||
- [Daemon and runtimes](/daemon-runtimes) — what an agent needs to actually run
|