docs(character): 推荐工具调用预设#33
Conversation
|
Warning Review limit reached
More reviews will be available in 40 minutes and 49 seconds. Learn how PR review limits work. Your organization has run out of usage credits. Purchase more in the billing tab. ⌛ How to resolve this issue?After more reviews become available, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available. Please see our Fair Usage Limits Policy for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the documentation in docs/ecosystem/other/character.md to recommend the tool call preset and clarify that users can skip the detailed configuration field explanations if they do not plan to deeply customize presets. The review feedback suggests improving the phrasing of these additions to make them more formal, objective, and precise.
| **标准预设**（`default.yml`）要求模型以 XML 文本块输出状态更新、思考过程、操作和消息内容。插件解析模型的纯文本输出来提取各部分。 | ||
|
|
||
| **工具调用预设**（`default-tool-call.yml`）让模型通过工具调用完成状态更新、回复消息等原本依赖 XML 块的操作。由于回复工具的参数说明中已经涵盖了各种等价于输出格式的内容，所以在工具调用预设中，你无需再像标准预设那样自行补充/修改各种输出格式。并且，相关参数说明文本会伴随工具的开关、可用性动态增减，无需手动维护。 | ||
| **工具调用预设（推荐）**（`default-tool-call.yml`）让模型通过工具调用完成状态更新、回复消息等原本依赖 XML 块的操作。由于回复工具的参数说明中已经涵盖了各种等价于输出格式的内容，所以在工具调用预设中，你无需再像标准预设那样自行补充/修改各种输出格式。并且，相关参数说明文本会伴随工具的开关、可用性动态增减，无需手动维护。唯一缺点是，如果你选择的模型工具调用能力比较弱，体验会较差。 |
There was a problem hiding this comment.
“唯一缺点是”和“体验会较差”口语化色彩较浓。建议调整为更书面、客观的表述，例如：\n\nmarkdown\n唯一的缺点是，如果所选模型的工具调用能力较弱，实际体验可能会受到影响。\n
| 整个预设被分为 `name`、`nick_name`、`input`、`system`、`status`、`mute_keyword` 六个核心字段。 | ||
|
|
||
| 让我们一步步来理解这些配置项。 | ||
| 让我们一步步来理解这些配置项（如果你不打算深入研究或大幅度改写预设，可以忽视下方的所有内容）。 |
There was a problem hiding this comment.
“忽视下方的所有内容”表述不够精准。首先，“忽视”带有一定的消极色彩，使用“忽略”或“跳过”更为合适；其次，“下方的所有内容”范围过大，因为后续还有“配置项”等重要章节，这里实际指代的是“详细字段说明”。建议修改为更精确的表述。
| 让我们一步步来理解这些配置项（如果你不打算深入研究或大幅度改写预设，可以忽视下方的所有内容）。 | |
| 让我们一步步来理解这些配置项（如果你不打算深入研究或大幅度改写预设，可以跳过下方的详细字段说明）。 |
1 participant
摘要
校验
git diff --check -- docs/ecosystem/other/character.md