langgraph-for-agents — 使用 LangGraph/LangChain 构建智能代理
v1.0.2本技能提供了使用 LangGraph 和 LangChain 构建智能代理的示例代码和指导文档。它涵盖了如何设计单代理系统和多代理系统,如何选择框架(LangGraph 或 LangChain),以及如何实现具体的代理逻辑。同时,包含了项目结构建议、安全注意事项(如环境变量配置、依赖安装、安全代码实践)和最佳实践(如优先使用原生工具、单文件开发、清晰代码风格).
0· 90·0 当前·0 累计
安全扫描
OpenClaw
可疑
medium confidence技能描述与示例代码匹配,但环境变量、依赖和外部资源指导存在不一致或不明确的地方。
评估建议
此技能是 LangGraph/LangChain 代理构建的示例代码和指导文档。使用前需注意:环境变量声明不明确、依赖未记录、示例代码中存在安全风险(如使用 eval)、外部资源 URL 不是官方文档。建议仅作为文档参考,运行示例前必须仔细检查和配置。...详细分析 ▾
ℹ 用途与能力
名称/描述和参考代码文件都聚焦于 LangGraph/LangChain 代理模式,一致性良好。然而,软件包包含许多导入众多第三方库的示例脚本(langchain_openai、langgraph、langchain_community、pydantic、bs4 等),尽管技能元数据中未声明任何必需的二进制文件、包或环境变量;这表明声明的最小要求和示例的实际依赖面之间存在不匹配。
ℹ 指令范围
SKILL.md 指示代理阅读 ./references 示例(README + 样本 .py 文件),使用占位符 API_KEY 值而不是硬编码秘密。它还建议如果可用使用搜索/浏览/获取工具,并指向特定的外部 URL(https://context7.com/...)。指令不明确地告诉代理执行示例代码,但鼓励阅读和可能获取外部内容;该外部获取目标不是官方项目文档,可能是爬取的/第三方镜像。
ℹ 安装机制
没有安装规格(仅指令),这降低了安装时的风险。然而,包含的参考脚本需要很多运行时包;元数据中缺乏安装规范或依赖列表令人惊讶,可能会误导用户关于实际运行示例所需安装的内容。
⚠ 凭证需求
技能元数据未声明任何必需的环境变量,但每个参考文件都调用 load_dotenv() 并重复使用 os.getenv('your-api-key')。SKILL.md 提到一个通用 API_KEY 占位符,但未声明确切的环境变量名。这一不匹配是误导性的:示例明确需要凭证来调用 LLM,但注册表条目没有请求或记录任何特定的凭证名。另外,一些示例代码使用 eval()(计算器工具),如果运行示例,可能会执行不受信任的输入。
✓ 持久化与权限
技能不请求 always:true,不声明系统配置路径或尝试修改其他技能,并且允许使用正常的代理调用。元数据中没有请求提高持久性或权限。
⚠ references/langchain_chatmodel_custom_tool.py:24
检测到动态代码执行。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.22026/3/22
省略特定大型语言模型提供商的名称。
● 可疑
安装命令 点击复制
官方npx clawhub@latest install langgraph-for-agents
镜像加速npx clawhub@latest install langgraph-for-agents --registry https://cn.clawhub-mirror.com
技能文档
何时使用
- 当用户请求使用 LangGraph/LangChain 构建代理或多代理系统时使用此技能。
如何引用
集成参考示例
阅读 "./references/" 中的示例以了解常见模式。从 "./references/README.md" 开始,了解概览,然后阅读目标文件以获取更多细节。 !Important: 构建代理需要API_KEY 凭证。这是用户隐私,请不要硬编码,仅使用占位符(如 API_KEY=your-api-key),让用户管理实际密钥。
外部资源
[搜索] 如果有 "搜索" 工具,可精细化查询关键词并执行搜索。 [浏览] 如果有 "浏览" 工具,可访问以下网站:- LangGraph 官方 GitHub 仓库(https://github.com/langchain-ai/langgraph)
- LangGraph 官方文档(https://docs.langchain.com/oss/python/langgraph/overview)
- LangChain 官方文档(https://docs.langchain.com/oss/python/langchain/overview)
- Context-7 LangGraph(https://context7.com/websites/langchain_oss_python_langgraph/llms.txt?tokens=10000)
tokens 参数调整令牌数量,默认值为 10,000。
项目结构
对于演示或测试,使用单个 .py 文件。对于生产级应用:├── app/
│ ├── api/ # API 端点
│ ├── backend/ # LangGraph/LangChain 逻辑
│ └── frontend/ # 用户界面
├── .env.example
├── requirements.txt
└── README.md
代理系统设计流程
步骤 1:确定系统级别
- 单代理系统:关注单个代理的内部结构。
- 多代理系统:关注多个代理之间的协作和通信。
步骤 2:选择框架
- LangGraph:适用于有状态、复杂工作流的场景。
- LangChain:适用于基于工具调用的一般代理模式。
步骤 3:设计具体实现
对于单代理系统:
- 使用 LangGraph:构建具有多个节点的工作流,或者实现带有手动 tool_node 的 ReAct 代理。
- 使用 LangChain:使用
create_agentAPI 构建 ReAct 代理。
对于多代理系统:
- 使用 LangGraph:
- 使用 LangChain:创建主 ReAct 代理,并将其他代理封装为工具以实现协作。
构建哲学
- 优先使用原生:在自定义构建前检查 LangChain 是否已有工具或集成。
- 单文件优先:最初将核心逻辑保持在一个文件中以简化调试。
- 清晰代码:仅提供必要的注释,使用清晰的描述性变量名。
- 真实数据:尽可能使用实际 API URL 和架构。
数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制