# Soft Agent Module

> Agent模块（acore-agent）开发指南。涵盖Agent全生命周期管理（创建/编辑/发布/删除）、 Dify平台集成、DeerFlow平台集成（后端预创建线程+前端跳转独立页面模式）、模板方法+工厂模式的多平台扩展架构、 权限管理、标签管理、资源映射等完整知识。 当用户提到Agent、agent、智能体、Dify Agent、DeerFlow Agent、Agent管理、Agent发布、dk_acore_agent、 AgentController、AgentApplicationService、AgentDomainService、AgentPlatformGateway、 DifyAgentPlatformGateway、DeerFlowAgentPlatformGateway、 DeerFlowChatGateway、acore-agent 时使用。 即使用户只是提到"Agent模块"或"acore-agent"也应主动触发。

- Skill: `luokai0/soft-agent-module` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add luokai0/soft-agent-module`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luokai0/soft-agent-module/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luokai0 (https://skillmd.com/u/luokai0)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/luokai0/soft-agent-module

---


# Agent模块（acore-agent）开发指南

本 skill 的目标：接到 Agent 新需求时，直接基于已有代码模式开发，无需重新读代码。

## 模块概述

Agent 模块是 AI 中台的智能体管理核心模块，随主应用聚合启动，不独立部署。

核心能力：
- Agent 全生命周期管理（创建/导入DSL/编辑/发布/取消发布/删除）
- 多平台集成（Dify 为主，DeerFlow 为新增，支持扩展 N8N/自定义平台）
- DeerFlow 平台集成（后端预创建线程+前端跳转独立页面模式）
- 模板方法 + 工厂模式的可扩展平台 Gateway 架构
- 权限管理（OWNER/COLLABORATOR/USER 三级角色）
- 标签/分类管理、资源映射
- 分页/滚动分页查询、多租户隔离
- 对外提供 client 接口（AgentQueryService）供 AIChat 等模块调用
- AI 聊天 @Agent 兼容 DeerFlow（AgentMessageStrategy 按 platformType 路由）

## 代码路径

- 后端：`acore-agent/src/main/java/com/giikin/acore/agent/`
- SQL建表：`acore-agent/sql/01_create_table_agent.sql`
- Mapper XML：`acore-agent/src/main/java/com/giikin/acore/agent/infrastructure/persistence/mapper/AgentMapper.xml`
- 文档：`acore-agent/doc/`（接口文档、工作流程、Dify API文档、实现方案）
- README：`acore-agent/README.md`