adk-framework-adapters

ADK Framework Adapters

为 AI Agent 代码生成提供框架特定的适配层。

何时激活

• agent-dev-workshop Phase 5 自动调用
• 用户需要特定框架的 Agent 代码模板
• 需要对比不同框架的 API 差异时

支持的框架

| 框架 | 语言 | 维护方 | Reference | 版本锁定 |

|------|------|--------|-----------|---------|

| LangChain / LangGraph | Python, TypeScript | LangChain Inc. | references/langchain.md | ✅ |

| EINO | Go | ByteDance | references/eino.md | ✅ |

| AutoGen | Python | Microsoft | references/autogen.md | ✅ |

| AgentScope | Python | Alibaba | references/agentscope.md | ✅ |

| CrewAI | Python | CrewAI Inc. | references/crewai.md | ✅ |

版本锁定机制

每个 reference 文件头部包含：

framework: langchain
version: "0.3.x"
verified_date: "2025-01-15"

使用规则:

• verified_date 距今 ≤ 90 天 → 正常使用
• verified_date 距今 > 90 天 → 生成代码前提醒用户检查 API 变化
• /harness-audit 会检查所有 reference 文件的 staleness

框架能力对照表

| 能力 | LangChain | EINO | AutoGen | AgentScope | CrewAI |

|------|-----------|------|---------|------------|--------|

| ReAct Agent | ✅ AgentExecutor | ✅ ReactAgent | ✅ AssistantAgent | ✅ ReActAgent | ✅ Agent |

| Multi-Agent | ✅ LangGraph | ⚠️ 自定义 | ✅ GroupChat | ✅ Pipeline | ✅ Crew |

| RAG Pipeline | ✅ Retriever chain | ✅ flow chain | ⚠️ 需集成 | ✅ Knowledge module | ✅ Knowledge |

| Tool Definition | ✅ @tool decorator | ✅ ToolsNode | ✅ Function | ✅ ServiceToolkit | ✅ @tool |

| Memory | ✅ 内置多种 | ✅ ChatTemplate | ✅ 内置 | ✅ Memory module | ✅ 内置 |

| Streaming | ✅ | ✅ | ✅ | ✅ | ⚠️ 有限 |

| Async | ✅ | ✅ (goroutine) | ✅ | ✅ | ⚠️ 有限 |

图例：✅ 原生支持 / ⚠️ 部分支持或需额外集成

使用方式

# 在 agent-dev-workshop Phase 5 中
1. 确认目标框架
2. 读取 references/{framework}.md
3. 检查 verified_date
4. 使用 reference 中的 code templates 生成项目
5. 根据 agent-spec 和 architecture 填充模板变量

新增框架

新增框架适配器时：

1. 在 references/ 下创建 {framework}.md
2. 包含 frontmatter（framework, version, verified_date）
3. 至少覆盖：项目模板、Agent 创建、Tool 定义、Memory 配置、运行入口
4. 更新本文件的框架表