@gea-ai/agent-extension-feishu
用于GEA代理的Feishu Bot频道,可选扩展,增加 (原始内容存档于2018-10-12). Party Feishu Business Connector and instruction Skill.
npm install @gea-ai/agent-extension-feishu @gea-ai/agent-sdk
独立使用频道 agent.ts数字 :
import { defineAgent } from "@gea-ai/agent-sdk";
import { feishuChannel } from "@gea-ai/agent-extension-feishu/channel";
export default defineAgent({
name: "Feishu assistant",
slug: "feishu-assistant",
model: "<configured-model-id>",
channels: [feishuChannel()],
});
feishuChannel() 返回一个正常的 SDK 频道定义。 用进去 channels
或从发现时导出 channels/*.ts 文档。 SDK收集其隐藏
GEA身份连接器和主机环境自动要求. 它支持 feishu 财务报告和审定财务报表 gea
身份模式、接收消息和发送答复,但不添加业务
工具或技能. 配置 FEISHU_APP_ID密语 FEISHU_APP_SECRET 财务报告和审定财务报表
FEISHU_ALLOWED_SENDERS (单位:千美元)* 或 JSON 密码 { tenantKey, openId }[]。“WebSocket”为
默认; { transport: "http" } 还要求 FEISHU_VERIFICATION_TOKEN。 。 。 .
要添加 Feishu 商业工具及集成技能, 请使用扩展 :
// extensions/feishu.ts
export { default } from "@gea-ai/agent-extension-feishu";
扩展再利用 feishuChannel() 并增加下列业务能力.
业务电话使用曝光 {alias}__call 带有 lark- cli 的工具 argv 和可选
stdin。该平台在其沙盒中执行官方CLI,并管理
连接器的加密状态. 代理选择 --as bot 或者说 --as user 每个
商业指挥。 计算机和Bash是可选的,不安装lark-cli.
托管频道通话使用应用程序配置的Feishu bot Certain.
--as user 要求消息发送者自己对同一应用程序的授权登录; 3;
缺少授权返回发送者的链接。 频道是正常的
聊天回复,所有证书都留在电脑之外. 独立连接器
引用保留现有的连接授权流 .
机器人接受私人文本和丰富文本(post(b) 明确提及
这个应用程序的机器人。 分组回复创建或继续触发信件
主题。 成员分享这个话题的对话,而每个电话保留其实际
发件人授权. 普通的分组信件和空的只提及信件
不要启动代理运行。 HTTP召回和WebSocket输入都使用此策略.
丰富的文本保留了标题,段落,链接,引用和代码作为Agent输入.
不支持的消息类型或嵌入式介质收到明确请求重新发送
;这些信件不会启动代理运行或提交部分摘要.
所有频道都可以宣布SDK的通用 requirePlatformUser 政策。 飞须用
同一政策; 东道主执行录取,历史
阅读和执行。 托管的全球环境评估需要一名主计长 channel-user-policy-v1· ;
不支持的主计长显然失败。 本地默认和明确 false 政策
支持没有GEA登录的bot消息和回复。 当地 true 政策和无效
政策价值观遭到拒绝。 环境选择需要升级本地 App
服务器; 选择器保持隐私, 不通过 ctx.env。 。 。 .
独立频道和扩展都接受固定 { requirePlatformUser: true }
或者说 { requirePlatformUser: false } 选项,或诸如
{ requirePlatformUser: { env: "REQUIRE_PLATFORM_USER", default: false } }关闭 requirePlatformUser 选择模式
通过环境配置。 设定 FEISHU_REQUIRE_PLATFORM_USER=true 需要 GEA 用户在每次访问前的授权
运行并将 LLM 使用量归属于该用户 。 没有匹配器, 配置 CHANNEL_GEA_CLIENT_ID 财务报告和审定财务报表
隐藏 CHANNEL_GEA_CLIENT_SECRET gEA OAuth 客户端
openid agents:invoke offline_access 项目/代理环境.
显示使用的环境值 false; 无效值或失败的 GEA 授权永远不会
默然降级. 在主办全球环境评估时,重复活动保留其原始身份
决定。 本地外部模式使用未经主机验证的 Feishu 主机
身份收据,不发放GEA补助金.
要识别发件人而不另加GEA登录,请声明平台用户匹配者. 没错 一个普通同步函数,在被绑定的状态中作为普通代理工作代码运行 工人:
feishuChannel({
platformUserMatcher: (sender, candidate) =>
sender.openId === candidate.account.accountId,
});
主机验证飞翔事件,选择候选的GEA帐号并询问
匹配者可以接受或拒绝每个用户; 它仍然检查用户当前成员
和权限。 选手之前跑过 requirePlatformUser拒绝或
失败给出了私人指导,永远不能回到OAuth或外部身份.
与 transport: "http" 主机验证回调签名, 因此也配置
隐藏 FEISHU_ENCRYPT_KEY. 为退休本土选手建造的包件必须是:
以当前 SDK 重建并重新部署。 没有匹配者, requirePlatformUser
独自决定身份 true 使用 OAuth 条目。 Feishu商业用户同意
继续分开.
两种模式都使用同一种运输和卡. GEA 团体历史仍分开
从外部模式的历史, 和飞书业务 --as bot|user 授权
独立。 主机升级需要重建代理和新频道
在升级的主机上安装。 两个入场点都有着相同的身份流.
与 platformUserMatcher, SDK 不生成身份 OAuth 连接器
或者说 CHANNEL_GEA_CLIENT_ID 编号 : CHANNEL_GEA_CLIENT_SECRET 所需经费。 已验证
事件使用频道安装、其绑定的工程和匹配的激活
组织成员。 拆除设施、拆除项目装订和拆除
成员宣布授权无效。 更新东道主和主计长(内部赠款)
能力 channel-native-user-grant-v1一起重建探员 新设
channel-user: 校长不继承历史 channel-oauth: 私营
会话或连接;旧赠款保留其原始验证. 明确
没有匹配器和商务连接器授权的OAuth是不变的.
本地开发与主机预览
当地 gea agent dev,使用明确的发展条目
feishuChannel() 财务报告和审定财务报表 没有 platformUserMatcher配置一个开发 Feishu
应用程序和发件人授权列表 FEISHU_REQUIRE_PLATFORM_USER 未定或虚.
消息然后使用本地/外部发送者身份,而不是经过验证的平台身份.
支持默认的 WebSocket 接收器; 真正的连接和交付
仍然需要有效的飞须证书.
本地 Dev 硬拒绝匹配者声明,包括何时
requirePlatformUser: false:当地东道主缺乏经过核实的入侵,候选人
账户、成员和项目授权链。 测试匹配者为纯
函数使用本地合成输入。 测试全部授权、装入/装入
匹配器启用的条目并运行主机预览安装。 留着
发布条目并检查其匹配者描述符后再上传到
本地声明不是意外运出。 本地预览页面或更改
环境标题不提供主机授权.
如果运行时启动失败 channel-object/converge 403, 升级 CLI
及其捆绑的运行时间在一起。 独立运行时验证此请求
而不是一个进程-全局机密.
不要将共享运行时全球秘密设定为工作。 提供者证书或
WebSocket 聚合后失败需要单独诊断;聚合成功
单凭一己之力无法证实飞翔的发送/接收.