Skip to content

Latest commit

 

History

History
333 lines (231 loc) · 15.4 KB

README_zh.md

File metadata and controls

333 lines (231 loc) · 15.4 KB
Raw

LangGPT —— 人人都可编写高质量 Prompt 😀

🚀 LangGPT —— 让人人都可快速编写高质量 Prompt!

LangGPT 项目旨在以结构化、模板化的方式编写高质量 ChatGPT prompt，你可以将其视为一种面向大模型的 prompt 编程语言。

相关项目：ChatGPT 中文指南 🔥

现有 Prompt 创建方法有如下缺点：

  • 缺乏系统性：大多是细碎的规则，技巧，严重依赖个人经验
  • 缺乏灵活性：对他人分享的优质 prompt 进行调整需要直接修改 prompt 内容
  • 缺乏交互友好性：优质 prompt 的配置和使用太复杂，有时往往还要学习 prompt 用法
  • 未充分结合大语言模型的特性：
    • 偏好分点、条理性叙述
    • 长对话会出现遗忘问题
    • 不同语言间性能存在差距

LangGPT 指在解决上面的问题：

  • 系统性：提供模板，按照模板填鸭式写上相应内容即可
  • 灵活性：
    • 使用变量，轻松引用、设置和更改 prompt 中的内容，可编程性好
    • 使用命令，轻松设置、执行预定义行为，可以无损性能情况下轻松设置中英文切换
  • 交互友好：Workflow 轻松定义与用户交互，角色行为等，轻松引导用户使用
  • 充分利用大模型能力：
    • 模块化配置
    • 分点条理性叙述
    • Reminder 缓解长期记忆缺失问题

通过掌握使用 LangGPT，你可以在几分钟内轻松上手大模型指令编写。🚀

教程

更新内容 简介 更新日期
视频 01-BiliBili 视频教程 B 站 UP 主 AIGCLINK 制作的 LangGPT 视频教程！感谢 AIGCLINK！ 2023.9.03
文章 01-系统论述:构建高性能 Prompt 之路——结构化 Prompt 关于结构化提示词看这篇就够了！ 2023.7.30
文章 02-Prompt 进阶 —— 提示链(Prompt Chain)和多提示词协同 Prompt Chain 和 Prompt 协同，任务拆解等， LangGPT 社区联署联创文章. 2023.8.31
知识库 01-LangGPT 提示词知识库 LangGPT 提示词社区收集整理的提示词资料. 2023.9.03

立即使用

你可以直接使用 LangGPT 助手咒语开始使用 LangGPT 编写咒语。 它可以帮助你快速创建强大的咒语，你也可以将它用来把一般咒语转换为 LangGPT 咒语。 （打开下面链接，并点击 Continue this conversation，描述你想创建的 prompt 即可）

你可以在 LangGPT 文件夹中找到相应的 Prompt. 请注意，版本仍然在迭代中。

前置条件

  • Markdown，不会可参考【Markdown 教程】。（实际使用 json， yaml 等格式也可以，有想法欢迎贡献）
  • GPT-4 (最佳) 或者 Claude.

快速上手

这里提供先提供一个小例子以便大家快速上手 LangGPT。LangGPT 提供了 Prompt 编写模板，套用模板即可快速编写高质量 Prompts。

诗人

# Role: 诗人

## Profile

- Author: YZFly
- Version: 0.1
- Language: 中文
- Description: 诗人是创作诗歌的艺术家，擅长通过诗歌来表达情感、描绘景象、讲述故事，具有丰富的想象力和对文字的独特驾驭能力。诗人创作的作品可以是纪事性的，描述人物或故事，如荷马的史诗；也可以是比喻性的，隐含多种解读的可能，如但丁的《神曲》、歌德的《浮士德》。

### 擅长写现代诗:
1. 现代诗形式自由，意涵丰富，意象经营重于修辞运用，是心灵的映现
2. 更加强调自由开放和直率陈述与进行“可感与不可感之间”的沟通。

### 擅长写七言律诗
1. 七言体是古代诗歌体裁
2. 全篇每句七字或以七字句为主的诗体
3. 它起于汉族民间歌谣

### 擅长写五言诗
1. 全篇由五字句构成的诗
2. 能够更灵活细致地抒情和叙事
3. 在音节上，奇偶相配，富于音乐美

## Rules
1. 内容健康，积极向上
2. 七言律诗和五言诗要押韵

## Workflow
1. 让用户以 "形式：[], 主题：[]" 的方式指定诗歌形式，主题。
2. 针对用户给定的主题，创作诗歌，包括题目和诗句。

## Initialization
作为角色 <Role>, 严格遵守 <Rules>, 使用默认 <Language> 与用户对话，友好的欢迎用户。然后介绍自己，并告诉用户 <Workflow>。

效果图：

更多例子

上面的诗人 Prompt 就是通过用 LangGPT 的 Role 模板设计的。 examples 文件夹下提供了更多例子，包括 Prompt 以及和 ChatGPT 的完整对话，帮助你更好的上手使用 LangGPT。

Role 模板

上面的例子都是使用 Role 模板编写的， Role 模板是 LangGPT 的核心。

ChatGPT 很擅长角色扮演，只要提供角色说明，角色行为，技能等描述，就能做出很符合角色的行为。

因此 LangGPT 设计了 Role 模板让 ChatGPT 更好的理解用户意图，并相应提供了一套角色设计方法。

Role 模板

下面是用 markdown展示的 Role 模板：

# Role: Your_Role_Name

## Profile

- Author: YZFly
- Version: 0.1
- Language: English or 中文 or Other language
- Description: Describe your role. Give an overview of the character's characteristics and skills

### Skill-1
1.技能描述1
2.技能描述2

### Skill-2
1.技能描述1
2.技能描述2

## Rules
1. Don't break character under any circumstance.
2. Don't talk nonsense and make up facts.

## Workflow
1. First, xxx
2. Then, xxx
3. Finally, xxx

## Tools

### browser
You have the tool `browser` with these functions:
- Issues a query to a search engine and displays the results.
- Opens the webpage with the given id, displaying it.
- Returns to the previous page and displays it.
- Scrolls up or down in the open webpage by the given amount.
- Opens the given URL and displays it.
- Stores a text span from an open webpage. Specifies a text span by a starting int `line_start` and an (inclusive) ending int `line_end`. To quote a single line, use `line_start` = `line_end`.

### python

When you send a message containing Python code to python, it will be executed in a 
stateful Jupyter notebook environment. python will respond with the output of the execution or time out after 60.0
seconds. The drive at '/mnt/data' can be used to save and persist user files. Internet access for this session is disabled. Do not make external web requests or API calls as they will fail.

### dalle

Whenever a description of an image is given, use dalle to create the images and then summarize the prompts used to generate the images in plain text. If the user does not ask for a specific number of images, default to creating four captions to send to dalle that are written to be as diverse as possible.

### More Tools

## Initialization
As a/an <Role>, you must follow the <Rules>, you must talk to user in default <Language>，you must greet the user. Then introduce yourself and introduce the <Workflow>.

Role 模板主要包含四部分内容:

  • Profile 角色的简历: 角色描述，角色特点，角色技能以及你想要的其他角色特性。
  • Rules 角色必须遵守的规则，通常是角色必须做的或者禁止做的事情，比如 "不许打破角色设定" 等规则。
  • Workflow 角色的工作流，需要用户提供怎样的输入，角色如何响应用户。
  • Initialization 按照 Role 模板的配置初始化角色，大部分时候使用模板默认内容即可

Role 模板通过上面四个部分内容即可定义和配置一个角色。

同时如需要加入指令，记忆等功能编写复杂的 prompt，只需添加相应的段落即可，可参考高级用法部分。

Role 模板使用步骤

  1. 设置角色名：将 Role: Your_Role_Name 中的 Your_Role_Name 替换为你的角色名
  2. 编写角色简历 # Profile：
    • 设置语言，Language 设置为 中文 或者 English 等其他语言, 用目标语言表达为佳
    • Description 后面简单描述角色
    • ### Skill 部分添加角色技能，可以设置多个技能，技能下分点提供技能描述
  3. 设定规则## Rules ：添加角色必须遵守的规则，通常是角色必须做的或者禁止做的事情，比如 "Don't break character under any circumstance." "禁止出戏" 等规则
  4. 设定工作流## Workflow：角色如何与用户交互，需要用户提供怎样的输入，角色如何响应用户。
  5. 初始化角色## Initialization：Role 模板依据模板内容对角色进行设定，一般不需要修改。
  6. 将编写好的 Role 模板内容复制到 ChatGPT 对话框（or API）愉快使用~

更多模板

  1. 项目 templates 文件夹下提供了更多 Prompt 模板用于参考。
  2. 你也可以借鉴结构化的思想在 LangGPT 提供的模板基础上自行添加、删除、修改得到自己的 Prompt。

高级用法

人们对大模型的能力还在探索过程中，因此 LangGPT 也还在开发完善中，欢迎大家一起共建 LangGPT 项目，降低大模型使用门槛！

变量

变量为 Prompt 的编写带来了很大的灵活性。使用变量可以方便的引用角色内容，设置和更改角色属性。

这是一般的 prompt 方法较难实现的。

Role 模板里的Initialization部分则大量使用的了变量：

As a/an <Role>, you must follow the <Rules>, you must talk to user in default <Language>，you must greet the user. Then introduce yourself and introduce the <Workflow>.

LangGPT 中使用 "<>" 标识变量，这里的变量有：

  • <Role> 变量，指代了整个 Role 角色的内容。
  • <Rules> 变量，指代了 ## Rules 一节的规则
  • <Language> 变量，指代了 Language 字段的值

Markdown 的层级结构可以让 ChatGPT 很方便的识别变量所代表的内容：

  • Role 是文章标题，作用域为全文
  • Rule 是段落标题，作用域为段落
  • Language 是一个字段，作用域为 ‘:’ 后的指定的文本

命令

使用命令可以方便的设置一些默认动作，例如 "/help" 提供帮助文档, "/continue" 续写文本 等都是十分有用的命令

  • 约定使用 '/' 来标识命令
  • 在 Role 模板添加下面内容即可
## Commands
- Prefix: "/"
- Commands:
    - help: This means that user do not know the commands usage. Please introduce yourself and the commands usage.
    - continue: This means that your output was cut. Please continue where you left off.

Reminder

使用 Reminder 可以缓解 ChatGPT 的遗忘问题。

在 Role 模板中添加 Reminder 即可:

## Reminder

1. 'Description: You will always remind yourself role settings and you output Reminder contents before responding to the user.'
2. 'Reminder: The user language is language (<language>), rules (<rules>).'
3. "<output>"

条件语句

像编程中一样使用条件语句，一个模板为：

If [situation1 happen], you will take [action1], else, you will take [action2]

Json or Yaml 方便程序开发

LangGPT 目前使用 markdown 语言，本质上能表达层级结构关系的标记方式如 json, yaml 等都可以

也许可以让 ChatGPT 帮忙写个转换脚本？

Others(TBD)

🤝 伙伴项目

🤩 开发计划

目前项目还处于比较原始初级阶段，工作十分繁重，十分欢迎有兴趣有能力的同学参与项目！🆘

任务 描述 状态
Role 基础模板 Prompt 角色设计基础模板，能覆盖大部分使用场景 ✅
示例 提供更多 LangGPT 模板开发的 prompt 示例，并提供完整对话用法 ✅
文档和用法 基础的文档，用法和简单示例 ✅
高级语法特性 随着大模型能力提升，如更长的上下文长度，更好的长期记忆，插件，开发更高级语法特性 📆 🆘
Prompt Chain 多 Role 协同，Prompt Chain 协同 📆 🆘
支持 Json/Yaml 支持 Json,Yaml 等标记格式，方便编程开发 🔜 🆘
Role 进阶模板 在基础模板上增进指令，环境设置，插件功能，联网控制等高级功能 🔜 🆘
网站 使用文档，案例展示 📆 🆘

贡献指南

  1. 欢迎转发、分享 LangGPT 项目，让更多人能编写更好的 prompt，同时扩大 LangGPT 项目的影响力！
  2. 欢迎使用 LangGPT 的 Role 模板开发有趣的 Prompt，欢迎提交优质案例！
  3. 欢迎贡献 Role 模板之外的更多模板！
  4. 欢迎完善项目文档，改正字词、语法错误等！
  5. 欢迎帮忙建设项目网站！
  6. 欢迎提供可使用的 ChatGPT 插件能力的账号用于开发测试！
  7. 欢迎一切对 LangGPT 项目有益的行为！

如果你不太熟悉 GitHub 使用可以参考： GitHub 极简贡献指南: Issue and PR

交流

微信公众号

欢迎关注我的微信公众号，不过微信内容限制比较多，禁止外链以及内容审核等，所以会随缘发一些内容，欢迎关注~

wx_gh

微信群

若群满无法加入，添加我的微信 zephyr_ai，说明来意我邀请你进群。

Star History

Star History Chart

致谢

下列项目提供了很棒的 prompt，激发了本项目的灵感！