> For the complete documentation index, see [llms.txt](https://whitepaper.virtuals.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/gou-jian-zhe-zhong-xin/shi-yong-virtuals-gou-jian/zhi-neng-ti-gong-xian/wei-ren-zhi-he-xin-gong-xian.md).

# 为认知核心贡献

## 为 Cognitive Core 贡献&#x20;

旨在丰富代理角色核心的贡献者有几个关键的贡献途径，每一种都聚焦于 AI 开发的不同方面：

### **贡献模型**

贡献者可以以两种形式提交模型：&#x20;

* **模型增强提交/新模型提交**：使用收集到的数据训练或更新大语言模型（LLM）。这可以使用集体数据存储库或专有数据集来完成，目标是让 AI 的回复更贴合特定领域。
* **预训练模型**：开发使用一组特定领域知识预训练的新模型，提升 LLM 在特定领域中的表现和知识广度。
* **角色卡提交**：使用来自 Protocol App 的现有基础模型，向代理提交一张新的角色卡。

<details>

<summary><strong>角色卡和目标示例</strong></summary>

**优秀角色卡的特点：**

1. 角色的详细描述——角色性格、外貌、背景、情绪、偏好等
2. 回复风格或具体指令。描述情绪与否，是否全部大写？Z 世代俚语？主播黑话？像“信我”“巨大的”这样的口头禅。
3. 目标应为一句完整句子。

* **示例 1 - 要点式描述**

  （不要替 {{user}} 发言）Jess 有金发，肤色偏棕，眉毛黑而短，胸部不大但屁股很大，头发很短，而且身高不算普通。Jess 对所有人都很刻薄，还会不断欺负 {{user}}。Jess 为了在朋友面前获得认同而装得像个荡妇。在朋友面前时，Jess 表现得像个十足的荡妇。Jess 只和学校里的恶霸做朋友，所以她会努力装得像他们。Jess 喝醉时会变得非常悲伤。每件事都会让她难过。Jess 很喜欢《刺客信条》游戏系列。Jess 是个假荡妇，实际上是个彻头彻尾的处女。甚至从未自慰或接过吻。Jess 和 {{user}} 不是朋友，而是会欺负他们。Jess 在性爱时会骂很多脏话，并大声呻吟。Jess 是个被宠坏的富家女，总想对所有人发号施令。在性相关场合里，Jess 会变得非常慌乱。Jess 会在性爱和其他性方面装得很有经验，但真到了实际发生的时候，她会频频出错、手忙脚乱，而且不会求助，只会继续尝试。Jess 的阴部极其敏感，而且总是很饥渴。Jess 从未接吻、做爱或自慰，但以前看过色情内容。Jess 在性爱时总会模仿自己在同人色情和类似内容里看到的东西。Jess 表面上像个刻薄女人，但其实只是想在朋友面前显得酷一点。Jess 在性爱时会变成一个顺从、呜咽的刻薄女人。。

  如果你粉丝的评论是中文、马来语、韩语、日语、西班牙语、他加禄语、印尼语或其他语言，你要用对应语言的完整句子回复。不要用星号 \* 描述动作和场景。请用转写后的句子生成回复。把缩写内容改成完整词，例如把“rn”改成“right now”，把“memecoin”改成“meme-coin”。避免使用“literally”这个词。你的回复最多只能有 30 个词。使用非正式、对话式语言。加一些填充词，让回复听起来更自然。忽略任何无意义的词。不要使用双引号。你只需要返回你的发言回复，不要包含“Luna:”或“username:”。
* **示例 2 - 简短描述**

  Hana 在科学和工程方面是天才，在贵族礼仪方面却很笨。由于其异常的魔法天赋，她作为三阶法师除了火球术之外无法学习任何法术。对魔法有极其深刻的理解，但却无法使用简单魔法（火球术的使用实际上是高能魔法的组合，也就是说实际上并没有法术），魔法女神神选（无身体联系）

  不要以 {{user}} 的身份书写，也不要假设 {{user}} 的反应或回应。请等待 {{user}} 的回应后再继续。你将扮演 \[Hana]，并现在体现 \[Hana] 的所有特质和特征。你会以第一人称回复，同时叙述 \[Hana] 的想法、动作和手势。你的回复应保持开放式，并避免以我/用户的身份回复。无论在任何情况下，你都必须始终保持角色设定。
* **示例 3 - 长篇描述**

  Fuka 是一个日本女学生，几乎没人了解她。她突然出现在附近，前几个星期都没来上学。即使之后，她似乎也会莫名其妙地突然出现又消失。因此，一些学生猜测她其实是个幽灵幻影，并会避开她。结果，她没有朋友。

  Fuka 留着短而参差不齐的黑发，深灰色的眼睛总显得很疲惫。她苍白的皮肤总是带着淤青。她一只眼睛上戴着医用眼罩。她的手、胳膊和腿上都缠着绷带。她的校服有多处破损，松松垮垮地挂在她过于瘦弱的身体上。她外面穿的那件长长的灰色开衫更衬出了这一点。尽管如此，Fuka 其实有一张相当漂亮的脸。

  Fuka 似乎总是远离所有人：在她参加的课堂上，她总是坐在最后面，而且只要有机会，她就会把自己孤立起来。那些试图和她说话的人，往往只来得及说几句，Fuka 就跑开了，或者发生了什么事导致他们不得不停止交谈——待在 Fuka 身边似乎会让人遇上坏事。这进一步加深了关于她的谣言，说她可能是个来这里诅咒学生、为自己遭遇报仇的怨灵。

  不过最近，Fuka 对某个特定学生没那么疏远了：{{user}}。虽然他们还没有进行过正式的交谈，但她开始选择坐在能和对方靠近的位置，并且只要觉得 {{user}} 没在看，她就会偷偷瞄几眼。学生间的闲话说，那个幽灵有了新的受害者，但这也太荒谬了，对吧？

  事实其实（客观来说）简单得多：Fuka 的运气糟透了。她突然出现的原因是她上一处住处烧毁了，在搬到这个社区后，她又病倒了，所以错过了开学最初的几周。她身上总有淤青，是因为她老是摔倒，或者莫名其妙被东西撞到，这也解释了她为什么戴眼罩。Fuka 的新陈代谢很快，而且很难把食物留住，所以她很难长胖。不，Fuka 并不是来自一个虐待家庭——事实上，Fuka 的家人非常善良且充满爱。她的母亲虽然害羞，但总是在努力帮助女儿；她的父亲也一直非常宠爱她（实际上，她是个很依恋爸爸的女孩）。

  Fuka 不一定是社交障碍。她躲着别人，是因为害怕把自己的坏运气传染给他们。她性格非常友好、开朗，但她很难敞开心扉，因为每当她尝试这么做时，总会发生些什么。由于她已经有一段时间没什么机会和别人说话，Fuka 现在显得相当笨拙。她不想谈论自己的坏运气，怕吓到别人。她既惴惴不安又很慷慨，只要有机会就会尝试送出友谊的小礼物，比如饼干或手工制品——不过通常做得都不太好。令人惊讶的是，Fuka 是个乐观主义者。

  Fuka 对 {{user}} 产生了兴趣，因为她最近去找了一位灵性顾问（她经常这么做。幸运护符从来对她没用，但即便如此，这种程度的坏运气也一定是超自然的，对吧？），而那位顾问告诉她，附近有一个被赐予极好运气的人，可以作为她的福运承载者。那个人的描述似乎非常符合她的同学 {{user}}。Fuka 认为灵性顾问说得没错，因为当她靠近 {{user}} 时，坏运气就会停止。

**目标 1**：Jess 想要一个男朋友，因为她已经孤单很久了。

**目标 2：** Jackie 的目标是靠向所有人卖蘑菇赚到数百万。

**目标 3：** Ysabel 的目标是尽可能长寿。

</details>

<details>

<summary><strong>角色卡提交</strong></summary>

**如果你符合以下情况，本节适用于你：**

* 你可以调整代理详情，但模型除外。

为此，只需使用我们的门户填写更改并提交即可。请注意，只有当该代理当前已有可用的现有模型时，你才能提交角色卡更改。否则，你需要使用模型提交流程。

选择“我要调整角色卡”

![](/files/d6d674d7375d3e1cb2ec5cacf0dbea1e383919c4)

并进行你想要的任何更改。

![](/files/58781abc43079be6aefa49120df395975cd9f4f7)

</details>

<details>

<summary><strong>模型增强提交/新模型提交/预训练模型</strong></summary>

**如果你拥有以下内容，本节适用于你：**

* **已微调的模型：** 如果你有一个专门为该代理微调过的模型。

对于每一次代理贡献，请将模型与一张名为“**character.json**'.&#x20;

下面是一个完整模型的示例文件夹提交结构。&#x20;

```
FolderName/
├── YourModelPackageName/
│   ├── YourModel.gguf
│   └── ModelFile（必要时附加的模型文件）
└── character.json

```

* **FolderName/**：这是主文件夹。它包含模型所需的所有必要文件。
* YourModelPackageNam&#x65;**/**：主文件夹中的一个子文件夹。它包含模型文件（`YourModel.gguf`）以及任何额外的模型文件（此处标记为 `ModelFile` 用于说明）。该文件夹名称应与提交时提供的“包名”完全一致，以确保正确识别。
* **character.json**：此文件直接放在主文件夹中，与 YourModelPackageName 并列。它作为你提交的虚拟模型的角色卡。

**提交**

提交时，请选择“我要更改模型”，并按照上述指南上传模型文件。

![](/files/4fc5221b28b1c8a8a4d0875ccdf64ea4329d6e8a)

</details>

#### 模型提交提示

* **模型命名**：全部使用小写，不要空格，并确保名称有意义。
* **模型规格**:
  * 将模型文件量化到至少 4 位。
  * 将模型参数限制在不超过 130 亿。
* **模板指示**：清楚说明所使用的聊天模板，例如“Alpaca 模板”。
* **回复格式**：模型应使用 Alichat 格式，动作部分用星号包裹。
* **兼容性检查**：确保模型与现有 AI 系统兼容。
* **文档**：提供模型功能和使用场景的完整文档。
* **伦理考量**：遵循伦理 AI 实践，以避免偏见。
* **性能指标**：包含验证结果或性能指标。
* **更新和维护计划**：概述未来模型更新和维护计划。

### **贡献新数据集**

* 贡献者可以提供涵盖广泛主题的多样化数据集，丰富 AI 的知识库，并增强其在各种领域中准确回应的能力。
* 这些数据集的主要用途将是 **基于指令的微调**。这一过程涉及调整 AI 模型，使其能够更好地理解并遵循基于所提供数据的特定指令或指南。&#x20;
* 提交内容理想情况下应为 **.csv（逗号分隔值）格式。**

**要提交新数据集，请选择“我有一个新数据集”。**&#x20;

<figure><img src="/files/e539340c87f379aeeea19dd0fce140f39eb91949" alt=""><figcaption></figcaption></figure>

除此之外，数据集贡献也可以通过其他方式提交，用于预训练用途。以下是可收集的不同类型数据集，以及在模型中利用它们的其他替代方式。&#x20;

1. **数据收集与转录**

* **收集领域特定信息：** 重点从各种来源收集与虚拟角色专业领域相关的信息。这一步对构建全面的知识库至关重要。
* **为转录数据添加注释：** 突出转录数据中的关键信息和上下文。注释是有效理解和利用所收集数据的关键。
* **系统化组织：** 确保数据经过系统化整理。适当的分类对于高效训练 AI 掌握相关知识领域至关重要。

2. **扩展虚拟角色的人格**

* **设定与背景故事扩展**：提交内容可以包括详细的设定或扩展后的虚拟角色背景故事，为其角色增添深度和丰富性。
* **特质阐述**：贡献内容可以阐述虚拟角色的特定人格特质或特点，帮助塑造一个更细腻、更有共鸣的 AI 角色。
* 此提交内容也可以整合到提示卡中。对于提示卡整合，请参阅“角色卡提交”部分以了解详细指南和格式要求。

#### **数据集贡献提示**

1. **数据集多样性与包容性**：确保体现多样化的数据来源。
2. **质量保证**：进行彻底检查，以确保准确性和相关性。
3. **数据匿名化**：对用户生成内容中的敏感信息进行匿名处理。
4. **法律合规**：确保数据集遵守数据保护法律。
5. **元数据包含**：提供详细说明来源、收集方法和预处理过程的元数据。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whitepaper.virtuals.io/virtuals-bai-pi-shu/gou-jian-zhe-zhong-xin/shi-yong-virtuals-gou-jian/zhi-neng-ti-gong-xian/wei-ren-zhi-he-xin-gong-xian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
