后端工作流自動(dòng)化流程編排低代碼【免費(fèi)下載鏈接】elsa-coreThe Workflow Engine for .NET項(xiàng)目地址https://gitcode.com/gh_mirrors/el/elsa-core點(diǎn)擊查看免費(fèi)下載導(dǎo)讀本文以specs/012-weaver-grounding-tools/quickstart.md為骨架系統(tǒng)講解 Elsa 中 WeaverAI Copilot如何通過接地工具Grounding Tools訪問服務(wù)器端真實(shí)數(shù)據(jù)——已安裝活動(dòng)元數(shù)據(jù)、工作流定義、工作流實(shí)例與事故記錄——從而在無數(shù)據(jù)庫直接暴露的前提下回答問題、創(chuàng)建提案。讀完本文你將掌握如何搭建具備 grounding 能力的 Elsa Server、如何驗(yàn)證/ai/capabilities與/ai/tools能力面、四大工具族activities / workflows / proposals / runtime的完整目錄與調(diào)用契約以及讀只讀、寫僅提案proposal-only的受控編排模式下如何用手動(dòng)驗(yàn)證與自動(dòng)化測試完成端到端驗(yàn)收。該能力定位在 specs/012-weaver-grounding-tools/spec.md配套契約見 contracts/rest-api.md 與 contracts/tool-catalog.md實(shí)現(xiàn)源碼位于 src/modules/Elsa.AI.Host 與 src/modules/Elsa.AI.Abstractions。一、Grounding Tools 的目標(biāo)與設(shè)計(jì)原則1.1 目標(biāo)Quickstart 開篇即點(diǎn)明目標(biāo)Goal驗(yàn)證 Weaver 能夠回答基于已安裝 Elsa 數(shù)據(jù)的提問并創(chuàng)建提案且不暴露數(shù)據(jù)庫或提供方 SDK 的直接訪問。翻譯成工程語言就是三條邊界數(shù)據(jù)只經(jīng)服務(wù)器Elsa Server 是唯一允許訪問工作流存儲(chǔ)、運(yùn)行時(shí)存儲(chǔ)、Activity Registry、診斷與審計(jì)持久化的組件見 spec.md 的 Assumptions 一節(jié)Studio 只傳引用與意圖Studio 不向 AI 提供方發(fā)送原始工作流或運(yùn)行時(shí)數(shù)據(jù)而是通過kindreferenceId的附件形式傳遞上下文引用寫操作必須可審查AI 生成的工作流變更一律以提案proposal形式落地由用戶明確批準(zhǔn)并應(yīng)用后才真正持久化。1.2 四個(gè)關(guān)鍵設(shè)計(jì)決策來自 research.mdresearch.md 記錄了幾個(gè)對理解整個(gè)功能至關(guān)重要的取舍決策取舍理由被否決的替代方案用確定性 Elsa 工具而非 Embedding 向量檢索活動(dòng)描述符、工作流定義、實(shí)例、事故都是結(jié)構(gòu)化 Elsa 數(shù)據(jù)確定性檢索準(zhǔn)確、可測、權(quán)限可控全量提示詞注入昂貴易泄漏、優(yōu)先上向量庫MVP 場景不需要、讓 Copilot 直連數(shù)據(jù)庫破壞租戶/RBAC/脫敏邊界以 Activity Registry 為創(chuàng)作地基活動(dòng)版本、輸入輸出、觸發(fā)行為、約束決定了草稿能否被驗(yàn)證在提示詞里硬編碼常見活動(dòng)知識(shí)用戶會(huì)裝自定義活動(dòng)、直接暴露原始ActivityDescriptor模型側(cè) DTO 必須穩(wěn)定、有界、脫敏寫操作保持 proposal-onlyAI 生成的工作流變更是高影響操作必須可審計(jì)、可回滾、經(jīng)過基線校驗(yàn)讓 Copilot 直接調(diào)工作流持久化繞過審查與基線檢查、MVP 里加帶確認(rèn)提示的直接操作工具確認(rèn) UX 與審計(jì)語義未成熟運(yùn)行時(shí)巡檢與操作動(dòng)作分離實(shí)例/事故巡檢是只讀且有即時(shí)價(jià)值重試、取消、重啟、批量操作具有破壞性留待后續(xù)顯式動(dòng)作/提案語義把操作工具納入 MVP擴(kuò)大風(fēng)險(xiǎn)面、完全不做運(yùn)行時(shí)工具用戶確實(shí)需要詢問實(shí)例與失敗原因此外能力面必須提供方中立provider-neutralStudio 依據(jù) Elsa 自己發(fā)布的能力描述符決定啟用哪些控件而不是依賴 GitHub Copilot SDK 的特性開關(guān)——這也保證了部分部署如未注冊運(yùn)行時(shí)存儲(chǔ)時(shí) UI 能給出可理解的禁用狀態(tài)。二、環(huán)境搭建Setup按 quickstart.md 的 Setup 章節(jié)驗(yàn)證環(huán)境需要四步2.1 啟動(dòng)啟用了 AI Host 與 Copilot 的 Elsa ServerElsa Server 需啟用 AI 相關(guān)特性AI HostElsa.AI.Host負(fù)責(zé)工具注冊、能力面、提案存儲(chǔ)與會(huì)話編排Elsa.AI.Copilot封裝 GitHub Copilot SDK 并獨(dú)占代理循環(huán)agent loop依賴關(guān)系在 plan.md 的 Technical Context 中列明核心依賴為 Elsa AI abstractions/host 模塊、GitHub.Copilot.SDK僅限Elsa.AI.Copilot內(nèi)部、Activity RegistryIActivityRegistry/活動(dòng)描述符、工作流管理/運(yùn)行時(shí)抽象、身份/租戶服務(wù)端點(diǎn)沿用 FastEndpoints 模式。2.2 安裝若干活動(dòng)至少包含一個(gè)觸發(fā)活動(dòng)與一個(gè)動(dòng)作活動(dòng)這是 grounding 正確性的基礎(chǔ)Weaver 的答案必須只引用當(dāng)前服務(wù)器真實(shí)安裝的活動(dòng)。例如 HTTP 相關(guān)的Elsa.Http.Endpoint屬于觸發(fā)活動(dòng)Email 發(fā)送活動(dòng)屬于動(dòng)作活動(dòng)。若倉庫中有 samples/extensions/workbench 之類的示例宿主可參照其活動(dòng)注冊方式驗(yàn)證自定義活動(dòng)場景。2.3 創(chuàng)建或播種三類種子數(shù)據(jù)一個(gè)已發(fā)布的工作流定義用于驗(yàn)證workflows.search/workflows.getDefinition/ 解釋能力一個(gè)使用了自定義或帶版本活動(dòng)的工作流用于驗(yàn)證多版本活動(dòng)描述符的識(shí)別以及引用了已卸載活動(dòng)這類告警場景見 spec.md Edge Cases一個(gè)帶事故incident的失敗工作流實(shí)例用于驗(yàn)證運(yùn)行時(shí)巡檢失敗活動(dòng)、事故消息、時(shí)間線、脫敏狀態(tài)。2.4 配置持久化的提案與審計(jì)存儲(chǔ)僅在驗(yàn)證提案生命周期時(shí)需要提案存儲(chǔ)實(shí)現(xiàn)IAIProposalStore契約見 Contracts/IAIProposalStore.cs是否具備持久會(huì)話與提案能力會(huì)直接影響/ai/capabilities返回的conversationPersistence與proposalReview布爾值——見下方源碼證據(jù)。三、能力發(fā)現(xiàn)與工具目錄契約3.1GET /ai/capabilities能力面描述該端點(diǎn)返回 stream 能力、會(huì)話持久化、提案審查、支持的附件種類以及各 grounding 族family的可用狀態(tài)。完整的響應(yīng)契約見 contracts/rest-api.md摘要如下{ streaming: true, conversationPersistence: true, proposalReview: true, supportedAttachmentKinds: [ WorkflowDefinition, WorkflowInstance, ActivitySelection, DiagnosticsScope, TimeRange ], grounding: [ { name: activities, displayName: Activity catalog, enabled: true, toolNames: [activities.search, activities.getDescriptor], supportedAttachmentKinds: [ActivitySelection] } ] }從源碼實(shí)現(xiàn)看Endpoints/AI/Capabilities/Endpoint.cs 會(huì)為四個(gè)族分別構(gòu)建能力描述符activities取決于ActivityGroundingEnabled配置與IActivityRegistry是否注冊workflows取決于WorkflowGroundingEnabled與IWorkflowDefinitionStore是否注冊proposals取決于ProposalGroundingEnabled與是否存在非瞬態(tài)提案存儲(chǔ)runtime取決于RuntimeGroundingEnabled與IWorkflowInstanceStore是否注冊。當(dāng)對應(yīng)存儲(chǔ)未注冊時(shí)端點(diǎn)會(huì)給出DisabledReasons如 Workflow instance store is not registered.供 Studio 渲染禁用態(tài)。注意端點(diǎn)要求Capabilities查看權(quán)限RequirePermission(..., CoreVerbs.View)見 Permissions/AIResourcePermissions.cs。3.2GET /ai/tools可用工具清單按 contracts/tool-catalog.md所有工具都使用 Elsa 自有的AIToolDefinition元數(shù)據(jù)見 Models/AIToolDefinition.cs在服務(wù)端執(zhí)行名稱穩(wěn)定且?guī)臻g。工具注冊與檢索由 Services/AIToolRegistry.cs 承載工具的公共抽象為IAITool見 Contracts/IAITool.cs?；顒?dòng)工具族Activity Tools工具可變性用途activities.searchReadOnly按能力、類型、類別、輸入/輸出、觸發(fā)行為或文本查詢查找已安裝活動(dòng)activities.getDescriptorReadOnly返回單個(gè)已安裝活動(dòng)的詳細(xì)模型安全元數(shù)據(jù)activities.search的參數(shù)字段query、category、canStartWorkflow、inputName、outputName、skip、take結(jié)果為GroundingToolResultActivityGroundingSummary。實(shí)現(xiàn)位于 Tools/Activities/ActivitiesSearchTool.cs 與 Tools/Activities/ActivityDescriptorTool.cs底層檢索服務(wù)為 Services/ActivityGroundingSearchService.cs。工作流定義工具族Workflow Definition Tools工具可變性用途workflows.searchReadOnly按名稱、狀態(tài)、活動(dòng)使用、標(biāo)簽或文本查找已授權(quán)的工作流定義workflows.getDefinitionReadOnly返回已授權(quán)工作流定義摘要與選定圖細(xì)節(jié)workflows.getDefinitionGraphReadOnly返回面向圖的節(jié)點(diǎn)/連接數(shù)據(jù)用于解釋、比較或作為提案基線workflows.findUsagesReadOnly查找使用某活動(dòng)類型、變量名、輸入、輸出或表達(dá)式語法的工作流提案工具族Proposal Tools工具可變性用途workflows.validateDraftProposal驗(yàn)證草稿工作流載荷而不持久化workflows.proposeCreateProposal為新建工作流創(chuàng)建可持久化的可審查提案workflows.proposeUpdateProposal為更新既有工作流版本創(chuàng)建可持久化的可審查提案對應(yīng)實(shí)現(xiàn)為 Tools/Workflows/WorkflowValidateDraftTool.cs、WorkflowProposeCreateTool.cs、WorkflowProposeUpdateTool.cs校驗(yàn)與差異能力由 Services/WorkflowDraftValidationService.cs 與 Services/WorkflowProposalDiffService.cs 提供。運(yùn)行時(shí)工具族Runtime Tools工具可變性用途instances.searchReadOnly按工作流、狀態(tài)、日期范圍、是否含事故或文本查找已授權(quán)實(shí)例instances.getReadOnly返回模型安全的實(shí)例摘要instances.getExecutionHistoryReadOnly返回有界的活動(dòng)時(shí)間線instances.getActivityStateReadOnly返回實(shí)例中選定活動(dòng)的有界狀態(tài)incidents.searchReadOnly按工作流、實(shí)例、活動(dòng)、時(shí)間范圍或錯(cuò)誤文本查找事故incidents.getReadOnly返回單個(gè)事故摘要及證據(jù)引用實(shí)現(xiàn)位于 Tools/Runtime 目錄含InstancesSearchTool、WorkflowInstanceTool、WorkflowInstanceExecutionHistoryTool、WorkflowInstanceActivityStateTool、IncidentsSearchTool、IncidentTool公共基類為RuntimeToolBase。實(shí)例/事故到模型安全摘要的映射見 Services/RuntimeGroundingMapper.cs。推遲工具Deferred ToolsMVP 明確不做instances.proposeRetry、instances.proposeCancel、instances.proposeRestart、workflows.proposeDelete、workflows.proposePublish、workflows.proposeUnpublish——這些需要未來顯式的批準(zhǔn)語義對應(yīng)功能需求FR-018初始實(shí)現(xiàn)必須排除直接破壞性動(dòng)作。3.3 可變性與危險(xiǎn)等級(jí)在源碼中的體現(xiàn)從源碼結(jié)構(gòu)看Tools/GroundingToolBase.cs 提供了兩個(gè)定義輔助方法ReadOnlyDefinition(...)Mutability AIToolMutability.ReadOnly、DangerLevel AIToolDangerLevel.LowProposalDefinition(...)Mutability AIToolMutability.Proposal、DangerLevel AIToolDangerLevel.Medium。這正好呼應(yīng) spec.md 的FR-017文檔必須說明哪些工具只讀、哪些僅提案、哪些是未來管理動(dòng)作。同一個(gè)基類還提供了GetString/GetInt/GetBool/GetObject參數(shù)解析輔助方法所有工具執(zhí)行均為async返回ValueTaskAIToolResult符合 plan.md 的異步約束。四、REST API 契約與流事件4.1POST /ai/chat附件驅(qū)動(dòng)的 grounding 請求聊天請求沿用既有形狀grounding 通過附件attachments 可用工具生效{ conversationId: conversation-123, message: Create a workflow that starts on HTTP POST and sends an email, agent: workflow-author, attachments: [ { kind: ActivitySelection, referenceId: activities:http,email } ] }kind對應(yīng)契約中的附件類型WorkflowDefinition、WorkflowInstance、ActivitySelection、DiagnosticsScope、TimeRangereferenceId是 Elsa 側(cè)引用而非原始數(shù)據(jù)——這正是Studio 只傳引用與意圖的體現(xiàn)。上下文提供者的抽象見 Contracts/IAIContextProvider.cs 與 Context 目錄如WorkflowDefinitionContextProvider、WorkflowInstanceContextProvider。4.2 流事件與工具生命周期既有流事件形狀保留grounding 工具映射到當(dāng)前工具生命周期事件tool.startedtool.resultproposal.createdconversation.errorconversation.completed工具結(jié)果數(shù)據(jù)應(yīng)包含toolName、toolCallId、status、summary以及可選的脫敏結(jié)果數(shù)據(jù)使其既適合 Copilot SDK 工具回調(diào)也適合 Studio 的工具活動(dòng)渲染對應(yīng)FR-016。事件映射實(shí)現(xiàn)位于 Streaming/AIStreamEventMapper.cs。4.3 錯(cuò)誤行為狀態(tài)碼含義400非法搜索過濾器、不支持的附件類型、非法草稿載荷403缺少權(quán)限、租戶不匹配、工具訪問被拒絕404活動(dòng)、工作流、實(shí)例、事故或提案不存在409工作流基線過期stale baseline422草稿驗(yàn)證失敗503提供方運(yùn)行時(shí)不可用能力端點(diǎn)仍可工作五、手動(dòng)驗(yàn)證清單Manual Validation以下步驟完整繼承自 quickstart.md并補(bǔ)充了每一步的驗(yàn)收要點(diǎn)與對應(yīng)的工具/契約出處。5.1 能力面與工具面驗(yàn)證步驟 1-4請求GET /ai/capabilities驗(yàn)證 grounding 能力面廣告了activities、workflows、proposals、runtime四個(gè)工具族對應(yīng) Endpoints/AI/Capabilities/Endpoint.cs 中的四個(gè)CreateCapability調(diào)用請求GET /ai/tools驗(yàn)證在已授權(quán)的工作流作者上下文中可用以下工具完整工具清單見 contracts/tool-catalog.mdactivities.searchactivities.getDescriptorworkflows.searchworkflows.getDefinitionworkflows.validateDraftworkflows.proposeCreateworkflows.proposeUpdateinstances.searchinstances.getincidents.search注意quickstart 只列出這 10 個(gè)最小集完整契約還包含workflows.getDefinitionGraph、workflows.findUsages、instances.getExecutionHistory、instances.getActivityState、incidents.get?？捎霉ぞ叩募嫌僧?dāng)前 actor、租戶與可選的 agent 作用域決定contracts/rest-api.md 對GET /ai/tools的說明。5.2 活動(dòng)發(fā)現(xiàn)問答步驟 5-6提問What activities can start a workflow from an HTTP request?驗(yàn)收答案只引用已安裝的活動(dòng)。這條驗(yàn)證對應(yīng)功能需求FR-001/FR-002/FR-003與成功標(biāo)準(zhǔn)SC-001Weaver 能基于已安裝 Activity Registry 數(shù)據(jù)回答活動(dòng)發(fā)現(xiàn)問題不出現(xiàn)幻覺活動(dòng)名。建議同時(shí)用canStartWorkflow: truecategory過濾條件復(fù)核activities.search的觸發(fā)能力篩選參數(shù)示例見 contracts/tool-catalog.md。5.3 提案式創(chuàng)建工作流步驟 7-8提問Create a workflow that starts on HTTP POST and sends an email.驗(yàn)收Weaver 依次搜索活動(dòng) → 驗(yàn)證草稿 → 創(chuàng)建提案而不是直接保存工作流。這條驗(yàn)證FR-006/FR-007/FR-008與SC-002Weaver 只用已安裝活動(dòng)創(chuàng)建簡單工作流提案請求不可用活動(dòng)時(shí)收到阻塞性診斷。提案包含基線baseline、草稿載荷、差異graph diff、理由rationale、警告與驗(yàn)證診斷見>dotnet test test/unit/Elsa.AI.Host.UnitTests/Elsa.AI.Host.UnitTests.csproj dotnet test test/integration/Elsa.AI.IntegrationTests/Elsa.AI.IntegrationTests.csproj dotnet build Elsa.sln -m:1三者的分工如下單元測試test/unit/Elsa.AI.Host.UnitTests含Grounding/、Tools/、AIToolRegistryTests.cs、AIRegistrationTests.cs覆蓋工具注冊、grounding 摘要映射、脫敏與有界性——對應(yīng)FR-013/FR-014/FR-016與SC-005在超大元數(shù)據(jù)或運(yùn)行時(shí)數(shù)據(jù)測試中所有 grounding 響應(yīng)均已脫敏且不超配置尺寸集成測試test/integration/Elsa.AI.IntegrationTests驗(yàn)證端到端行為——活動(dòng)發(fā)現(xiàn)不出現(xiàn)幻覺活動(dòng)名SC-001、提案創(chuàng)建與阻塞診斷SC-002、工作流解釋SC-003、失敗實(shí)例巡檢SC-004、Studio 能力發(fā)現(xiàn)SC-006構(gòu)建驗(yàn)證dotnet build Elsa.sln -m:1-m:1強(qiáng)制單進(jìn)程 MSBuild 節(jié)點(diǎn)便于在受限環(huán)境或需要確定性構(gòu)建順序時(shí)使用。按 plan.md 的測試策略xUnit 單元測試在test/unit/Elsa.AI.Host.UnitTests集成測試在test/integration/Elsa.AI.IntegrationTests僅當(dāng)需要播種事故的工作流運(yùn)行時(shí)夾具時(shí)才引入組件測試對應(yīng) test/component 目錄的能力。九、源碼地圖去哪里繼續(xù)深入如果你要基于本 quickstart 繼續(xù)開發(fā)或?qū)彶閷?shí)現(xiàn)以下路徑是核心入口工具實(shí)現(xiàn)src/modules/Elsa.AI.Host/ToolsActivities/、Workflows/、Runtime/三個(gè)子目錄 基類GroundingToolBase.cs與 schema 定義GroundingToolSchemas.cs能力/聊天/工具端點(diǎn)src/modules/Elsa.AI.Host/Endpoints/AICapabilities/、Chat/、Tools/服務(wù)層src/modules/Elsa.AI.Host/Services工具注冊、活動(dòng)搜索、草稿驗(yàn)證、提案差異、三類 grounding 映射、審計(jì)、流事件映射、編排器AIOrchestrator抽象與模型src/modules/Elsa.AI.AbstractionsContracts/IAITool.cs、IAIContextProvider.cs、IAIProposalStore.csModels/AIToolDefinition.cs、AIGroundingModels.cs、AIProposal.cs、AIContextAttachment.cs配置項(xiàng)src/modules/Elsa.AI.Host/Options/AIHostOptions.csGrounding.ActivityGroundingEnabled、WorkflowGroundingEnabled、ProposalGroundingEnabled、RuntimeGroundingEnabled、SupportedAttachmentKinds、ProposalReviewEnabled等開關(guān)都從這里讀取特性注冊src/modules/Elsa.AI.Host/Features/AIFeature.cs。十、總結(jié)Quickstart 驗(yàn)證矩陣驗(yàn)證對象Quickstart 步驟對應(yīng)契約/需求關(guān)鍵驗(yàn)收點(diǎn)能力面1-2FR-013 / SC-006廣告四個(gè) grounding 族工具面3-4FR-016 / FR-01710 個(gè)最小工具可用且可變性標(biāo)注正確活動(dòng)發(fā)現(xiàn)5-6FR-001~003 / SC-001答案只引用已安裝活動(dòng)提案式創(chuàng)作7-8FR-006~008 / SC-002搜索→驗(yàn)證→提案不直接保存工作流解釋9-10FR-004 / SC-003引用真實(shí)觸發(fā)器、活動(dòng)與圖結(jié)構(gòu)失敗實(shí)例巡檢11-12FR-009~011 / SC-004引用失敗活動(dòng)、事故消息、時(shí)間線與脫敏狀態(tài)自動(dòng)化回歸目標(biāo)測試命令plan.md 測試策略單元 集成 單節(jié)點(diǎn)構(gòu)建全部通過至此你已經(jīng)掌握 Weaver Grounding Tools 從搭建、契約到手動(dòng)與自動(dòng)化驗(yàn)證的完整閉環(huán)。核心心法只有一句話讀走 Elsa 真實(shí)數(shù)據(jù)脫敏、有界、按權(quán)限寫走可審查提案proposal-only能力面保持提供方中立——這套模式既保證了 AI 回答的準(zhǔn)確性也守住了租戶、權(quán)限與審計(jì)的紅線。贊分享后端工作流自動(dòng)化流程編排低代碼【免費(fèi)下載鏈接】elsa-coreThe Workflow Engine for .NET項(xiàng)目地址https://gitcode.com/gh_mirrors/el/elsa-core點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Elsa Weaver Grounding Tools 工具目錄契約為 AI Copilot 提供可治理的 Elsa 數(shù)據(jù)落地工具Elsa Weaver Grounding Tools 工具目錄契約為 AI Copilot 提供可治理的 Elsa 數(shù)據(jù)落地工具 本指南以 specs/01后端工作流自動(dòng)化流程編排低代碼Gods Eye View AISStream WebSocket管道服務(wù)端船舶數(shù)據(jù)攝取全鏈路詳解Gods Eye View AISStream WebSocket管道服務(wù)端船舶數(shù)據(jù)攝取全鏈路詳解 Gods Eye View 是一款運(yùn)行在瀏覽器里的間后端工作流自動(dòng)化流程編排低代碼Elsa Weaver Grounding Tools基于活動(dòng)注冊表、工作流定義與運(yùn)行時(shí)實(shí)例的受治理 AI 工具族實(shí)現(xiàn)指南Elsa Weaver Grounding Tools基于活動(dòng)注冊表、工作流定義與運(yùn)行時(shí)實(shí)例的受治理 AI 工具族實(shí)現(xiàn)指南 導(dǎo)讀 本文以 specs/012后端工作流自動(dòng)化流程編排低代碼上一篇Ant Design 顏色工具包常見問題解答下一篇終極Laravel權(quán)限管理數(shù)據(jù)清理指南高效清理過期權(quán)限數(shù)據(jù)的5個(gè)實(shí)用方法創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考