wehub-resource-sync
21a7676d6d
Checks (magui2.0) / python-format (push) Has been cancelled
Checks (magui2.0) / python-lint (push) Has been cancelled
Checks (magui2.0) / python-pyright (push) Has been cancelled
Checks (magui2.0) / python-test (push) Has been cancelled
Checks (magui2.0) / frontend-format (push) Has been cancelled
Checks (magui2.0) / frontend-lint (push) Has been cancelled
Checks (magui2.0) / frontend-typecheck (push) Has been cancelled
Checks (magui2.0) / frontend-test (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
110 lines
5.3 KiB
Markdown
110 lines
5.3 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!NOTE]
|
||
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
|
||
> [English](./README.en.md) · [原始项目](https://github.com/microsoft/magentic-ui) · [上游 README](https://github.com/microsoft/magentic-ui/blob/HEAD/README.md)
|
||
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
|
||
|
||
<p align="center">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="docs/_assets/magentic-lite-logo-dark.png">
|
||
<img src="docs/_assets/magentic-lite-logo-light.png" alt="MagenticLite" width="420">
|
||
</picture>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<em>大任务。小模型。</em>
|
||
</p>
|
||
|
||
---
|
||
|
||
**MagenticLite** 是 Magentic-UI 的下一代版本——一款来自 **Microsoft AI Frontiers** 的智能体（agentic）应用，经过重新设计，以更少的资源完成更多工作。它将适合本地运行的编排模型（[MagenticBrain](https://aka.ms/MagenticBrain-foundry)) with a specialized browser-use model ([Fara](https://aka.ms/fara-foundry)) so you can automate real work without depending on frontier-scale compute.
|
||
|
||
- **专为小模型打造，设计上高效。** 无需沉重算力即可获得强大的智能体性能——不必依赖前沿级大模型。
|
||
- **横跨浏览器与本地文件系统。** 网络调研、表单填写、文件管理——同一工作流内一气呵成。
|
||
- **让你始终参与并掌控全局。** 随时引导、审批或接管。MagenticLite 在执行关键操作前会暂停并征求确认。
|
||
- **安全优先的设计。** 浏览器会话在轻量级 VM 沙箱（[Quicksand](https://microsoft.github.io/quicksand/)) so the agent can't reach the rest of your machine without your say-so.
|
||
|
||
## 亲眼见证
|
||
|
||
点击以下任意任务即可展开，观看 MagenticLite 端到端完成全过程。
|
||
|
||
<details open>
|
||
<summary><b>填写报销表单</b></summary>
|
||
|
||
https://github.com/user-attachments/assets/a982b60d-127e-4310-96e6-9f094dffb7f0
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>查找食谱食材价格</b></summary>
|
||
|
||
https://github.com/user-attachments/assets/7ff87917-752f-4e40-b319-8036e08ab8f9
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>查找并预订餐厅</b></summary>
|
||
|
||
https://github.com/user-attachments/assets/ee5f967e-ee1b-4554-b329-36b56b595aa4
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>整理本地文件</b></summary>
|
||
|
||
https://github.com/user-attachments/assets/aff385dd-f856-4db4-8f26-08fd0f940aa4
|
||
|
||
</details>
|
||
|
||
## 快速开始
|
||
|
||
以下步骤可在 macOS 或 Windows（WSL）上运行。需要更多细节或其他平台？请参阅[安装指南](./docs/installation.md)。
|
||
|
||
### 1. 安装 MagenticLite
|
||
|
||
```bash
|
||
# Create a project directory
|
||
mkdir magentic-lite && cd magentic-lite
|
||
|
||
# Create and activate a virtual environment
|
||
uv venv --python=3.12 --seed .venv
|
||
source .venv/bin/activate
|
||
|
||
# Install the latest 0.2.x release from PyPI
|
||
uv pip install "magentic_ui>=0.2.0"
|
||
```
|
||
|
||
### 2. 运行
|
||
|
||
```bash
|
||
magentic-ui --port 8081
|
||
```
|
||
|
||
打开 <http://127.0.0.1:8081/> 并按照应用内引导连接模型端点。若你尚无可用端点，请参阅[模型托管指南](./docs/model-hosting-guide.md)。
|
||
|
||
> **在找此前的 Magentic-UI 0.1 版本**（针对前沿模型优化）？它位于 [`magentic-ui-0.1`](https://github.com/microsoft/magentic-ui/tree/magentic-ui-0.1) branch。
|
||
|
||
## 文档
|
||
|
||
| 文档 | 内容 |
|
||
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||
| [安装](./docs/installation.md) | 支持的平台、macOS / WSL 前置条件、安装与运行命令 |
|
||
| [从源码构建](./docs/build-from-source.md) | 如何从本仓库克隆运行 MagenticLite（`uv sync`、`pnpm dev` 等） |
|
||
| [模型托管指南](./docs/model-hosting-guide.md) | 搭建模型端点并将 MagenticLite 与之连接的端到端指南 |
|
||
| [配置](./docs/configuration.md) | 沙箱、智能体模式、工具审批，以及完整的 `config.yaml` 示例 |
|
||
| [故障排除](./docs/troubleshooting.md) | 常见错误及修复方法 |
|
||
| [限制](./docs/limitations.md) | MagenticLite 目前尚难胜任的任务与使用模式 |
|
||
| [透明度说明](./docs/TRANSPARENCY_NOTE.md) | 预期用途、负责任使用指引、风险及缓解措施 |
|
||
|
||
## 许可证
|
||
|
||
Microsoft 及其任何贡献者，根据 [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file.
|
||
|
||
Microsoft、Windows、Microsoft Azure 及/或文档中提及的其他 Microsoft 产品与服务，可能是 Microsoft 在美国及/或其他国家/地区的商标或注册商标。本项目的许可并不授予你使用任何 Microsoft 名称、标识或商标的权利。Microsoft 的一般商标使用准则见 <http://go.microsoft.com/fwlink/?LinkID=254653>。
|
||
|
||
任何第三方商标或标识的使用均须遵守相应第三方的政策。
|
||
|
||
隐私信息见 <https://go.microsoft.com/fwlink/?LinkId=521839>。
|
||
|
||
Microsoft 及任何贡献者保留所有其他权利，无论基于其各自的版权、专利或商标，无论通过默示、禁止反言或其他方式。
|