收藏这篇就够了！LangGraph+RAG+MCP 终极实战，从零构建能自动操控 Jira 的 AI 智能体！

一个在AI技术领域持续深耕的老司机。在日常开发中，Jira是我们绕不开的项目管理工具。但不知道你有没有这样的痛点：

• 操作繁琐： 创建一个任务，要填一堆字段，点N次下拉框。

• 信息隔离： 任务相关的需求文档、API说明散落在Confluence、Git等各处，查起来费时费力。

• 状态滞后： 任务进度需要人工手动更新，经常与实际情况不符，带来很多烦恼。

如果，我们能有一个“智能秘书”呢？你只需要对它说一句：“帮我把‘用户登录模块优化’这个需求，创建成一个Story，分配给前端小王，优先级高，并把相关的API文档链接附上。”

几秒钟后，Jira里就妥妥地出现了一条规范、信息完整的任务。这，就是我们今天要聊的：基于LangGraph的智能体（Agent），结合RAG和MCP Server，打造一个真正AI赋能的Jira助手。

整个代码框架已经Ready，架构也已跑通，下面我就为大家彻底拆解这个项目。

一、核心架构：让AI学会“思考”和“动手”

在深入的聊技术之前，我们先看看下面的这张架构图，让大家对整个系统有个宏观认识。

架构核心思想：LangGraph作为“大脑”，协调各个“专业工具人”（Tools）来完成复杂任务， 这里RAG作为知识库， 就是个“大仓库” 或者“口袋”， 下面的地盘或者叫“底座”是个LLM（大语言模型）。

我们来逐一拆解图中的核心模块：

1. LangGraph Agent（智能体大脑）

• 角色： 总指挥。它负责理解用户的自然语言指令，并规划执行步骤， 如果执行或者具体处理逻辑都归它管。

• 优势： LangGraph的StateGraph能够完美管理智能体的状态，实现多步骤、有条件的复杂工作流。比如，它可能会先查询知识库，再决定如何创建Jira单。

2. RAG（检索增强生成）- 智能体的“外挂知识库”

• 角色： 领域专家。我们的项目有大量的内部知识，比如代码规范、API文档、历史需求等。

• 工作流：
  索引：将Confluence文档、Git代码注释等内部知识库进行切片、向量化，存入向量数据库（如ElasticSearch / OpenSearch）。
  检索：当用户提问时（例如：“创建任务时，性能测试的标准是什么？”），RAG会从向量库中检索最相关的知识片段。
  增强：将这些片段作为上下文，与用户问题一并送给LLM，让LLM基于“内部知识”生成更精准的回答或执行动作。

3. MCP Server for Jira（智能体的“手和脚”）

• 角色： 实干家。这是最关键的一环！MCP（Model Context Protocol）是新兴的标准化协议，它允许我们以统一的方式为LLM提供工具。

• 功能： 我们封装了一个MCP Server，专门用于操作Jira。它暴露出一系列标准工具函数，例如：
  jira_*get_*issue:Get details of a specific issue
  jira_search:Search issues using JQL
  jira_*create_*issue:Create a new issue
  jira_*update_*issue:Update an existing issue
  jira_*transition_*issue:Transition an issue to a new status
  jira_*add_*comment:Add a comment to an issue

好处： LangGraph Agent可以直接调用这些标准化工具，无需关心Jira REST API的复杂细节，实现了完美的解耦。

二、代码实战：核心流程一览

代码框架已经Ready，这里贴出最核心的LangGraph图定义和执行流程，让大家感受一下其简洁和强大。

from typing import Dict, Anyfrom langgraph.graph import StateGraph, ENDfrom src.core.state import AgentStatefrom src.agents.router import AgentRouterfrom src.agents.jira_agent import JiraAgentfrom src.agents.conference_agent import ConferenceAgentimport logging# Set up logginglogging.basicConfig(level=logging.INFO)logger = logging.getLogger(__name__)classGraphManager:    """    Manages the LangGraph workflow for the agent system.    """        def__init__(self):         # 初始化GraphManager，创建所需的代理和图构建器        logger.info("Initializing GraphManager")        self.router = AgentRouter() # 路由代理，负责请求分发        self.jira_agent = JiraAgent() # Jira代理，处理Jira相关操作        self.conference_agent = ConferenceAgent()        self.builder = StateGraph(AgentState) # 基于AgentState的状态图构建器        self._setup_graph() # 设置图结构        def_setup_graph(self):        """        Set up the graph nodes and edges.        """        logger.info("Setting up graph nodes and edges")                # 添加节点        self.builder.add_node("router", self._route_request) # 路由节点        self.builder.add_node("jira_agent", self._process_jira_request) # Jira处理节点        self.builder.add_node("conference_agent", self._process_conference_request)                # 添加条件边，根据_route_decision函数输出决定路由        self.builder.add_conditional_edges(            "router",            self._route_decision,            {                "jira_agent": "jira_agent",                "conference_agent": "conference_agent",                "end": END            }        )                # 添加从Agent到工作流结束的线性边        self.builder.add_edge("jira_agent", END)        self.builder.add_edge("conference_agent", END)                # 设置入口点，所有工作流都从路由器开始        self.builder.set_entry_point("router")        logger.info("Graph setup completed")        def_route_request(self, state: AgentState) -> Dict[str, Any]:        """        Route the request to the appropriate agent.        """        logger.info("Routing request")        return self.router.process(state)        def_process_jira_request(self, state: AgentState) -> Dict[str, Any]:        """        Process a Jira request.        """        logger.info("Processing Jira request")        return self.jira_agent.process(state)        def_process_conference_request(self, state: AgentState) -> Dict[str, Any]:        """        Process a conference request.        """        logger.info("Processing Conference request")        return self.conference_agent.process(state)        def_route_decision(self, state: AgentState) -> str:        """        Make routing decision based on state.        """        # 访问最后一条消息以确定路由        messages = state.get("messages", [])        logger.info(f"Making routing decision based on state. Messages count: {len(messages)}")                ifnot messages:            logger.info("No messages found, routing to end")            return"end"                    # 目前根据current_agent字段进行路由        current_agent = state.get("current_agent", "")        logger.info(f"Current agent: {current_agent}")                if current_agent == "jira":            # 路由到Jira代理            logger.info("Routing to jira_agent")            return"jira_agent"        elif current_agent == "conference":            logger.info("Routing to conference_agent")            return"conference_agent"        else:            logger.info("Routing to end")            return"end"        defcompile(self):        """        Compile and return the graph.        """        logger.info("Compiling graph")        return self.builder.compile()

三、AI赋能Jira：不止于创建任务

这个智能体能做什么？大家可以头脑风暴一下！

1. 自然语言生成任务卡片： 如开篇所述，一句话创建复杂任务。

2. 智能问答与报告：
   “我们Q1季度，哪个模块产生的Bug最多？列出Top3。”
   “把‘电商大促’项目的所有阻塞态任务汇总成一个Markdown报告发到群里。”

3. 自动化工单处理：
   监控日志，自动为频繁出现的Error创建Bug单。
   识别Git Commit Message，自动将关联的任务状态更新为“Resolved”。

4. 上下文感知辅助：
   在任务界面，直接问Agent：“这个任务关联的PR代码评审意见是什么？”（它通过RAG去Git里找）。

智能体运行截图:

本文的项目核心骨架已在Gitee开源，欢迎来点个Star，见证项目的成长：
【Gitee链接】：https://gitee.com/ailearneryang/jira_agent.git

接下来，我也为公众号的读者朋友们准备了一份 “完整版” ，里面包含了项目所有的配置秘钥和部署清单。如果你想快速在本地环境跑起来，只需在后台对我发出接头暗号：【Jira_Agent】 ，我就会把完整资料包发送给你。

四、总结与展望

通过 LangGraph（协调） + RAG（知识） + MCP Server（执行） 这个黄金组合，我们成功地构建了一个能理解、会思考、可执行的AI Agent。

这套架构的可扩展性极强：

• 未来要操作Confluence？再加一个MCP Server即可。

• 要连接Jenkins？同样封装成MCP工具。

• LangGraph会轻松地将它们纳入统一的工作流中。

技术栈总结：

• Agent框架： LangGraph

• 大模型： 开源LLM，比如Qwen3，DeepSeek，gpt-oss

• 工具协议： MCP

• 知识库： RAG (ElasticSearch / OpenSearch + 文本嵌入模型)

• 目标系统： Jira (REST API)

AI不是飘在空中的概念，而是能落地解决实际问题的利器。希望这个实战项目能给你带来启发。如果你对LangGraph、MCP或者RAG的细节感兴趣，欢迎在评论区留言，我们可以再开专题深入讨论。

觉得这篇文章干货满满吗？关注我！点赞、收藏、转发三连，让更多的小伙伴看到AI技术的魅力！

如何学习大模型 AI ？

我国在AI大模型领域面临人才短缺，数量与质量均落后于发达国家。2023年，人才缺口已超百万，凸显培养不足。随着Al技术飞速发展，预计到2025年，这一缺口将急剧扩大至400万，严重制约我国Al产业的创新步伐。加强人才培养，优化教育体系，国际合作并进，是破解困局、推动AI发展的关键。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

2025最新大模型学习路线

明确的学习路线至关重要。它能指引新人起点、规划学习顺序、明确核心知识点。大模型领域涉及的知识点非常广泛，没有明确的学习路线可能会导致新人感到迷茫，不知道应该专注于哪些内容。

对于从来没有接触过AI大模型的同学，我帮大家准备了从零基础到精通学习成长路线图以及学习规划。可以说是最科学最系统的学习路线。

针对以上大模型的学习路线我们也整理了对应的学习视频教程，和配套的学习资料。

大模型经典PDF书籍

新手必备的大模型学习PDF书单来了！全是硬核知识，帮你少走弯路！

配套大模型项目实战

所有视频教程所涉及的实战项目和项目源码等

博主介绍＋AI项目案例集锦

MoPaaS专注于Al技术能力建设与应用场景开发，与智学优课联合孵化，培养适合未来发展需求的技术性人才和应用型领袖。

这份完整版的大模型 AI 学习资料已经上传优快云，朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】

为什么要学习大模型？

2025人工智能大模型的技术岗位与能力培养随着人工智能技术的迅速发展和应用 ， 大模型作为其中的重要组成部分 ， 正逐渐成为推动人工智能发展的重要引擎 。大模型以其强大的数据处理和模式识别能力， 广泛应用于自然语言处理 、计算机视觉 、 智能推荐等领域 ，为各行各业带来了革命性的改变和机遇 。

适合人群

• 在校学生：包括专科、本科、硕士和博士研究生。学生应具备扎实的编程基础和一定的数学基础，有志于深入AGI大模型行业，希望开展相关的研究和开发工作。
• IT行业从业人员：包括在职或失业者，涵盖开发、测试、运维、产品经理等职务。拥有一定的IT从业经验，至少1年以上的编程工作经验，对大模型技术感兴趣或有业务需求，希望通过课程提升自身在IT领域的竞争力。
• IT管理及技术研究领域人员：包括技术经理、技术负责人、CTO、架构师、研究员等角色。这些人员需要跟随技术发展趋势，主导技术创新，推动大模型技术在企业业务中的应用与改造。
• 传统AI从业人员：包括算法工程师、机器视觉工程师、深度学习工程师等。这些AI技术人才原先从事机器视觉、自然语言处理、推荐系统等领域工作，现需要快速补充大模型技术能力，获得大模型训练微调的实操技能，以适应新的技术发展趋势。
  

课程精彩瞬间

大模型核心原理与Prompt：掌握大语言模型的核心知识，了解行业应用与趋势；熟练Python编程，提升提示工程技能，为Al应用开发打下坚实基础。

RAG应用开发工程：掌握RAG应用开发全流程，理解前沿技术，提升商业化分析与优化能力，通过实战项目加深理解与应用。

Agent应用架构进阶实践：掌握大模型Agent技术的核心原理与实践应用，能够独立完成Agent系统的设计与开发，提升多智能体协同与复杂任务处理的能力，为AI产品的创新与优化提供有力支持。

模型微调与私有化大模型：掌握大模型微调与私有化部署技能，提升模型优化与部署能力，为大模型项目落地打下坚实基础。

顶尖师资，深耕AI大模型前沿技术

实战专家亲授，让你少走弯路

一对一学习规划，职业生涯指导

• 真实商业项目实训
• 大厂绿色直通车

人才库优秀学员参与真实商业项目实训
以商业交付标准作为学习标准，具备真实大模型项目实践操作经验可写入简历，支持项目背调
大厂绿色直通车，冲击行业高薪岗位

文中涉及到的完整版的大模型 AI 学习资料已经上传优快云，朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】