Feishu

​

Overview

​

Environment & prerequisites

pip install veadk-python[extensions]

pip install lark-oapi

• TOOL_FEISHU_CHANNEL_APP_ID
• TOOL_FEISHU_CHANNEL_APP_SECRET
• TOOL_FEISHU_CHANNEL_TRANSPORT: defaults to ws
• TOOL_FEISHU_CHANNEL_STREAMING: whether to enable streaming output, defaults to false
• TOOL_FEISHU_CHANNEL_REACTIONS: whether to reply with a “received” reaction on incoming messages, defaults to false

tool:
  feishu_channel:
    app_id: cli_xxx
    app_secret: xxx
    transport: ws
    streaming: true
    reactions: true

​

Usage

import asyncio

from veadk import Agent, Runner
from veadk.extensions import FeishuChannelExtension
from veadk.memory.short_term_memory import ShortTermMemory

agent = Agent(
    name="feishu_agent",
    model_name="doubao-seed-2-1-pro-260628",
    instruction="You are an assistant that talks to users through a Feishu bot.",
)

runner = Runner(
    agent=agent,
    app_name="veadk_feishu_demo",
    user_id="veadk_feishu_default_user",
    short_term_memory=ShortTermMemory(),
)

channel = FeishuChannelExtension(
    runner=runner,
    channel_kwargs={"transport": "ws"},
)


async def main():
    await channel.connect()


if __name__ == "__main__":
    asyncio.run(main())

​

Notes

• The Feishu WebSocket long-connection mode is used by default, so as long as the bot has subscribed to message events, you can start the connection directly.
• Replies are sent as replies to the original message by default, keeping VeADK output attached to the current Feishu message thread.
• Override the default identity mapping via session_id_factory and user_id_factory.
• connect() and disconnect() support both async clients and synchronous Channel SDK clients exposing start() / stop().