跳到主要内容

机器人配置

AISCouncil 中的每个机器人都由一个配置对象定义,该对象控制其提供商、模型、行为和外观。本文档记录完整的配置架构并解释每个字段。

配置面板

配置面板从屏幕右侧滑出。它在桌面端默认可见,在移动端可通过设置图标访问。面板包含:

  • 顶部的提供商和模型选择器
  • 系统提示词文本区域
  • 生成参数(温度、最大 token 等)
  • 高级设置(可展开部分)
  • 人格设置(图标、描述、颜色)
  • 每机器人 API 密钥字段

编辑时更改自动保存。

核心字段

提供商

托管模型的 LLM 提供商。从下拉菜单中选择:

提供商API 密钥来源说明
Anthropicconsole.anthropic.comClaude 模型 —— 高级推理
OpenAIplatform.openai.comGPT-4o、o3、DALL-E
xAIconsole.x.aiGrok 模型
Google Geminiaistudio.google.com提供 Flash 免费额度
OpenRouteropenrouter.ai300+ 模型,免费额度
Groqconsole.groq.com超快 LPU 推理
DeepSeekplatform.deepseek.comR1 和 V3 推理模型
Mistralconsole.mistral.aiLarge、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% 概率质量的 token
  • 0.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 密钥:

  1. 在配置面板中找到 API 密钥字段(提供商选择器下方)
  2. 输入特定于此机器人的密钥
  3. 此密钥仅覆盖此机器人的全局密钥

每机器人密钥本地存储,从不包含在分享的机器人 URL 中。

配置短键

在内部,机器人配置使用短键进行高效的 URL 压缩。如果您正在构建集成或调试分享的 URL,这很有用:

短键全名类型默认值
nNamestring"New Bot"
pProviderstring"anthropic"
mModelstring--
sSystem Promptstring""
tTemperaturenumber0.7
xMax Tokensnumber4096
tpTop Pnumber1.0
fpFrequency Penaltynumber0
ppPresence Penaltynumber0
seSeednumber--
reReasoning Effortstring--
stStop Sequencesstring--
rfResponse Formatstring"text"
tcTool Choicestring--
tlTool Listarray--
piPersona Iconstring--
pdPersona Descriptionstring--
pcPersona Colorstring--

委员会配置(c 键)

当机器人是委员会(2+ 成员)时,c 键包含:

短键全名类型默认值
csCouncil Stylestring"council"
msMembersarray--
chChairmannumber0
vmVoting Modestring"weighted"
srSkip Reviewbooleanfalse
mxMax Tokens(每成员)number1024
drDeliberation Roundsnumber2

聊天设置

这些每机器人设置控制聊天体验:

设置短键描述默认值
Context Limitcl发送到 API 的最大消息数(0 = 无限制)无限制
Streamingsm实时流式传输 token启用
Auto-Titleat自动生成对话标题禁用
Markdownmr在响应中渲染 markdown启用
Show Token Countstc显示每条消息的 token 使用量禁用

编辑原始配置

配置面板为所有字段提供可视化编辑器。正常使用下您无需编辑原始 JSON。但是,内部格式在此记录,供构建集成、自定义提供商或以编程方式生成机器人配置的工具的开发人员使用。

原始配置示例:

{
"n": "代码助手",
"p": "anthropic",
"m": "claude-sonnet-4-20250514",
"s": "您是一位专家软件工程师。提供清晰、有文档的代码和解释。",
"t": 0.3,
"x": 8192,
"pi": "💻",
"pd": "软件工程助手",
"pc": "#4a90d9"
}