安装、登录与初始化项目¶
安装¶
打开终端,运行对应系统的命令。安装过程不显示进度,完成后新开一个终端窗口验证。
macOS / Linux / WSL:
Windows PowerShell(提示符显示 PS C:\):
Windows CMD(提示符显示 C:\,没有 PS):
如果 PowerShell 里提示
The token '&&' is not a valid statement separator,说明你在 PowerShell 里用了 CMD 命令;如果 CMD 里提示'irm' is not recognized,说明你在 CMD 里用了 PowerShell 命令。
安装完成后,打开一个新终端窗口,验证安装是否成功:
该命令会打印一个版本号
登录¶
进到你想存放 Agent 项目的位置,启动 DevKit:
在 project ▸ 里输入:
浏览器跳转网页登录,完成后回到 Trismind,提示登录成功,账号绑定到本机。
初始化项目¶
在 project ▸ 里输入:
进入向导后先选模板,一般选 full 即可。
| 模板 | 会生成 | 适用场景 |
|---|---|---|
| minimal | config.yaml + trismind/ + test/ + workspace/ |
只要一个可调用的 Agent,不要 skill / tool / prompt / node |
| full | minimal 全部 + skills/ tools/ prompts/ knowledge/ |
标准 Agent Package,默认选这个 |
| empty | 仅 config.yaml + trismind/ |
空壳,手写一切骨架 |
确认模板后,DevKit 在当前目录生成骨架。
项目目录树¶
Agent 的搭建就是完善这棵目录树里各类资源页。初始化后(full 模板)大致如下:
travel-guide/
├── trismind/
│ ├── config.yaml # 主配置,含 metadata(产品名片)
│ └── policy.yaml # 权限治理
├── prompts/
│ ├── system.md # 主 Agent 系统提示
│ └── requirements.md # 主 Agent 需求收集模板
├── skills/
│ └── <skill>/SKILL.md # 进入 skill 页后 new <name> 建
├── tools/
│ ├── <tool>/tool.py + tool.yaml
│ └── mcp/<name>/config.yaml # MCP 服务配置
├── knowledge/
│ └── retrieval.yaml # 检索配置
├── nodes/
│ └── <id>/node.yaml # 子 Agent 定义
├── workflows/
│ └── <id>.yaml # Workflow 定义
└── test/
└── *.test.yaml
每类资源页的字段与写法见 第 4 章 CLI 命令 与 资源页总目录。
下一章 3.2 设计 Agent:真正写 prompts、skills、tools、nodes、workflows 之前,先想清楚职责拆解。