)
如何把 Multica agent 接入飛書掃碼綁定與 /issue【免費下載鏈接】multicaMake humans and AI agents work as one team — open-source and self-hostable.項目地址: https://gitcode.com/GitHub_Trending/mu/multicaMultica 支持把一個 agent 連接成飛書 Bot團隊成員可以在飛書里私聊它、在群里 它也可以直接用/issue創(chuàng)建任務(wù)對話和執(zhí)行記錄仍會保存到 Multica 工作區(qū)。每個 Bot 只對應(yīng)一個 agent需要在飛書里使用多個 agent 時分別為它們連接 Bot。本文覆蓋從發(fā)起掃碼綁定、完成成員賬號綁定到用/issue創(chuàng)建任務(wù)以及自托管部署的前置配置。連接前提與權(quán)限發(fā)起連接的賬號必須是該 agent 的所有者、工作區(qū) owner 或 admin否則看不到綁定到飛書入口。目前只開放中國大陸版飛書的新連接入口已有的國際版 Lark 連接仍可繼續(xù)使用和管理。使用自托管部署時需要先完成下文「自托管部署設(shè)置憑據(jù)加密密鑰」一節(jié)界面上才會出現(xiàn)連接入口Multica Cloud 無需額外配置。掃碼綁定飛書 Bot在 Multica 中打開智能體Agents選擇要接入飛書的那個 agent。進入集成Integrations點擊綁定到飛書Bind to Feishu。用飛書掃描頁面生成的二維碼并確認授權(quán)?;氐?Multica頁面顯示已連接到飛書Connected to Feishu后Bot 即準備就緒。二維碼是一次性憑證過期后重新生成即可。已經(jīng)連接的 agent 不再顯示掃碼入口需要給 Bot 改名或調(diào)整權(quán)限時點擊在飛書中管理Manage in Feishu。成員首次使用賬號綁定成員第一次給 Bot 發(fā)消息時會收到一個賬號綁定鏈接打開鏈接并登錄 Multica。確認要關(guān)聯(lián)的工作區(qū)賬號。回到飛書再發(fā)送一次消息。綁定完成后Multica 才能確認消息來自哪位工作區(qū)成員并且每條消息都會重新檢查賬號綁定與工作區(qū)成員身份。綁定只用于確認發(fā)送者是誰不會把聊天平臺上的其他成員自動加入 Multica 工作區(qū)非成員無法使用 Bot。在飛書里交代工作與使用 /issue私聊直接給 Bot 發(fā)消息即可。連續(xù)消息保留在同一段 Multica 對話中agent 的回復也發(fā)回當前對話。群聊先把 Bot 加入群聊再Bot并寫下要求。Bot 只響應(yīng)明確 它的消息未 的消息不會觸發(fā) agent也不會進入它的上下文執(zhí)行時它會結(jié)合當前會話中可讀取的近期上下文。創(chuàng)建任務(wù)發(fā)送一條/issue消息格式為第一行標題、其余內(nèi)容作為描述/issue 修復登錄后的跳轉(zhuǎn)問題 Safari 登錄成功后仍然停留在登錄頁。只發(fā)送/issue不會創(chuàng)建任務(wù)Bot 會回復用法提示。/issue是一條命令而非對話輪次Multica 會把結(jié)果回帖到發(fā)起的平臺但不會把該命令加入 Multica Chat 會話。此外飛書側(cè)還支持/new [message]新建會話、/clear [message]清空當前 agent 可見上下文歷史仍保留在 Multica 中會話按聊天隔離同一個聊天里的后續(xù)消息延續(xù)同一會話。自托管部署設(shè)置憑據(jù)加密密鑰自托管部署必須在打開連接入口之前先配置一個用于加密 Bot 憑據(jù)的密鑰MULTICA_LARK_SECRET_KEYbase64 編碼的 32 字節(jié)密鑰可以用下面的命令生成一個openssl rand -base64 32重啟 API 服務(wù)后再從 agent 的集成頁面連接 Bot。注意該密鑰需要長期保存。更換或丟失后已存儲的憑據(jù)無法解密Bot 必須重新連接。MULTICA_LARK_HTTP_BASE_URL和MULTICA_LARK_CALLBACK_BASE_URL只用于代理、測試等特殊部署正常情況下不需要設(shè)置。使用 Docker Compose 自托管時MULTICA_LARK_SECRET_KEY等變量從.env注入到 API 服務(wù)參見 docker-compose.selfhost.yml修改環(huán)境變量后Multica 在進程啟動時讀取需重啟相關(guān)進程才生效。驗證與常見問題連接成功的判斷標準是 agent 的集成頁面顯示已連接到飛書投入使用后成員消息能收到回復/issue能創(chuàng)建出對應(yīng)任務(wù)。遇到以下現(xiàn)象時按文檔給出的方向排查沒有綁定按鈕確認當前賬號是 agent 所有者、工作區(qū) owner 或 admin并檢查自托管密鑰MULTICA_LARK_SECRET_KEY是否已配置。二維碼失效關(guān)閉彈窗后重新發(fā)起連接。Bot 要求綁定賬號打開綁定鏈接并使用該工作區(qū)的 Multica 賬號登錄。Bot 不執(zhí)行檢查該 agent 是否已被歸檔以及它使用的 運行時是否在線。管理連接打開設(shè)置 → 集成Settings → Integrations可以查看工作區(qū)內(nèi)已連接的 Bot。工作區(qū) owner 和 admin 可以在這里斷開連接agent 的所有者也可以回到該 agent 的集成頁面管理自己的 Bot。斷開后Bot 不再接收新消息已有的對話和執(zhí)行記錄不會隨之刪除。更多背景可參考 飛書 Bot 集成文檔、聊天集成總覽 與 環(huán)境變量參考。【免費下載鏈接】multicaMake humans and AI agents work as one team — open-source and self-hostable.項目地址: https://gitcode.com/GitHub_Trending/mu/multica創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考