跳转至

toolkit

feishu.agent.toolkit

飞书工具库:按产品分模块的参数化工具工厂,与产品文案 / 选择解耦。

每个工厂封装一个通用飞书操作(列日程、建任务、查文档……),把工具描述、name、是否需要审批、 是否以用户身份执行、所需授权范围,以及少数接口真实需要的本地化参数等注入,并产出一个 feishu.agent.tools.Tool。处理函数经 feishu.agent.context.current_tool_context 读取按轮上下文以拿到(用户态)飞书客户端,机器人只要 「选择 + 覆盖文案」即可注册。

审批语义:把 requires_approval=True 的工具交给 feishu.agent.loop.AgentEngine 后,模型发起调用会先挂起并发出 审批卡片;用户批准后处理函数才真正执行——故写类工具的处理函数直接执行写操作,提议由 requires_approval 驱动。