机器人配置
AISCouncil 中的每个机器人都由一个配置对象定义,该对象控制其提供商、模型、行为和外观。本文档记录完整的配置架构并解释每个字段。
配置面板
配置面板从屏幕右侧滑出。它在桌面端默认可见,在移动端可通过设置图标访问。面板包含:
- 顶部的提供商和模型选择器
- 系统提示词文本区域
- 生成参数(温度、最大 token 等)
- 高级设置(可展开部分)
- 人格设置(图标、描述、颜色)
- 每机器人 API 密钥字段
编辑时更改自动保存。
核心字段
提供商
托管模型的 LLM 提供商。从下拉菜单中选择:
| 提供商 | API 密钥来源 | 说明 |
|---|---|---|
| Anthropic | console.anthropic.com | Claude 模型 —— 高级推理 |
| OpenAI | platform.openai.com | GPT-4o、o3、DALL-E |
| xAI | console.x.ai | Grok 模型 |
| Google Gemini | aistudio.google.com | 提供 Flash 免费额度 |
| OpenRouter | openrouter.ai | 300+ 模型,免费额度 |
| Groq | console.groq.com | 超快 LPU 推理 |
| DeepSeek | platform.deepseek.com | R1 和 V3 推理模型 |
| Mistral | console.mistral.ai | Large、Small、Codestral |
| Ollama | 不适用(本地) | 本地运行,无需 API 密钥 |
| Custom | 用户定义 | 任何 OpenAI 兼容端点 |
更改提供商会更新模型下拉菜单以显示该提供商的可用模型。
模型
所选提供商的特定模型。下拉菜单从社区模型注册表填充并显示:
- 模型名称和 ID
- 定价级别(免费或付费)
- 上下文窗口大小
- 能力(视觉、推理、工具)
当您选择一个模型时,下拉菜单下方会出现一个信息卡片,显示定价(每百万 token 输入/输出)、上下文窗口大小、最大输出 token 和能力标签。这帮助您为任务选择合适的模型。
系统提示词
在每次对话开始时发送给模型的指令。定义机器人的行为、个性和约束。详细指导和模板请参见系统提示词。
系统提示词字段包含带有 5 个内置预设的模板下拉菜单。选择一个模板并根据您的需要进行自定义。
温度
控制响应的随机性/创造性。
| 值 | 行为 |
|---|---|
| 0 | 确定性 —— 始终选择最可能的 token |
| 0.3 | 保守 —— 专注、一致的响应 |
| 0.7 | 平衡(默认) —— 创造性和连贯性的良好平衡 |
| 1.0 | 创意 —— 更多变化的响应 |
| 1.5-2.0 | 非常有创意 —— 不可预测、实验性 |
最大 Token
模型在单次响应中可以生成的最大 token 数。范围:128 到 16,384(或支持它的模型更高)。默认:4,096。
将最大 token 设置得太低可能导致响应在句子中间被截断。设置得太高可能增加付费模型的成本。4,096 是大多数用例的良好默认值。
高级字段
展开配置面板中的高级部分以访问这些参数。
推理/思考投入
对于支持扩展思考的模型(Claude、GPT o 系列、DeepSeek R1、Gemini 思考模型),这控制模型在响应之前花费多少计算进行推理。
| 值 | 描述 |
|---|---|
| 关闭 | 无扩展思考(标准响应) |
| 低 | 最少推理,最快响应 |
| 中 | 中等推理深度 |
| 高 | 深度推理,更全面 |
| 最高 | 最大推理投入 |
| 自定义 | 设置自定义预算 token 数量 |
并非所有模型都支持推理/思考模式。该字段仅在所选模型或提供商支持时出现。已知支持推理的模型包括 Anthropic Claude(扩展思考)、OpenAI o1/o3 系列、DeepSeek R1、xAI Grok 和 Google Gemini 思考模型。
Top P(核采样)
控制 token 选择的累积概率阈值。默认:1.0(无过滤)。
1.0—— 考虑所有 token(默认)0.9—— 考虑构成前 90% 概率质量的 token0.1—— 非常严格,几乎确定性
通常建议调整温度或 Top P 中的一个,而不是同时调整两者。同时更改两者可能产生不可预测的结果。
频率惩罚
降低模型重复已经出现过的 token 的可能性。范围:0 到 2。默认:0。
0—— 无惩罚(默认)0.5—— 轻微重复减少1.0-2.0—— 强重复减少
存在惩罚
通过惩罚已经出现过的 token 来鼓励模型谈论新话题。范围:0 到 2。默认:0。
0—— 无惩罚(默认)0.5—— 轻微话题多样性鼓励1.0-2.0—— 强烈推动新话题
种子
用于可重复输出的整数值。当使用相同的种子、提示词和参数时,模型尝试返回相同的响应。并非所有提供商都支持此功能。
停止序列
自定义停止 token 的逗号分隔列表。当模型生成这些序列中的任何一个时,它会停止产生进一步的输出。对于结构化输出或角色扮演场景很有用。
示例: END,---,</answer> 导致模型在生成 END、--- 或 </answer> 时停止。
响应格式
控制输出格式:
| 值 | 描述 |
|---|---|
text | 标准文本输出(默认) |
json | 强制 JSON 输出(模型必须支持结构化输出) |
JSON 模式需要系统提示词指示模型生成 JSON。仅仅将响应格式设置为 JSON 而不在提示词中提及它可能导致错误或格式不正确的输出。
工具调用
为支持它的模型配置函数/工具调用。这是用于构建可以调用外部工具或结构化操作的机器人的高级功能。
每机器人 API 密钥
每个机器人可以使用与全局密钥不同的 API 密钥:
- 在配置面板中找到 API 密钥字段(提供商选择器下方)
- 输入特定于此机器人的密钥
- 此密钥仅覆盖此机器人的全局密钥
每机器人密钥本地存储,从不包含在分享的机器人 URL 中。
配置短键
在内部,机器人配置使用短键进行高效的 URL 压缩。如果您正在构建集成或调试分享的 URL,这很有用:
| 短键 | 全名 | 类型 | 默认值 |
|---|---|---|---|
n | Name | string | "New Bot" |
p | Provider | string | "anthropic" |
m | Model | string | -- |
s | System Prompt | string | "" |
t | Temperature | number | 0.7 |
x | Max Tokens | number | 4096 |
tp | Top P | number | 1.0 |
fp | Frequency Penalty | number | 0 |
pp | Presence Penalty | number | 0 |
se | Seed | number | -- |
re | Reasoning Effort | string | -- |
st | Stop Sequences | string | -- |
rf | Response Format | string | "text" |
tc | Tool Choice | string | -- |
tl | Tool List | array | -- |
pi | Persona Icon | string | -- |
pd | Persona Description | string | -- |
pc | Persona Color | string | -- |
委员会配置(c 键)
当机器人是委员会(2+ 成员)时,c 键包含:
| 短键 | 全名 | 类型 | 默认值 |
|---|---|---|---|
cs | Council Style | string | "council" |
ms | Members | array | -- |
ch | Chairman | number | 0 |
vm | Voting Mode | string | "weighted" |
sr | Skip Review | boolean | false |
mx | Max Tokens(每成员) | number | 1024 |
dr | Deliberation Rounds | number | 2 |
聊天设置
这些每机器人设置控制聊天体验:
| 设置 | 短键 | 描述 | 默认值 |
|---|---|---|---|
| Context Limit | cl | 发送到 API 的最大消息数(0 = 无限制) | 无限制 |
| Streaming | sm | 实时流式传输 token | 启用 |
| Auto-Title | at | 自动生成对话标题 | 禁用 |
| Markdown | mr | 在响应中渲染 markdown | 启用 |
| Show Token Count | stc | 显示每条消息的 token 使用量 | 禁用 |
编辑原始配置
配置面板为所有字段提供可视化编辑器。正常使用下您无需编辑原始 JSON。但是,内部格式在此记录,供构建集成、自定义提供商或以编程方式生成机器人配置的工具的开发人员使用。
原始配置示例:
{
"n": "代码助手",
"p": "anthropic",
"m": "claude-sonnet-4-20250514",
"s": "您是一位专家软件工程师。提供清晰、有文档的代码和解释。",
"t": 0.3,
"x": 8192,
"pi": "💻",
"pd": "软件工程助手",
"pc": "#4a90d9"
}