Feishu Messaging_知识管理 skill-PHP中文网

Feishu Messaging

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

飞书消息发送与文档创建工作流。触发场景：查找群成员、查找群ID、发送消息失败需要重新尝试。适用于：发送飞书消息。

飞书消息与文档 Skill

功能概述

飞书消息与文档 Skill是一项面向实际任务的技能，主要用于此 Skill 通过飞书开放平台 API 帮助用户发送消息、创建文档和管理飞书资源；发送文本消息；

核心要点

im:message:send_as_bot；
获取群聊列表；
im:chat:readonly；

使用与执行

获取群成员；im:chat.members:read；发送消息给指定用户；前置条件：需要获取用户的 open_id；1. 获取群聊id的方法。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

结果检查与注意事项

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

飞书消息与文档 Skill

概述

此 Skill 通过飞书开放平台 API 帮助用户发送消息、创建文档和管理飞书资源。

核心能力

功能	状态	所需权限
发送文本消息	✅ 可用	`im:message:send_as_bot`
获取群聊列表	✅ 可用	`im:chat:readonly`
获取群成员	✅ 可用	`im:chat.members:read`

使用方法

发送消息给指定用户

给 [姓名] 发一条飞书消息，告诉他 [内容]

前置条件：需要获取用户的 open_id

1. 获取群聊id的方法

import json

import lark_oapi as lark
from lark_oapi.api.im.v1 import *


def main():
    # 创建client
    client = lark.Client.builder() 
        .app_id("YOUR_APP_ID") 
        .app_secret("YOUR_APP_SECRET") 
        .log_level(lark.LogLevel.DEBUG) 
        .build()

    # 构造请求对象
    request: SearchChatRequest = SearchChatRequest.builder() 
        .user_id_type("open_id") 
        .query("小鸭子") 
        .page_size(20) 
        .build()

    # 发起请求
    response: SearchChatResponse = client.im.v1.chat.search(request)

    # 处理失败返回
    if not response.success():
        lark.logger.error(
            f"client.im.v1.chat.search failed, code: {response.code}, msg: {response.msg}, log_id: {response.get_log_id()}, resp:
{json.dumps(json.loads(response.raw.content), indent=4, ensure_ascii=False)}")
        return

    # 处理业务结果
    lark.logger.info(lark.JSON.marshal(response.data, indent=4))


if __name__ == "__main__":
    main()

2. 发送消息

import json

import lark_oapi as lark
from lark_oapi.api.im.v1 import *


def main():
    # 创建client
    client = lark.Client.builder() 
        .app_id("YOUR_APP_ID") 
        .app_secret("YOUR_APP_SECRET") 
        .log_level(lark.LogLevel.DEBUG) 
        .build()

    # 构造请求对象
    request: CreateMessageRequest = CreateMessageRequest.builder() 
        .receive_id_type("open_id") 
        .request_body(CreateMessageRequestBody.builder()
            .receive_id("ou_7d8a6e6df7621556ce0d21922b676706ccs")
            .msg_type("text")
            .content("{"text":"test content"}")
            .uuid("选填，每次调用前请更换，如a0d69e20-1dd1-458b-k525-dfeca4015204")
            .build()) 
        .build()

    # 发起请求
    response: CreateMessageResponse = client.im.v1.message.create(request)

    # 处理失败返回
    if not response.success():
        lark.logger.error(
            f"client.im.v1.message.create failed, code: {response.code}, msg: {response.msg}, log_id: {response.get_log_id()}, resp:
{json.dumps(json.loads(response.raw.content), indent=4, ensure_ascii=False)}")
        return

    # 处理业务结果
    lark.logger.info(lark.JSON.marshal(response.data, indent=4))


if __name__ == "__main__":
    main()

3. 图片消息

import json

import lark_oapi as lark
from lark_oapi.api.im.v1 import *


def main():
    # 创建client
    client = lark.Client.builder() 
        .app_id("YOUR_APP_ID") 
        .app_secret("YOUR_APP_SECRET") 
        .log_level(lark.LogLevel.DEBUG) 
        .build()

    # 构造请求对象
    file = open("小鸭子.jpg", "rb")
    request: CreateImageRequest = CreateImageRequest.builder() 
        .request_body(CreateImageRequestBody.builder()
            .image_type("message")
            .image(file)
            .build()) 
        .build()

    # 发起请求
    response: CreateImageResponse = client.im.v1.image.create(request)

    # 处理失败返回
    if not response.success():
        lark.logger.error(
            f"client.im.v1.image.create failed, code: {response.code}, msg: {response.msg}, log_id: {response.get_log_id()}, resp:
{json.dumps(json.loads(response.raw.content), indent=4, ensure_ascii=False)}")
        return

    # 处理业务结果
    lark.logger.info(lark.JSON.marshal(response.data, indent=4))


if __name__ == "__main__":
    main()

4. 上传文件

import json

import lark_oapi as lark
from lark_oapi.api.im.v1 import *


def main():
    # 创建client
    client = lark.Client.builder() 
        .app_id("YOUR_APP_ID") 
        .app_secret("YOUR_APP_SECRET") 
        .log_level(lark.LogLevel.DEBUG) 
        .build()

    # 构造请求对象
    file = open("飞书20260129-173520.mp4", "rb")
    request: CreateFileRequest = CreateFileRequest.builder() 
        .request_body(CreateFileRequestBody.builder()
            .file_type("mp4")
            .file_name(""1.mp4"")
            .duration("3000")
            .file(file)
            .build()) 
        .build()

    # 发起请求
    response: CreateFileResponse = client.im.v1.file.create(request)

    # 处理失败返回
    if not response.success():
        lark.logger.error(
            f"client.im.v1.file.create failed, code: {response.code}, msg: {response.msg}, log_id: {response.get_log_id()}, resp:
{json.dumps(json.loads(response.raw.content), indent=4, ensure_ascii=False)}")
        return

    # 处理业务结果
    lark.logger.info(lark.JSON.marshal(response.data, indent=4))


if __name__ == "__main__":
    main()

5. 查询群成员

import json

import lark_oapi as lark
from lark_oapi.api.im.v1 import *


def main():
    # 创建client
    client = lark.Client.builder() 
        .app_id("YOUR_APP_ID") 
        .app_secret("YOUR_APP_SECRET") 
        .log_level(lark.LogLevel.DEBUG) 
        .build()

    # 构造请求对象
    request: GetChatMembersRequest = GetChatMembersRequest.builder() 
        .chat_id("oc_dcc94d101e8d41e291e90f4623eca17a") 
        .member_id_type("user_id") 
        .build()

    # 发起请求
    response: GetChatMembersResponse = client.im.v1.chat_members.get(request)

    # 处理失败返回
    if not response.success():
        lark.logger.error(
            f"client.im.v1.chat_members.get failed, code: {response.code}, msg: {response.msg}, log_id: {response.get_log_id()}, resp:
{json.dumps(json.loads(response.raw.content), indent=4, ensure_ascii=False)}")
        return

    # 处理业务结果
    lark.logger.info(lark.JSON.marshal(response.data, indent=4))


if __name__ == "__main__":
    main()