news 2026/10/19 20:12:14

本地运行LangChain Agent用于开发调试

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
本地运行LangChain Agent用于开发调试

在基于DeepAgents轻松构建 AI Coding Agent这篇文章中,我介绍了如何基于最新的 LangChain 1.0 和 DeepAgents 轻松构建一个简单但却功能强大和全面的 Coding Agent,其中还通过子 Agent 实现了代码审查、测试生成、文档生成、调试和代码重构等能力。

那么,当完成了一个 Agent 的开发后,我们应该如何在本地进行快速地测试、调试和验证呢?好在 LangChain 生态很完善,它提供了LangSmith Deployment、LangGraph CLI、Agent Chat UI等工具,涵盖了后端 agent 服务部署、前端 UI 交互等功能,可以帮助我们很方便地在本地进行验证开发和调测。

接下来就基于deep-code-agent这个项目具体聊聊如何使用 LangChain 的这些工具进行 Agent 的测试和开发。

项目环境准备

从源码安装

  1. 克隆仓库

    gitclone https://github.com/hzhaoy/deep-code-agent.gitcddeep-code-agent
  2. 安装依赖

    uvsync

通过uv sync一个命令,就可以完成从 python 虚拟环境创建到项目依赖安装的所有工作,其中用于部署 Agent 服务的依赖主要是"langgraph-cli[inmem]",它提供了langgraph dev的启动部署命令,用于部署 Agent 服务。

项目配置

这里主要是环境变量的设置,通过新建一个.env文件进行配置:

  1. 从示例模板创建一个.env 文件

    cp.env.example .env
  2. 使用你的配置编辑.env文件:

    # OpenAI API ConfigurationOPENAI_API_KEY=your-openai-api-key-here OPENAI_API_BASE=https://api.openai.com/v1# LLM Model ConfigurationMODEL_NAME=your-model-name-here

Agent

这里我们需要新建一个目录用于保存测试所需的文件,可以放在项目根目录下(比如项目目录下的 server,这里也以根目录下的server目录为例进行说明),也可以是其他任意的位置。

然后创建一个用于调试的 Agent,后续用于部署服务和前端交互:

fromdeep_code_agentimportcreate_code_agent agent=create_code_agent(codebase_dir="/tmp/test")

将上面的代码保存为一个名为agent.py的 python 文件,并放在server目录下

LangGraph配置文件

创建一个名为langgraph.json的文件,输入以下内容,并放置在server目录下:

{"$schema":"https://langgra.ph/schema.json","dependencies":["."],"graphs":{"agent":"agent:agent"}}

这是使用 langgraph-cli 启动服务时所需的配置文件,简单解释下几个字段的含义:

  • $schema:JSON配置文件遵循的 schema,按官方固定值配置即可
  • dependencies:这是必填项,指定 LangGraph API 服务器的所需的依赖项数组。这里使用一个单独的句点(".")表示使用本地的Python包。
  • graphs:必填项。从 Graph ID 到具体的 Agent 定义的映射。
    在这里,agent为 Graph ID,用于后续在前端指定与哪个 agent 进行交互;
    agent:agent表示当前目录下 agent.py 这个模块中名为 agent 的变量所定义的智能体

启动LangGraph API 服务器

进入 server 目录,执行以下命令:

uv run langgraph dev

如果服务成功启动,你将看到类似以下的输出:

INFO:langgraph_api.cli: Welcome to ╦ ┌─┐┌┐┌┌─┐╔═╗┬─┐┌─┐┌─┐┬ ┬ ║ ├─┤││││ ┬║ ╦├┬┘├─┤├─┘├─┤ ╩═╝┴ ┴┘└┘└─┘╚═╝┴└─┴ ┴┴ ┴ ┴ - 🚀 API: http://127.0.0.1:2024 - 🎨 Studio UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024 - 📚 API Docs: http://127.0.0.1:2024/docs This in-memory server is designed for development and testing. For production use, please use LangSmith Deployment.

Chat UI 交互

访问 Agent Chat UI,输入上面显示的API URL(这里是http://127.0.0.1:2024)以及Graph ID(在这里是agent)。然后,点击“Continue”后就可以开始与该agent 进行交互了,如下所示:


在交互界面上,你可以直接与你开发的 Agent 进行对话,查看 Agent 的输出、工具调用情况、工具返回结果等,这些内容对于 Agent 的开发调试是很有帮助的。

一个交互示例

最后,贴上一个使用 deep-code-agent 完成编码任务的示例:

agent_demo

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/20 17:44:58

EmotiVoice语音合成服务健康检查机制

EmotiVoice语音合成服务健康检查机制 在构建高可用的AI语音服务时,一个常被低估却至关重要的环节是——如何准确判断服务到底“活着”没有? 听起来像句废话:服务挂了当然知道啊。但现实远比想象复杂。你有没有遇到过这样的情况:AP…

作者头像 李华
网站建设 2026/10/20 3:07:48

告别机械音!EmotiVoice实现自然情感语音合成

告别机械音!EmotiVoice实现自然情感语音合成 在智能音箱里听到的语音总是冷冰冰的?游戏角色说话像念稿,毫无情绪起伏?这些“机械音”体验的背后,是传统文本转语音(TTS)系统长期存在的痛点&#…

作者头像 李华
网站建设 2026/10/20 9:47:45

电机生产车间设备看板物联网方案

某电机制造商受限于传统生产管理模式的弊端,难以适应高精度、多品种、定制化的新型生产节奏,严重制约了企业在效率、品质与成本方面的精细化管控需求。现要求对生产车间进行数字化改造,打造可视化设备看板以实现对多个设备的监控与管理。由于…

作者头像 李华
网站建设 2026/10/20 17:09:33

mysql建表后的数据填入

1.添加指定字段数据insert into 表名 (字段1,字段2...) values (值1,值2...);insert into 表名 values (值1,值2,值3,...); 值与创建表的字段名一一对应2.添加批量数据insert into 表名 (字段1,字段2,字段3) values (值1,值2,...),(值1,值2,.…

作者头像 李华
网站建设 2026/10/19 21:16:20

Observe · Secure · AI|观测云2025中国可观测日深圳站圆满收官

12 月 10 日,观测云 2025 可观测日深圳站成功举办。来自云计算、AI、运维与工程领域的行业专家、企业技术负责人齐聚深圳,在一个下午的深度交流中,共同探讨 AI 时代下,可观测性的进化方向与落地路径。它不是一场“单向输出”的技术…

作者头像 李华