description.md

## OpenAI Assistant

基于 [OpenAI platform](https://platform.openai.com/docs/introduction) 开发的 assistant 界面及示例。

### 使用方法

填写 `openai_api_key` 之后，点击任意 `Example`，然后点击 `Add and run` 就可以运行起来。

界面使用主要分为左中右三个部分。

左边，主要包含对系统的增删查功能。其中最重要的是 `create assistant` 标签，你可以在此填写内容并创建新的 assistant。

中间，是 `conversation` 对话窗口。点击 `Add and run` 按钮就可以发送消息。由于一些原因，后端返回的内容可能无法自动更新到 chatbot 对话记录中，因此你可能需要用到 `Refresh` 按钮。

右边，是一些对话的状态和提示信息。每个对话都需要有一个机器人，即 `assistant_id` 。如果你点击 `Add and run` 按钮发送消息时它的值为空，则会根据 `create assistant` 中的内容自动创建一个机器人，并填充 `assistant_id`，这个参数决定了你正在与哪个机器人聊天，因此不要乱改它，因为它很重要。
`thread_id` 参数，好像是一个会话的概念，因此也不要乱改。


### 对话记录


#### 披萨订餐机器人

```text
User: 你好。
```
```text
Assistant: 嗨！欢迎光临我们的披萨店。 😊 准备好下单了吗？您想要点哪种披萨？
```
```text
User: 可以先看一下菜单吗、
```
```text
Assistant: 好的，这是我们的菜单：

披萨：

意大利辣香肠披萨（大 $12.95/中 $10.00/小 $7.00）
芝士披萨（大 $10.95/中 $9.25/小 $6.50）
茄子披萨（大 $11.95/中 $9.75/小 $6.75）
小吃：

薯条（大 $4.50/小 $3.50）
希腊沙拉 $7.25
额外配料：

奶酪 $2.00
蘑菇 $1.50
香肠 $3.00
加拿大培根 $3.50
AI辣酱 $1.50
辣椒 $1.00
饮料：

可乐（大 $3.00/中 $2.00/小 $1.00）
雪碧（大 $3.00/中 $2.00/小 $1.00）
瓶装水 $5.00
请告诉我您想要点哪些项目，如果您想要额外的配料或其他产品，也请随时告诉我。 😄
```
```text
User: 来一个芝士披萨，和一杯雪碧大份。
```
```text
Assistant: 非常好的选择！一个大份的芝士披萨和一大杯雪碧。
那还需要加点别的吗，比如额外的奶酪或者其他配料？还是这样就可以了？ 😊
```
```text
User: 可以了
```
```text
Assistant: 太棒了！接下来，请问是自取还是需要我们外送？
如果需要外送的话，麻烦提供一下您的地址。🚚💨
```
```text
User: 我堂食。
```
```text
Assistant: 好的，堂食！您的订单总金额为 $10.95（大份芝士披萨） + $3.00（大杯雪碧） = $13.95
谢谢您的点单，希望您在这里享受到愉快的用餐体验！🍕🥤🎉
```
```text
User: 哦哦，不好意思，我的披萨要小份就好了。
```
```text
Assistant: 没问题，我已经帮您更改为小份芝士披萨。
您的订单现在是小份芝士披萨 $6.50 加上大杯雪碧 $3.00，总计金额为 $9.50。
是否还有其他需要调整的地方？ 😊
```
```text
User: 没有了，很好。
```
```text
Assistant: 好的，订单确认为小份芝士披萨和大杯雪碧，总计 $9.50。
您的餐点很快就能准备好。祝您在这里用餐愉快！🍕🥤✨
```