AI Agent自主智能体后端RAG【免费下载链接】SuperAGI⚡️ SuperAGI - A dev-first open source autonomous AI agent framework. Enabling developers to build, manage run useful autonomous agents quickly and reliably.项目地址https://gitcode.com/gh_mirrors/su/SuperAGI点击查看免费下载SuperAGI 是一个 dev-first 的开源自主 AI Agent 框架其内置的 Slack Toolkit 让开发者可以把 Slack 频道直接接入智能体的工作流使 Agent 在执行任务时能自动向指定频道或成员发送消息。本文将以 superagi/tools/slack/README.md 为骨架结合仓库源码与配置完整讲解从 Slack 应用创建、Bot Token 配置到 SuperAGI Agent 实际发消息的全流程读完即可在自己的 SuperAGI 实例上跑通「Agent → Slack」的消息链路。一、Slack Toolkit 是什么SuperAGI Slack Toolkit 是仓库中面向 Slack 集成的工具包位于 superagi/tools/slack/由两个核心模块组成send_message.py定义SlackMessageTool负责向 Slack 频道发送文本消息这是当前 Toolkit 提供且唯一的功能slack_toolkit.py定义SlackToolkit工具包容器把消息工具注册进 SuperAGI 的工具体系并声明所需的配置项。原文档对该工具包的定位是让 SuperAGI 能向开发者指定的 Slack 频道发送消息为后续更多 Slack 用例提供坚实基础原文provides a strong foundation for use cases to come。支持的消息类型从 send_message.py 的类注释可以看到SlackMessageTool同时支持两类发送场景场景参数值说明单人消息Individual传入 user-id向指定 Slack 用户发送私信群组消息Group传入 group-id / channel-id向指定频道或群组发送消息二、前置条件安装并启动 SuperAGI在配置 Slack 之前需要先完成 SuperAGI 本身的安装与启动。仓库根目录的 README.MD 提供了完整的部署说明主流方式包括使用docker-compose.yaml一键拉起仓库根目录或参考 docker-compose-dev.yaml 进行开发环境部署本地运行执行 run.shLinux/macOS或 run.batWindowsPython 依赖清单见 requirements.txt。安装完成后SuperAGI 会启动 Web 控制台GUI 源码位于 gui/后续的 Toolkit 配置与 Agent 创建都在该界面中完成。三、Slack 端配置8 步完整流程原文档给出了创建 Slack 应用并获取 Bot Token 的完整步骤下面逐一展开并补充每一步的注意事项。第 1 步在 Slack API 门户创建应用登录 Slack API 门户api.slack.com点击创建新应用Create New App。第 2 步选择 From scratch创建应用时选择From scratch从零开始方式以便完全自定义应用的行为。第 3 步填写应用名称与工作区为应用命名并选择该应用将要使用的 Slack 工作区Workspace。应用名称会显示在频道成员列表的机器人身份中建议使用易识别的名称例如SuperAGI Bot。第 4 步进入 OAuth and Permissions 选项卡应用创建完成后进入左侧菜单的OAuth Permissions页面这里管理应用的身份令牌与权限范围。第 5 步配置 Bot Token Scopes添加chat:write在Bot Token Scopes区域点击 Add an OAuth Scope添加chat:write该权限表示机器人可以代表应用发送消息作为应用本身或应用配置的 Bot User。注意原文档明确只要求这一个 scopechat:write已足够覆盖向频道发送文本消息的核心场景如果后续要覆盖历史记录、文件上传等能力才需要额外扩展 scope。第 6 步安装应用到工作区保存权限后回到页面顶部的Install to Workspace或 Reinstall to Workspace按钮将应用安装到你选择的工作区。这一步会触发 Slack 的授权确认页。第 7 步获取 Bot Token安装完成后页面会展示生成的令牌Bot User OAuth Token以xoxb-开头本工具实际使用的令牌User OAuth Token以xoxp-开头代表用户身份本工具不使用。第 8 步把 Token 填入 SuperAGI 的 Slack Toolkit 页面将第 7 步拿到的Bot User OAuth Token粘贴到 SuperAGI 控制台的 Slack Toolkit 配置页面Toolkits → Slack → 配置SLACK_BOT_TOKEN。Token 属于机密信息SuperAGI 在源码层面也将其声明为 secret 类型见下文源码解析。四、配置完成后把 Agent 接入 Slack 频道原文档强调完成上述配置后即可将 Slack 应用安装邀请到你希望接收消息的频道中在 SuperAGI 上创建一个 Agent该 Agent 即可向 Slack 频道发送消息。具体到 GUI 操作路径仓库中对应的前端页面位于 gui/pages/Content/Toolkits/AddTool.jsToolkit 管理/添加工具入口Agent 创建工作则在 gui/pages/Content/Agents/AgentCreate.js 中实现。Agent 运行过程中LLM 会根据任务上下文自动决定是否调用SendSlackMessage工具并把生成的内容作为message参数发出。五、源码级解析工具如何真正发消息原文档停留在配置层面下面结合仓库源码揭示这条消息链路的底层实现。1. 工具的参数 Schemasend_message.py 定义了入参模型SlackMessageSchemaclass SlackMessageSchema(BaseModel): channel: str Field( ..., descriptionSlack Channel/Group Name ) message: str Field( ..., descriptionText Message to be sent to a person or a group or people )channel必填目标频道/群组名称或用户 id对应上文「单人/群组」两种模式message必填要发送的文本内容。两个字段均无默认值...表示必填LLM 在调用工具前必须从任务上下文推导出这两个参数。2. 执行逻辑SlackMessageTool._execute是实际发送的核心方法send_message.pydef _execute(self, channel: str, message: str): slack self.build_slack_web_client() response slack.chat_postMessage(channelchannel, textmessage) if response[ok]: return fMessage sent to {channel} Successfully else: return Message sending failed!关键点使用官方slack_sdk的WebClient调用chat_postMessage(channel..., text...)发送消息根据响应中的ok字段判断成败成功返回Message sent to {channel} Successfully失败返回Message sending failed!。这个返回值会作为 Agent 的观察observation回传给 LLM作为后续决策的依据。3. Token 的读取方式build_slack_web_clientsend_message.py从工具配置中读取SLACK_BOT_TOKENdef build_slack_web_client(self): slack_bot_token self.get_tool_config(SLACK_BOT_TOKEN) return WebClient(tokenslack_bot_token)get_tool_config继承自 base_tool.py最终调用BaseToolkitConfiguration.get_tool_config默认实现是读取仓库根目录config.yaml中的同名键值base_tool.py。在 GUI 的 Toolkit 页面配置的 Token 会落入同一套工具配置存储两种方式等效。4. Toolkit 的注册与密钥声明slack_toolkit.py 定义了工具包的对外契约class SlackToolkit(BaseToolkit, ABC): name: str Slack Toolkit description: str Toolkit containing tools for Slack integration def get_tools(self) - List[BaseTool]: return [ SlackMessageTool(), ] def get_env_keys(self) - List[ToolConfiguration]: return [ ToolConfiguration(keySLACK_BOT_TOKEN, key_typeToolConfigKeyType.STRING, is_requiredTrue, is_secretTrue) ]可以看到get_tools返回工具列表目前只包含SlackMessageToolget_env_keys声明了该工具包需要的环境配置SLACK_BOT_TOKEN并通过 key_type.py 中的ToolConfigKeyType.STRING标记为字符串类型同时is_requiredTrue必填、is_secretTrue机密界面输入时按密文处理这印证了原文档第 8 步「Token 需要添加到 Slack Toolkit 页面」的设计——SuperAGI 会依据get_env_keys的声明自动渲染配置表单。5. 在预置工作流中的接入点SlackMessageTool还被引入到工作流种子文件中workflow_seed.py 中from superagi.tools.slack.send_message import SlackMessageTool这意味着该工具可以参与 Sales Engagement Workflow 等预置工作流的步骤编排进一步说明它与 Agent 工作流引擎AgentWorkflow/AgentWorkflowStep见 agent_workflow.py是打通集成的。六、常见问题与注意事项Token 前缀校验填入SLACK_BOT_TOKEN的必须是xoxb-开头的 Bot User OAuth Token填成xoxp-用户令牌会导致鉴权失败权限不足如果chat:writescope 未正确保存或应用未重新安装chat_postMessage会返回权限相关错误此时返回值将是Message sending failed!频道可见性机器人只能向它已被邀请加入的公开/私密频道发送消息这也是原文档要求「把应用安装到你选择的频道」的原因本地 vs GUI 配置本地开发可直接在config.yaml中写入SLACK_BOT_TOKEN读取逻辑见 base_tool.py生产环境推荐通过 GUI Toolkit 页面配置以利用其 secret 存储能力参数完整性channel与message均为必填字段Agent 若未推导出这两个参数工具调用会因 Schema 校验失败而无法执行。七、小结本文以 superagi/tools/slack/README.md 为主线完整覆盖了从 Slack 应用创建、chat:write权限配置、Bot Token 获取与回填到 SuperAGI Agent 发送消息的 8 步全流程并深入到 send_message.py 与 slack_toolkit.py 的源码实现解释了参数 Schema、chat_postMessage调用、Token 读取与 Toolkit 注册机制。作为「dev-first」框架的扩展点该 Toolkit 提供了最简可用的 Slack 消息发送能力开发者可以以此为基石在其上继续扩展文件上传、线程回复、消息编辑等更丰富的 Slack 用例。赞分享AI Agent自主智能体后端RAG【免费下载链接】SuperAGI⚡️ SuperAGI - A dev-first open source autonomous AI agent framework. Enabling developers to build, manage run useful autonomous agents quickly and reliably.项目地址https://gitcode.com/gh_mirrors/su/SuperAGI点击查看免费下载相关推荐Slack for PHP: 简洁高效的Slack消息发送库Slack for PHP: 简洁高效的Slack消息发送库 项目介绍 Slack for PHP 是一个轻量级的PHP包专为向 Slack https://后端Presentr实战从零搭建完整弹窗系统Presentr实战从零搭建完整弹窗系统 想要在iOS应用中创建专业、美观的弹窗系统吗Presentr作为Swift的轻量级弹窗库提供了完整的自定义视图控终极指南使用websocketd实现Slack与Teams实时消息推送的完整方案终极指南使用websocketd实现Slack与Teams实时消息推送的完整方案 websocketd 是一款轻量级命令行工具能够将任何使用标准输入输出SCLIWebSocket后端上一篇restify 请求日志指南基于 req.log 与 RequestLogger 插件的全链路请求追踪下一篇OpenNHP 消息类型全参考NHP 与 DHP 28 种协议报文的 ID、方向与载荷字段详解创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考