Skip to content

Commit bb51ead

Browse files
authored
增加对on_waiting_llm_request钩子的介绍
1 parent 36f058d commit bb51ead

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

zh/dev/star/guides/listen-message-event.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,22 @@ async def on_astrbot_loaded(self):
252252

253253
```
254254

255+
#### 等待 LLM 请求时
256+
257+
在 AstrBot 准备调用 LLM 但还未获取会话锁时,会触发 `on_waiting_llm_request` 钩子。
258+
259+
这个钩子适合用于发送"正在等待请求..."等用户反馈提示,亦或是在锁外及时获取LLM请求而不用等到锁被释放。
260+
261+
```python
262+
from astrbot.api.event import filter, AstrMessageEvent
263+
264+
@filter.on_waiting_llm_request()
265+
async def on_waiting_llm(self, event: AstrMessageEvent):
266+
await event.send("🤔 正在等待请求...")
267+
```
268+
269+
> 这里不能使用 yield 来发送消息。如需发送,请直接使用 `event.send()` 方法。
270+
255271
#### LLM 请求时
256272

257273
在 AstrBot 默认的执行流程中,在调用 LLM 前,会触发 `on_llm_request` 钩子。

0 commit comments

Comments
 (0)