动作是一种向用户界面发送可点击按钮的方式。每个动作都附属于一个 消息,当用户点击时,可以触发一个 Python 函数。

创建动作

动作通过消息发送到 UI

import chainlit as cl

@cl.on_chat_start
async def start():
    # Sending an action button within a chatbot message
    actions = [
        cl.Action(
            name="action_button",
            icon="mouse-pointer-click",
            payload={"value": "example_value"},
            label="Click me!"
        )
    ]

    await cl.Message(content="Interact with this action button:", actions=actions).send()

定义 Python 回调函数

为了处理用户点击动作按钮,你需要使用 @cl.action_callback 装饰器定义一个回调函数。

@cl.action_callback("action_button")
async def on_action(action: cl.Action):
    print(action.payload)

动作 API

了解更多关于动作的信息。