mirror of
https://github.com/multica-ai/multica.git
synced 2026-08-02 18:13:27 +02:00
docs(chat): correct the chat sandbox description (MUL-5287) (#5956)
The Chat docs claimed agents in a chat are fully sandboxed and cannot see or change issues (`multica issue list` returns empty, issue API calls blocked by permission checks). That is not what the server enforces: a chat run is dispatched with the same owner-scoped, workspace-bound task token as an issue run, and /api/issues is guarded only by workspace membership — no chat-origin check. So a chat agent can run `multica issue create`/`list` and operate on the workspace when explicitly asked (creator recorded as the agent), matching the report in GH #5917. Reframe the section around the real boundary: chat isolation is about context and privacy, not permissions. The genuinely-true guarantees are preserved (private transcript, no issue context in the prompt, no auto-promotion of chat content into issues); the false 'cannot see/change issues / fully sandboxed' claims are corrected. Updated en/zh/ja/ko. Co-authored-by: Bohan-J <bohan@devv.ai> Co-authored-by: multica-agent <github@multica.ai>
This commit is contained in:
Bohan Jiang
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: チャット
|
||||
description: どのイシューにも属さない、エージェントとの一対一の会話 — 完全にサンドボックス化されています。エージェントはイシューを見たり変更したりできず、他の誰もこの会話を見ることはできません。
|
||||
description: どのイシューにも属さない、エージェントとの一対一の会話。会話全体は完全に非公開で、エージェントは既定ではイシューのコンテキストを持たず、自動でイシューを作ることもありません — ただし、あなたが明示的に頼めば、あなたのワークスペース権限であなたに代わって操作します。
|
||||
---
|
||||
|
||||
import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
**チャットはあなたと[エージェント](/agents)との一対一の会話です** — [イシュー](/issues)ボードから外に出るものです。エージェントはどのイシューも見られず、どのイシューも変更できず、会話全体は**完全に非公開**です（[ワークスペース](/workspaces)内の他の誰も、admin を含めて、この会話を見ることはできません）。エージェントとアプローチを議論したり、ブレインストーミングをしたり、どのイシューにも属さない質問をしたりするのに適しています。
|
||||
**チャットはあなたと[エージェント](/agents)との一対一の会話です** — [イシュー](/issues)ボードから外に出るものです。エージェントは既定では**イシューのコンテキストを持たず** — あなたのボードを見ておらず、会話を勝手にイシューに変えることもしません — 会話全体は**完全に非公開**です（[ワークスペース](/workspaces)内の他の誰も、admin を含めて、この会話を見ることはできません）。エージェントとアプローチを議論したり、ブレインストーミングをしたり、どのイシューにも属さない質問をしたりするのに適しています。
|
||||
|
||||
## エージェントを @-メンションするだけではだめなのですか？
|
||||
|
||||
[@-メンション](/mentioning-agents)はエージェントをイシューのコンテキスト**の中へ引き入れます** — エージェントはイシューの説明とすべての過去のコメントを読み、イシューを変更できます。チャットはこれを逆転させます。**あなたをイシューの外へ引き出します** — エージェントはこの単一の会話のみを見られ、どのイシューの存在も認識せず、イシューを変更する入口もありません。
|
||||
[@-メンション](/mentioning-agents)はエージェントをイシューのコンテキスト**の中へ引き入れます** — エージェントはイシューの説明とすべての過去のコメントを読み、イシューを変更できます。チャットはこれを逆転させます。**あなたをイシューの外へ引き出します** — エージェントはこの単一の会話だけを見られ、既定ではイシューのコンテキストを持たないため、あなたが明示的に頼まない限り、どのイシューも読んだり操作したりしません。
|
||||
|
||||
2 つの判断基準:
|
||||
|
||||
@@ -22,21 +22,20 @@ import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
## チャットでエージェントができることとできないこと
|
||||
|
||||
エージェントは会話の中で**完全にサンドボックス化された**モードで実行されます。
|
||||
チャットの隔離は**コンテキストとプライバシーに関するものであり、権限に関するものではありません**。会話は非公開で、エージェントは既定ではイシューのコンテキストを持ちませんが、各返信は依然として**あなたのワークスペース権限**で実行され、あなたに代わって、あなたと同じ権限で動きます。したがって、あなたが明示的に頼めば、エージェントは `multica` CLI を使ってあなたのワークスペースを操作でき、イシューの作成や変更も可能です。
|
||||
|
||||
**できること:**
|
||||
|
||||
- 現在のメッセージに含まれる質問に答える
|
||||
- 構成された[スキル](/skills)と MCP を使う
|
||||
- 自身の作業ディレクトリでファイルを読み書きする
|
||||
- イシューコンテキストを必要としない `multica` CLI コマンドを呼び出す（例: 基本的なワークスペース情報の照会）
|
||||
- `multica` CLI コマンドを実行する（**ワークスペースのデータを読み書きするコマンドを含む**）。例えば `multica issue list` はあなたのワークスペースのイシューを返し、イシューを作るよう頼めば `multica issue create` が実行されて実際のイシューが作られます（作成者としてそのエージェントが記録されます）。これらはこのワークスペースにおけるあなたの権限で実行されます。
|
||||
|
||||
**できないこと:**
|
||||
|
||||
- **どのイシューも見ること** — エージェントが受け取るプロンプトにはイシュー ID がなく、`multica issue list` のようなコマンドは空の結果を返します
|
||||
- **どのイシューも変更すること** — イシューコンテキストがなければ、権限チェックによって API 呼び出しがブロックされます
|
||||
- **他の会話を見ること** — 会話は完全に隔離されています
|
||||
- **誰かや任意のエージェントを @-メンションすること** — チャットは他者に通知する経路のない非公開の空間です
|
||||
- **イシューを自動で作成したり自動で表示したりすること** — プロンプトにはイシュー ID がなく、会話の中にタスクらしい内容を認識しても、それ自体は何も作成したり呼び出したりしません。エージェントがイシューに触れるのは、あなたが明示的に頼んだときだけです。
|
||||
- **あなたの他の会話を見ること** — 各実行のプロンプトはこの単一のチャットに限定され、あなたの他のチャットセッションの内容が渡されることはありません。
|
||||
- **このワークスペースやあなたの権限の外に出ること** — 各実行はこのワークスペースに紐づき、あなたとして動くため、他のワークスペースに触れることも、あなた自身のアカウントにできないことを行うこともできません。
|
||||
|
||||
## 複数ターンのコンテキストが保持される仕組み
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: 채팅
|
||||
description: 어떤 이슈에도 속하지 않는, 에이전트와의 일대일 대화 — 완전히 샌드박스화되어 있습니다. 에이전트는 이슈를 보거나 변경할 수 없으며, 다른 누구도 이 대화를 볼 수 없습니다.
|
||||
description: 어떤 이슈에도 속하지 않는, 에이전트와의 일대일 대화. 대화 전체가 완전히 비공개이며, 에이전트는 기본적으로 이슈 컨텍스트를 갖지 않고 이슈를 자동으로 만들지도 않습니다 — 다만 당신이 명시적으로 요청하면 당신의 워크스페이스 권한으로 당신을 대신해 작업합니다.
|
||||
---
|
||||
|
||||
import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
**채팅은 당신과 [에이전트](/agents) 사이의 일대일 대화입니다** — [이슈](/issues) 보드에서 벗어나는 것입니다. 에이전트는 어떤 이슈도 보지 못하고 어떤 이슈도 변경할 수 없으며, 대화 전체가 **완전히 비공개**입니다([워크스페이스](/workspaces) 내의 다른 누구도, admin을 포함해서, 이 대화를 볼 수 없습니다). 에이전트와 접근 방식을 논의하거나, 브레인스토밍을 하거나, 어떤 이슈에도 속하지 않는 질문을 하기에 적합합니다.
|
||||
**채팅은 당신과 [에이전트](/agents) 사이의 일대일 대화입니다** — [이슈](/issues) 보드에서 벗어나는 것입니다. 에이전트는 기본적으로 **이슈 컨텍스트가 없으며** — 당신의 보드를 보고 있지 않고, 대화를 스스로 이슈로 바꾸지도 않습니다 — 대화 전체가 **완전히 비공개**입니다([워크스페이스](/workspaces) 내의 다른 누구도, admin을 포함해서, 이 대화를 볼 수 없습니다). 에이전트와 접근 방식을 논의하거나, 브레인스토밍을 하거나, 어떤 이슈에도 속하지 않는 질문을 하기에 적합합니다.
|
||||
|
||||
## 그냥 에이전트를 @-멘션하면 안 되나요?
|
||||
|
||||
[@-멘션](/mentioning-agents)은 에이전트를 이슈의 컨텍스트 **안으로 끌어들입니다** — 에이전트는 이슈 설명과 모든 과거 댓글을 읽고, 이슈를 변경할 수 있습니다. 채팅은 이를 뒤집습니다. **당신을 이슈 밖으로 끌어냅니다** — 에이전트는 이 단일 대화만 볼 수 있고, 어떤 이슈의 존재도 인지하지 못하며, 이슈를 수정할 진입점도 없습니다.
|
||||
[@-멘션](/mentioning-agents)은 에이전트를 이슈의 컨텍스트 **안으로 끌어들입니다** — 에이전트는 이슈 설명과 모든 과거 댓글을 읽고, 이슈를 변경할 수 있습니다. 채팅은 이를 뒤집습니다. **당신을 이슈 밖으로 끌어냅니다** — 에이전트는 이 단일 대화만 볼 수 있고 기본적으로 이슈 컨텍스트가 없으므로, 당신이 명시적으로 요청하지 않는 한 어떤 이슈도 읽거나 변경하지 않습니다.
|
||||
|
||||
두 가지 판단 기준:
|
||||
|
||||
@@ -22,21 +22,20 @@ import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
## 채팅에서 에이전트가 할 수 있는 일과 할 수 없는 일
|
||||
|
||||
에이전트는 대화 안에서 **완전히 샌드박스화된** 모드로 실행됩니다.
|
||||
채팅의 격리는 **컨텍스트와 프라이버시에 관한 것이지 권한에 관한 것이 아닙니다**. 대화는 비공개이고 에이전트는 기본적으로 이슈 컨텍스트를 갖지 않지만, 각 답장은 여전히 **당신의 워크스페이스 권한**으로 실행되어 당신을 대신해 당신과 동일한 권한으로 동작합니다. 따라서 당신이 명시적으로 요청하면 에이전트는 `multica` CLI로 당신의 워크스페이스를 조작할 수 있으며, 이슈 생성이나 변경도 가능합니다.
|
||||
|
||||
**할 수 있는 일:**
|
||||
|
||||
- 현재 메시지에 담긴 질문에 답하기
|
||||
- 구성된 [스킬](/skills)과 MCP 사용하기
|
||||
- 자신의 작업 디렉터리에서 파일 읽기 및 쓰기
|
||||
- 이슈 컨텍스트가 필요 없는 `multica` CLI 명령 호출하기(예: 기본 워크스페이스 정보 조회)
|
||||
- `multica` CLI 명령 실행하기(**워크스페이스 데이터를 읽거나 변경하는 명령 포함**) — 예를 들어 `multica issue list`는 당신의 워크스페이스 이슈를 반환하고, 이슈를 만들어 달라고 요청하면 `multica issue create`가 실행되어 실제 이슈가 생성됩니다(생성자로 해당 에이전트가 기록됩니다). 이 명령들은 이 워크스페이스에서 당신의 권한으로 실행됩니다.
|
||||
|
||||
**할 수 없는 일:**
|
||||
|
||||
- **어떤 이슈도 보기** — 에이전트가 받는 프롬프트에는 이슈 ID가 없으며, `multica issue list` 같은 명령은 빈 결과를 반환합니다
|
||||
- **어떤 이슈도 변경하기** — 이슈 컨텍스트가 없으면 권한 검사에 의해 API 호출이 차단됩니다
|
||||
- **다른 대화 보기** — 대화는 완전히 격리되어 있습니다
|
||||
- **누구도, 어떤 에이전트도 @-멘션하기** — 채팅은 다른 사람에게 알릴 경로가 없는 비공개 공간입니다
|
||||
- **이슈를 자동으로 생성하거나 자동으로 띄우기** — 프롬프트에는 이슈 ID가 없으며, 대화에서 작업처럼 보이는 내용을 인식하더라도 그 자체로는 아무것도 생성하거나 불러오지 않습니다. 에이전트는 당신이 명시적으로 요청할 때만 이슈를 건드립니다.
|
||||
- **당신의 다른 대화 보기** — 각 실행의 프롬프트는 이 단일 채팅으로 한정되며, 당신의 다른 채팅 세션 내용은 전달되지 않습니다.
|
||||
- **이 워크스페이스나 당신의 권한 밖으로 나가기** — 각 실행은 이 워크스페이스에 묶여 당신으로서 동작하므로, 다른 워크스페이스에 접근하거나 당신 계정으로 할 수 없는 일을 하지 못합니다.
|
||||
|
||||
## 여러 턴에 걸친 컨텍스트가 보존되는 방식
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: Chat
|
||||
description: One-to-one conversation with an agent outside any issue — fully sandboxed. The agent cannot see or change issues, and nobody else can see the conversation.
|
||||
description: One-to-one, fully private conversation with an agent, outside any issue. The agent starts with no issue context and never auto-creates issues — but it acts with your workspace access when you explicitly ask it to.
|
||||
---
|
||||
|
||||
import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
**Chat is a one-to-one conversation between you and an [agent](/agents)** — stepping outside the [issue](/issues) board. The agent sees no issues and cannot change any issue, and the entire conversation is **fully private** (nobody else in the [workspace](/workspaces), including admins, can see it). It fits discussing an approach with an agent, brainstorming, or asking a question that does not belong to any issue.
|
||||
**Chat is a one-to-one conversation between you and an [agent](/agents)** — stepping outside the [issue](/issues) board. The agent starts with **no issue context** — it isn't looking at your board and won't turn the conversation into issues on its own — and the entire conversation is **fully private** (nobody else in the [workspace](/workspaces), including admins, can see it). It fits discussing an approach with an agent, brainstorming, or asking a question that does not belong to any issue.
|
||||
|
||||
## Why not just @-mention the agent?
|
||||
|
||||
[@-mention](/mentioning-agents) **pulls the agent into** an issue's context — it reads the issue description and every historical comment, and it can change the issue. Chat flips this: **it pulls you out of** the issue — the agent only sees this single conversation, has no awareness of any issue, and has no entry point to modify one.
|
||||
[@-mention](/mentioning-agents) **pulls the agent into** an issue's context — it reads the issue description and every historical comment, and it can change the issue. Chat flips this: **it pulls you out of** the issue — the agent sees only this single conversation and starts with no issue context, so it isn't reading or acting on any issue unless you explicitly ask it to.
|
||||
|
||||
Two rules of thumb:
|
||||
|
||||
@@ -22,21 +22,20 @@ Open **Chat** from the sidebar, pick an agent, and start a new conversation. The
|
||||
|
||||
## What an agent can and cannot do in chat
|
||||
|
||||
Agents run in a **fully sandboxed** mode inside a conversation.
|
||||
The isolation in Chat is about **context and privacy, not permissions**. The conversation is private and the agent starts with no issue context — but each reply still runs with **your workspace access**, acting on your behalf with the same permissions you have. So when you explicitly ask, the agent can use the `multica` CLI to act on your workspace, including creating or changing issues.
|
||||
|
||||
**Can do:**
|
||||
|
||||
- Answer the questions in your current message
|
||||
- Use its configured [skills](/skills) and MCP
|
||||
- Read and write files in its own working directory
|
||||
- Call `multica` CLI commands that do not need issue context (for example, querying basic workspace info)
|
||||
- Run `multica` CLI commands, **including ones that read or change workspace data** — for example, `multica issue list` returns your workspace's issues, and asking the agent to file one runs `multica issue create`, producing a real issue recorded with the agent as its creator. These act with your permissions in this workspace.
|
||||
|
||||
**Cannot do:**
|
||||
|
||||
- **See any issue** — the prompt the agent receives has no issue IDs, and commands like `multica issue list` return empty
|
||||
- **Change any issue** — without issue context, API calls are blocked by permission checks
|
||||
- **See other conversations** — conversations are fully isolated
|
||||
- **@-mention anyone or any agent** — chat is a private space with no path to notify others
|
||||
- **Auto-create or auto-surface issues** — the prompt has no issue IDs, and merely recognizing task-shaped content in the conversation does not, on its own, create or pull up anything; the agent only touches issues when you explicitly ask.
|
||||
- **Read your other conversations** — each run's prompt is scoped to this single chat; the contents of your other chat sessions are never given to it.
|
||||
- **Reach outside this workspace or your permissions** — every run is bound to this workspace and acts as you, so it can't touch another workspace or do anything your own account couldn't.
|
||||
|
||||
## How multi-turn context is preserved
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: 对话
|
||||
description: 和智能体一对一独立聊天——完全沙盒，智能体看不到 issue、改不了 issue，也没人能看到你的对话。
|
||||
description: 和智能体一对一独立聊天，整段对话完全私人。智能体默认没有任何 issue 上下文、也不会自动建 issue——但你明确要求时，它会以你的工作区权限代你操作。
|
||||
---
|
||||
|
||||
import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
**对话（Chat）是你和 [智能体](/agents) 的一对一独立沟通**——跳出 [issue](/issues) 看板，智能体看不到任何 issue、也改不了 issue，整段对话**完全私人**（[工作区](/workspaces) 里其他人、包括 admin 都看不到）。适合和智能体讨论方案、做 brainstorming、问一个不属于任何 issue 的问题。
|
||||
**对话（Chat）是你和 [智能体](/agents) 的一对一独立沟通**——跳出 [issue](/issues) 看板。智能体默认**没有任何 issue 上下文**——它不盯着你的看板，也不会自己把对话变成 issue——整段对话**完全私人**（[工作区](/workspaces) 里其他人、包括 admin 都看不到）。适合和智能体讨论方案、做 brainstorming、问一个不属于任何 issue 的问题。
|
||||
|
||||
## 为什么不用 @ 智能体就够
|
||||
|
||||
[@ 提及](/mentioning-agents) 把智能体**拉进** issue 的上下文——它会读 issue 的描述和所有历史评论，也能改 issue。对话反过来：**把你拉出** issue——智能体只看得到这一次对话，不知道 issue 存在，也没有修改 issue 的入口。
|
||||
[@ 提及](/mentioning-agents) 把智能体**拉进** issue 的上下文——它会读 issue 的描述和所有历史评论，也能改 issue。对话反过来：**把你拉出** issue——智能体只看得到这一次对话，默认没有任何 issue 上下文，除非你明确要求，否则它不会去读或改任何 issue。
|
||||
|
||||
两条判据：
|
||||
|
||||
@@ -22,21 +22,20 @@ import { Callout } from "fumadocs-ui/components/callout";
|
||||
|
||||
## 智能体在对话里能做什么、不能做什么
|
||||
|
||||
智能体在对话里跑在**完全沙盒**下。
|
||||
对话的隔离是**上下文和隐私层面的，而不是权限层面的**。对话完全私人、智能体默认也没有任何 issue 上下文——但每次回复仍然带着**你的工作区权限**跑，代你行事、和你有一样的权限。所以只要你明确要求，它就能用 `multica` CLI 操作你的工作区，包括创建或修改 issue。
|
||||
|
||||
**能做的**：
|
||||
|
||||
- 回答你当前消息里提的问题
|
||||
- 使用自己配置的 [skill](/skills) 和 MCP
|
||||
- 在自己的工作目录里读写文件
|
||||
- 调用不需要 issue 上下文的 `multica` CLI 命令（比如查询工作区基本信息）
|
||||
- 调用 `multica` CLI 命令，**包括读取或修改工作区数据的命令**——比如 `multica issue list` 会返回你工作区里的 issue，让它去建一个 issue 就会跑 `multica issue create`、真的建出一个 issue（记录的创建者是这个智能体）。这些都以你在本工作区的权限执行。
|
||||
|
||||
**不能做的**：
|
||||
|
||||
- **看到任何 issue**——智能体收到的提示里没有 issue ID，`multica issue list` 之类命令对它返回空
|
||||
- **改任何 issue**——没有 issue 上下文，API 调用会被权限 check 拦截
|
||||
- **看到别的对话**——对话之间完全隔离
|
||||
- **@ 任何人或智能体**——对话是私人空间，没有通知别人的路径
|
||||
- **自动建 issue 或自动把内容变成 issue**——提示里没有 issue ID，光是识别出对话里像任务的内容，本身不会创建或调出任何东西；只有你明确要求时它才会去动 issue。
|
||||
- **看到你别的对话**——每次执行的提示都只限于这一段对话，你其他对话的内容不会给它。
|
||||
- **越过本工作区或你的权限**——每次执行都绑定在本工作区、以你的身份行事，碰不到别的工作区，也做不了你自己账号做不了的事。
|
||||
|
||||
## 多轮对话怎么保留上下文
|
||||
|
||||
|
||||
Reference in New Issue
Block a user