mirror of
https://github.com/multica-ai/multica.git
synced 2026-07-06 22:09:44 +02:00
bae8a84abd
* feat(agent): add Antigravity runtime backend Adds Google's Antigravity CLI (`agy`) as the 12th supported coding-tool runtime, alongside Claude / Codex / Cursor / Copilot / Gemini / Hermes / Kimi / Kiro / OpenCode / OpenClaw / Pi. The CLI emits plain assistant text on stdout (no structured event stream), so the backend streams stdout line-by-line as `MessageText` events and accumulates the same text as the final `Result.Output`. Session resumption uses `--conversation <id>`; because the conversation UUID is not echoed on stdout, the daemon routes `--log-file` to a temp file and recovers the id from the glog-formatted log lines. MUL-2767 Co-authored-by: multica-agent <github@multica.ai> * fix(agent): correct Antigravity capability contract from Elon review - ModelSelectionSupported now returns false for antigravity. `agy` has no --model flag and antigravityBackend deliberately drops opts.Model, so the UI must render a disabled "Managed by runtime" picker instead of an empty dropdown plus a silently-ignored manual-entry field. Also stop seeding AgentEntry.Model from MULTICA_ANTIGRAVITY_MODEL — the backend would silently ignore it. - Antigravity skills now write to {workDir}/.agents/skills/, the CLI's native workspace path (inherits Gemini CLI's layout per https://antigravity.google/docs/gcli-migration). Previously they went to the .agent_context/skills/ fallback that the CLI doesn't scan. Runtime brief moves antigravity into the native-discovery branch and local_skills.go points the user-level skill root at ~/.gemini/antigravity-cli/skills for Runtime → local skill import. - Doc + UI comment sync: providers matrix / install-agent-runtime / cloud-quickstart / agents-create / tasks (session-resume support) / skills / README all now list Antigravity in the right buckets, and the model-picker / model-dropdown comments cite antigravity (not the stale hermes reference) as the supported=false example. New tests: TestAntigravityModelSelectionUnsupported, TestInjectRuntimeConfigAntigravity (native discovery wording), TestWriteContextFilesAntigravityNativeSkills (.agents/skills/ landing, .agent_context/skills/ NOT written). Co-authored-by: multica-agent <github@multica.ai> * feat(provider-logo): swap inline placeholder for real Antigravity PNG Replaces the hand-drawn planet+arc placeholder with the official asset shipped from Downloads. Stored next to the component; bundlers (Next.js / electron-vite) resolve the PNG import to a URL string at build time. Added a small assets.d.ts so packages/views' tsc accepts PNG / SVG module imports — there was no prior asset usage in this package to register the declaration. --------- Co-authored-by: J <j@multica.ai> Co-authored-by: multica-agent <github@multica.ai>
128 lines
7.2 KiB
Plaintext
128 lines
7.2 KiB
Plaintext
---
|
|
title: Create and configure an agent
|
|
description: The minimum fields to create an agent, plus every optional setting — system instructions, environment variables, visibility, concurrency limit, and archiving.
|
|
---
|
|
|
|
import { Callout } from "fumadocs-ui/components/callout";
|
|
|
|
Creating an [agent](/agents) takes only two things: **a name** and **a choice of [AI coding tool](/providers)**. Everything else is optional — system instructions, model, environment variables, CLI arguments, visibility, concurrency limit — the defaults work fine. Get it running first and tune later; every field can be changed at any time.
|
|
|
|
## Create an agent
|
|
|
|
Prerequisite: you already have at least one supported [AI coding tool](/providers) installed on your machine (Claude Code, Codex, etc.) and a [daemon](/daemon-runtimes) running. If you're not there yet, start with [Cloud quickstart](/cloud-quickstart) or [Self-host quickstart](/self-host-quickstart).
|
|
|
|
Once that's in place, go to the **Agents** page in your workspace and click **+ New**, or use the CLI:
|
|
|
|
```bash
|
|
multica agent create
|
|
```
|
|
|
|
The form has only two required fields: **name** (unique within the workspace) and **runtime** (= pick an AI coding tool). Every other field is covered section by section below.
|
|
|
|
## Pick an AI coding tool
|
|
|
|
Each runtime is backed by a specific AI coding tool. Multica supports 12 of them. The most common choices:
|
|
|
|
| Tool | Good for |
|
|
|---|---|
|
|
| **Claude Code** | Anthropic's official tool, most complete feature set; **best first pick** |
|
|
| **Codex** | OpenAI, the mainstream alternative |
|
|
| **Cursor** | Users in the Cursor editor ecosystem |
|
|
| **Copilot** | Teams leveraging their GitHub account entitlements |
|
|
| **Gemini** | Users in the Google ecosystem |
|
|
|
|
The other seven (Antigravity, Hermes, Kimi, Kiro CLI, OpenCode, Pi, OpenClaw), along with each tool's full capability matrix (session resume, MCP, skill injection path, model selection), are covered in [AI coding tools comparison](/providers).
|
|
|
|
## Writing system instructions
|
|
|
|
**System instructions** (`instructions`) are prepended to every task, telling the agent what role it plays and what rules to follow:
|
|
|
|
```text
|
|
You're a frontend code-review agent. When an issue comes in, read the diff first. Focus only on:
|
|
- Styling issues (tailwind class names, box model)
|
|
- Accessibility (a11y)
|
|
Don't change code — leave suggestions in a comment.
|
|
```
|
|
|
|
When left blank (the default), the agent uses the native behavior of its underlying AI coding tool with no extra constraints.
|
|
|
|
## Picking a model
|
|
|
|
Most AI coding tools support model selection (for example, Claude Code lets you pick between Sonnet and Opus). Leave it blank and the tool's own default is used; pick one explicitly and that's what runs. Each tool's supported models are listed in [AI coding tools comparison](/providers).
|
|
|
|
Changing the model **only applies to new tasks**. Already-dispatched tasks continue with the model that was locked in at dispatch time.
|
|
|
|
## Custom environment variables (custom_env)
|
|
|
|
**Custom environment variables** (`custom_env`) let you inject extra env vars at task execution time — typical uses are API keys or switching the upstream endpoint:
|
|
|
|
```
|
|
ANTHROPIC_API_KEY = sk-...
|
|
ANTHROPIC_BASE_URL = https://my-proxy.example.com
|
|
```
|
|
|
|
System-critical variables cannot be overridden: `PATH`, `HOME`, `USER`, `SHELL`, `TERM`, `CODEX_HOME`, and any key starting with `MULTICA_*` are silently ignored by the daemon (with a warn log — no error).
|
|
|
|
<Callout type="warning">
|
|
**Values in `custom_env` are stored in plaintext in Multica's server database.** Agent list/get responses no longer carry env values at all — only an opaque count. Reading values requires a workspace owner or admin to hit the dedicated, audited `GET /api/agents/{id}/env` endpoint (CLI: `multica agent env get <id>`). Agents running tasks can NOT use their host's owner credentials to reveal env on other agents — the endpoint denies agent-actor sessions.
|
|
|
|
**Don't put high-value secrets in `custom_env`** (production database passwords, root-level tokens, etc.). Use **dedicated, limited-scope credentials** for agents (read-only API keys, single-scope PATs), and rotate them regularly. Database backups and DB audits remain a meaningful exposure surface.
|
|
</Callout>
|
|
|
|
## Custom CLI arguments (custom_args)
|
|
|
|
**Custom CLI arguments** (`custom_args`) is a string array appended one-by-one to the AI coding tool's command line:
|
|
|
|
```json
|
|
["--max-turns", "100", "--append-system-prompt", "always respond in Chinese"]
|
|
```
|
|
|
|
The final command comes out as:
|
|
|
|
```bash
|
|
claude --model <model> --max-turns 100 --append-system-prompt "always respond in Chinese" [...]
|
|
```
|
|
|
|
Arguments are passed as-is, not through a shell (no injection risk), but whether a given flag is recognized is up to the AI coding tool itself — tools differ substantially here.
|
|
|
|
<Callout type="tip">
|
|
`custom_env` and `custom_args` have no hard caps, but in practice **keep each under 10 entries**. Too many makes the command line long, slows startup, and gets harder to maintain.
|
|
</Callout>
|
|
|
|
## Visibility
|
|
|
|
- **Workspace** (`workspace`) — any member of the workspace can assign it
|
|
- **Private** (`private`) — only workspace owners, admins, or the agent's creator can assign it
|
|
|
|
New agents default to `private`.
|
|
|
|
**Private does not mean hidden** — every member sees a private agent's name and description in the list, they just can't read sensitive config (env values never appear in agent list/get responses; MCP config is masked for non-owners). Full meaning in [Agents → Who can assign an agent](/agents#who-can-assign-an-agent).
|
|
|
|
## Concurrency limit
|
|
|
|
**Concurrency limit** (`max_concurrent_tasks`) controls how many tasks this agent can run in parallel at once. The default is **6**. New tasks that hit the cap queue up — they aren't rejected.
|
|
|
|
This is only the "agent layer" of a two-tier limit — the daemon itself enforces a broader cap (default 20), and whichever is tighter wins. Details in [Daemon and runtimes → How many tasks can run in parallel](/daemon-runtimes#how-many-tasks-can-run-in-parallel).
|
|
|
|
Changing this value **does not cancel tasks already running** — it only applies to the next task about to be picked up.
|
|
|
|
## Attaching domain expertise: Skills
|
|
|
|
A created agent can have **Skills** attached — **knowledge packs** (`SKILL.md` + supporting files) automatically delivered to the AI coding tool at task execution time. You can create a new skill, import from GitHub or ClawHub, or scan one from an existing skill directory on your machine. See [Skills](/skills).
|
|
|
|
## Archive and restore
|
|
|
|
Agents you no longer use can be **archived** — they disappear from everyday views, but their historical data (tasks run, comments posted) is fully preserved. **Restore** them anytime to put them back to work.
|
|
|
|
<Callout type="warning">
|
|
**Archiving immediately cancels every unfinished task belonging to the agent** — running, dispatched, and queued tasks are all marked `cancelled` and won't continue. If you have an important task in flight, let it finish before archiving.
|
|
</Callout>
|
|
|
|
Archived agents can't be assigned new tasks.
|
|
|
|
## Next steps
|
|
|
|
- [Skills](/skills) — attach knowledge packs to an agent
|
|
- [AI coding tools comparison](/providers) — full capability matrix across all 12 tools
|
|
- [Assigning issues to agents](/assigning-issues) — put your new agent to work
|