@cloudbase/agent-adapter-langchain 1.0.1-alpha.7 → 1.0.1-alpha.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +97 -0
  2. package/package.json +6 -6
package/README.md ADDED
@@ -0,0 +1,97 @@
1
+ # @cloudbase/agent-adapter-langchain
2
+
3
+ 将 LangChain Agent 转换为符合 [AG-UI 协议](https://docs.ag-ui.com) 的 Agent。
4
+
5
+ ## 功能
6
+
7
+ - **LangchainAgent**：将 LangChain 的 `createAgent()` 创建的 Agent 包装为 AG-UI 兼容的 Agent
8
+ - **clientTools()**：中间件，让客户端可以动态注入工具到 Agent 调用中
9
+
10
+ ## 安装
11
+
12
+ ```bash
13
+ npm install @cloudbase/agent-adapter-langchain
14
+ ```
15
+
16
+ ## 快速开始
17
+
18
+ ```typescript
19
+ import { run } from "@cloudbase/agent-server";
20
+ import { createAgent as createLangchainAgent } from "langchain";
21
+ import { MemorySaver } from "@langchain/langgraph";
22
+ import { ChatOpenAI } from "@langchain/openai";
23
+ import { LangchainAgent, clientTools } from "@cloudbase/agent-adapter-langchain";
24
+
25
+ const checkpointer = new MemorySaver();
26
+
27
+ const model = new ChatOpenAI({
28
+ model: process.env.OPENAI_MODEL!,
29
+ apiKey: process.env.OPENAI_API_KEY!,
30
+ configuration: {
31
+ baseURL: process.env.OPENAI_BASE_URL,
32
+ },
33
+ });
34
+
35
+ // 创建 LangChain Agent，使用 clientTools 中间件支持客户端工具
36
+ const lcAgent = createLangchainAgent({
37
+ model,
38
+ checkpointer,
39
+ middleware: [clientTools()],
40
+ });
41
+
42
+ // 部署为 HTTP 服务
43
+ run({
44
+ createAgent: () => ({
45
+ agent: new LangchainAgent({ agent: lcAgent }),
46
+ }),
47
+ port: 9000,
48
+ });
49
+ ```
50
+
51
+ ## API 参考
52
+
53
+ ### LangchainAgent
54
+
55
+ 将 LangChain Agent 包装为 AG-UI 兼容的 Agent。
56
+
57
+ ```typescript
58
+ type LangchainAgentConfig = AgentConfig & {
59
+ agent: ReturnType<typeof createAgent>; // LangChain 的 createAgent() 返回值
60
+ logger?: Logger; // 可选，日志实例
61
+ };
62
+
63
+ const agent = new LangchainAgent(config);
64
+ ```
65
+
66
+ - `AgentConfig`：来自 [AG-UI 协议](https://docs.ag-ui.com)
67
+ - `Logger`：日志接口，详见 [@cloudbase/agent-server 文档](https://www.npmjs.com/package/@cloudbase/agent-server)
68
+
69
+ ### clientTools()
70
+
71
+ 创建一个中间件，让客户端可以动态注入工具到 Agent 调用中。
72
+
73
+ ```typescript
74
+ const agent = createAgent({
75
+ model,
76
+ checkpointer,
77
+ middleware: [clientTools()],
78
+ });
79
+ ```
80
+
81
+ 客户端定义的工具会与服务端工具合并使用。
82
+
83
+ ## 依赖
84
+
85
+ - `langchain`：LangChain Agent 框架
86
+ - `@langchain/langgraph`：Agent 会话记忆（MemorySaver）
87
+ - `@langchain/openai`：OpenAI 兼容模型接入
88
+
89
+ ## 文档
90
+
91
+ 📚 完整文档请参阅 [云开发 Agent 开发指南](https://docs.cloudbase.net/ai/agent-development/)
92
+
93
+ ## 相关资源
94
+
95
+ - [AG-UI 协议](https://docs.ag-ui.com)
96
+ - [LangChain 官方文档](https://js.langchain.com/)
97
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cloudbase/agent-adapter-langchain",
3
- "version": "1.0.1-alpha.7",
3
+ "version": "1.0.1-alpha.8",
4
4
  "description": "LangChain adapter for AG-Kit agents",
5
5
  "files": [
6
6
  "dist/",
@@ -41,14 +41,14 @@
41
41
  "@langchain/langgraph": "^1.0.7",
42
42
  "langchain": "^1.0.2",
43
43
  "zod": "^3.25.0 || ^4.0.0",
44
- "@cloudbase/agent-agents": "1.0.1-alpha.7",
45
- "@cloudbase/agent-adapter-langgraph": "1.0.1-alpha.7",
46
- "@cloudbase/agent-tools": "1.0.1-alpha.7"
44
+ "@cloudbase/agent-adapter-langgraph": "1.0.1-alpha.8",
45
+ "@cloudbase/agent-tools": "1.0.1-alpha.8",
46
+ "@cloudbase/agent-agents": "1.0.1-alpha.8"
47
47
  },
48
48
  "peerDependencies": {
49
49
  "zod": "^3.25.0 || ^4.0.0",
50
- "@cloudbase/agent-adapter-langgraph": "1.0.1-alpha.7",
51
- "@cloudbase/agent-agents": "1.0.1-alpha.7"
50
+ "@cloudbase/agent-adapter-langgraph": "1.0.1-alpha.8",
51
+ "@cloudbase/agent-agents": "1.0.1-alpha.8"
52
52
  },
53
53
  "scripts": {
54
54
  "test": "echo \"Error: no test specified\" && exit 1",