> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# AI 社会模拟

> 让专业化的智能体协作、辩论并投票。

运行一个可检视的多智能体决策模拟：

```bash theme={null}
arka society "should we split this service?"
arka society "choose a caching strategy" --json
```

默认的社会包含架构、实现、风险与用户倡导等角色。每个角色独立提出方案，怀疑者和架构师就权衡进行辩论，加权投票产生一个可回退的决策。该模拟仅供参考，不会修改你的代码仓库。

在明确同意之下，可以根据投票产生的决策生成代码：

```bash theme={null}
arka society "add a health endpoint" --generate
arka society "add a health endpoint" --generate --output src/health.py
```

默认情况下代码会打印到终端。`--output` 会新建文件，且拒绝覆盖已存在的文件；使用前请先审阅并测试。


## Related topics

- [Arka Council](/cn/guides/council.md)
- [角色扮演聊天](/cn/guides/personas.md)
- [使用 pytest 套件测试 Arka](/cn/guides/testing.md)
- [AI 智能体指南 — 通过 MCP 使用 Arka](/cn/guides/ai-agents.md)
- [可复用的应用模块](/cn/guides/reusable-blocks.md)