ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Context Engineering 实战指南:在 mcp-for-beginners 项目中设计与维护 AI 上下文

Context Engineering 实战指南:在 mcp-for-beginners 项目中设计与维护 AI 上下文 教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载导读本指南以mcp-for-beginners开源课程中 05-AdvancedTopics/mcp-contextengineering/README.md 为骨架系统讲解 Context Engineering上下文工程这一新兴概念——它研究信息如何被结构化、交付并在客户端与 AI 服务之间持续维护。读完本文你将掌握上下文工程的定义与五大关注领域、信息在 MCP 系统中的旅程视角、三条早期原则、MCP 协议对五大上下文挑战的设计响应以及上下文分块、渐进式加载、压缩摘要等可落地的实践方法与评估框架。什么是 Context EngineeringContext engineering 是 AI 领域一个正在形成的新兴概念它聚焦于信息流的刻意设计与治理用户、应用与 AI 模型之间信息应当如何被组织、传递并随时间演进。与早已成形的提示工程prompt engineering不同上下文工程仍处于实践者不断定义的阶段——它要解决的核心问题是如何在正确的时间为 AI 模型提供正确的信息。随着大语言模型LLM能力的演进上下文的重要性愈发凸显上下文的质量、相关性与结构会直接影响模型输出。上下文工程正是要研究这层关系并逐步提炼出有效的上下文管理原则。Cognition AI 的 Walden Yan 在 2025 年的一段论述很好地概括了这一概念的定位2025 年的模型已经极度聪明。但即便最聪明的人如果没有被告知任务所需的上下文也无法高效完成工作……Context engineering 是提示工程的下一级形态它是在一个动态系统中自动完成这件事。围绕这一目标上下文工程大体涵盖五个关注领域上下文选择Context Selection判断某项任务需要哪些信息上下文结构化Context Structuring组织信息以最大化模型的理解效果上下文交付Context Delivery优化信息发送给模型的方式与时机上下文维护Context Maintenance管理上下文随时间演进的状态上下文评估Context Evaluation度量并改进上下文的有效性。这五个领域与 MCP 生态高度相关——MCP 恰好为应用向 LLM 提供上下文提供了一条标准化通道。上下文的旅程视角要直观理解上下文工程可以追踪信息在一套 MCP 系统中流转的完整旅程旅程包含五个关键阶段用户输入User Input来自用户的原始信息文本、图片、文档上下文组装Context Assembly将用户输入与系统上下文、对话历史、检索到的其他信息合并模型处理Model ProcessingAI 模型对组装后的上下文进行处理响应生成Response Generation模型基于给定上下文产生输出状态管理State Management系统根据本次交互更新内部状态并影响下一轮交互。这一视角揭示了 AI 系统中上下文的动态本质也提出了一系列关键问题在每个阶段信息应当如何被最优地管理这正是上下文工程要回答的问题。新兴的上下文工程原则随着领域成形实践者中开始浮现一些早期原则。它们尚未成为公认最佳实践但足以指导 MCP 的实现选择。原则一完整共享上下文Share Context Completely上下文应当在系统的所有组件之间完整共享而不是被碎片化地分散在多个智能体或进程之中。当上下文被分散时系统某一部分做出的决策可能与另一部分冲突。在 MCP 应用中这要求我们设计出让上下文贯穿整个流水线无缝流动的系统而不是把上下文关进彼此隔离的隔间。本仓库的对抗式多智能体示例就是这一原则的实践在 05-AdvancedTopics/mcp-adversarial-agents/README.md 中正反双方智能体共享同一个 MCP 工具集与同一个 ClientSession代码中以one shared session贯穿run_debate从而消除信息不对称——双方的分歧反映的是推理差异而非数据获取差异。原则二行动携带隐式决策Actions Carry Implicit Decisions模型采取的每一个动作都隐含着对上下文如何解读的决策。当多个组件基于不同上下文行动时这些隐式决策可能相互冲突导致不一致的结果。对 MCP 应用而言这一原则有三条重要推论复杂任务优先线性处理而非带碎片化上下文的并行执行确保所有决策点都能访问相同的上下文信息设计让后续步骤可以看到先前决策的完整上下文的系统。原则三平衡上下文深度与窗口限制Balance Context Depth with Window Limitations随着对话与流程不断变长上下文窗口终将溢出。有效的上下文工程要探索如何在全面上下文与技术限制之间取得平衡。目前被探索的潜在手段包括上下文压缩在保留关键信息的同时降低 token 占用渐进式加载根据与当前需求的关联度按需加载上下文交互摘要对先前交互做摘要同时保留关键决策与事实。上下文挑战与 MCP 协议设计MCP 协议在设计之初就意识到了上下文管理的独特挑战。理解这些挑战有助于解释 MCP 协议设计的关键特性。挑战一上下文窗口限制大多数 AI 模型拥有固定的上下文窗口大小一次能处理的信息量有限。MCP 设计响应协议支持结构化、基于资源resource的上下文可通过引用高效访问资源支持分页与渐进加载。本仓库的 04-PracticalImplementation/pagination/README.md 给出了这一响应的完整落地细节MCP 采用基于游标cursor的分页tools/list、resources/list、prompts/list、resources/templates/list四个方法均支持分页客户端通过带 cursor → 收到nextCursor→ 再次请求的循环逐页拉取服务端则把游标设计为索引、ID 或编码状态三种策略并建议在数据源处而非客户端分页避免一次性加载百万级记录造成内存耗尽与超时。挑战二相关性判定判断哪些信息最值得放进上下文是困难的。MCP 设计响应灵活的工具tooling机制支持按需动态检索信息结构化提示词保证上下文组织的一致性。仓库中的实时搜索示例是典型佐证05-AdvancedTopics/web-search-mcp/server.py 通过mcp.tool()暴露general_search等工具由模型在需要时动态发起 SerpAPI 检索num_results默认 5可传参调整把外部世界的信息按需注入上下文05-AdvancedTopics/mcp-realtimesearch/README.md 则进一步总结了上下文连续性、动态查询重构等技巧强调跨多次查询保持用户意图。挑战三上下文持久化跨交互管理状态需要对上下文演化进行细致跟踪。MCP 设计响应随协议版本演进早期版本2025-11-25依赖标准化会话管理Streamable HTTP 通过initialize握手返回Mcp-Session-Id后续请求携带该头当前版本2026-07-28改为无状态协议核心。正如 01-CoreConcepts/mcp-2026-07-28.md 所述initialize握手与协议级会话被移除协议版本、客户端信息与能力全部移入每个请求的_meta状态管理退回到 HTTP API 的经典模式——用一次tools/call铸造显式句柄如basket_id、browser_id模型在后续调用中把它作为普通参数传回。这一演进本身就是一次深刻的上下文工程实践把状态从传输层元数据藏起来变成对模型可见、可推理的显式上下文从而让任何服务器实例都能处理任何请求水平扩展不再依赖粘性会话。挑战四多模态上下文不同类型的数据文本、图片、结构化数据需要不同的处理方式。MCP 设计响应协议设计容纳多种内容类型提供多模态信息的标准化表示。挑战五安全与隐私上下文常常包含必须受到保护的敏感信息。MCP 设计响应明确客户端与服务器之间的责任边界提供本地处理选项以最小化数据暴露。四种新兴的上下文工程实践方法以下方法代表当前实践者的思路尚未成为既定最佳实践会随着 MCP 落地经验积累而演化。方法一单线程线性处理Single-Threaded Linear Processing与把上下文分发到多处的多智能体架构相反部分实践者发现单线程线性处理能产出更一致的结果——这与维护统一上下文的原则一致。虽然看似不如并行处理高效但每一步都建立在对先前决策的完整理解之上因此往往产生更连贯、更可靠的结果。与之对照05-AdvancedTopics/mcp-adversarial-agents/README.md 展示的多智能体模式则必须通过共享工具集 辩论记录 裁判智能体来对冲上下文碎片化的风险。方法二上下文分块与优先级排序Context Chunking and Prioritization把大上下文切成可管理的块并优先选取最重要的部分# Conceptual Example: Context Chunking and Prioritization def process_with_chunked_context(documents, query): # 1. Break documents into smaller chunks chunks chunk_documents(documents) # 2. Calculate relevance scores for each chunk scored_chunks [(chunk, calculate_relevance(chunk, query)) for chunk in chunks] # 3. Sort chunks by relevance score sorted_chunks sorted(scored_chunks, keylambda x: x[1], reverseTrue) # 4. Use the most relevant chunks as context context create_context_from_chunks([chunk for chunk, score in sorted_chunks[:5]]) # 5. Process with the prioritized context return generate_response(context, query)这一概念展示了如何把大文档切成小块、只选出最相关的部分送入上下文。它能在上下文窗口限制之内工作同时仍然利用大型知识库。这与 MCP 的分页机制天然互补服务端先通过resources/list分页暴露资源模型再按相关性决定读取哪些资源内容。方法三渐进式上下文加载Progressive Context Loading按需渐进加载上下文而非一次性全量加载渐进式上下文加载从最小上下文开始仅在必要时扩展。对于简单查询它可以显著降低 token 消耗同时保留处理复杂问题的能力。这与2026-07-28协议的多轮往返请求Multi Round-Trip Requests机制在精神上一致——服务器在处理请求途中发现需要更多信息时返回InputRequiredResult请求客户端补充输入再携带requestState重试原请求详见 01-CoreConcepts/mcp-2026-07-28.md。方法四上下文压缩与摘要Context Compression and Summarization在保留关键信息的前提下缩减上下文规模上下文压缩聚焦于移除冗余信息摘要冗长内容抽取关键事实与细节保留关键上下文要素优化 token 效率。这一方法对于在上下文窗口内维持长对话、高效处理大文档尤其有价值。一些实践者已开始使用专门的模型来压缩和摘要对话历史。探索性的上下文工程考量以下考量并非规定性最佳实践而是可能在你特定场景中带来改进的探索方向。明确你的上下文目标在实现复杂的上下文管理方案之前先清晰地说明目标模型要成功完成任务具体需要哪些信息哪些信息是必需的哪些只是补充性的你的性能约束是什么延迟、token 限额、成本探索分层上下文Layered Context一些实践者发现按概念分层组织上下文效果良好核心层Core Layer模型始终需要的关键信息情境层Situational Layer当前交互专属的上下文支撑层Supporting Layer可能有帮助的附加信息回退层Fallback Layer仅在需要时访问的信息。研究检索策略Retrieval Strategies上下文的有效性往往取决于如何检索信息语义搜索与向量嵌入查找概念上相关的信息基于关键词的搜索查找特定事实细节混合方法组合多种检索手段元数据过滤按类别、日期或来源缩小检索范围。实验上下文一致性Context Coherence上下文的结构与流动可能影响模型的理解效果将相关信息分组放置使用一致的格式与组织方式在合适处保持逻辑或时间顺序避免相互矛盾的信息。权衡多智能体架构的代价多智能体架构在许多 AI 框架中流行但它给上下文管理带来显著挑战上下文碎片化可能导致各智能体决策不一致并行处理可能引入难以调和的冲突智能体间的通信开销可能抵消性能收益维持连贯性需要复杂的状态管理。在很多场景下**单智能体 全面上下文管理**比多个专精智能体 碎片化上下文更能产出可靠结果。这与本仓库 05-AdvancedTopics/mcp-adversarial-agents/README.md 的设计互为印证即使采用多智能体也必须通过共享 MCP 会话保证信息环境一致否则辩论失去意义。发展评估方法要持续改进上下文工程请思考如何度量成功对不同上下文结构做A/B 测试监控token 用量与响应时间跟踪用户满意度与任务完成率分析上下文策略何时、为何失败。度量上下文有效性一个演进中的框架上下文工程作为一个新兴概念尚无既定度量框架但一些候选指标正在被讨论可用于指导未来工作。潜在度量维度1. 输入效率维度上下文-响应比Context-to-Response Ratio相对响应规模需要多少上下文Token 利用率Token Utilization提供的上下文 token 有多大比例实际影响了响应上下文缩减Context Reduction原始信息能被多有效地压缩2. 性能维度延迟影响Latency Impact上下文管理如何影响响应时间Token 经济性Token Economytoken 用量是否得到有效优化检索精度Retrieval Precision检索到的信息有多相关资源利用Resource Utilization需要多少计算资源3. 质量维度响应相关性Response Relevance响应在多大程度上回答了查询事实准确性Factual Accuracy上下文管理是否提升了事实正确性一致性Consistency相似查询的响应是否稳定一致幻觉率Hallucination Rate更好的上下文能否降低模型幻觉4. 用户体验维度追问率Follow-up Rate用户需要多少次澄清任务完成度Task Completion用户是否成功达成目标满意度指标Satisfaction Indicators用户如何评价体验探索性度量方法在 MCP 实现中实验上下文工程时可考虑以下探索路径基线比较Baseline Comparisons先用简单上下文方案建立基线再测试更复杂的方法增量变化Incremental Changes一次只改变上下文管理的一个方面以隔离其效果以用户为中心的评估User-Centered Evaluation将定量指标与定性用户反馈结合失败分析Failure Analysis检查上下文策略失败的案例寻找改进方向多维评估Multi-Dimensional Assessment在效率、质量与用户体验之间权衡取舍。这种实验性、多面的度量方式与上下文工程自身正在成形的性质是吻合的。未来方向上下文工程仍处于早期阶段但几个有前景的方向正在浮现上下文工程原则可能显著影响模型性能、效率、用户体验与可靠性对许多用例而言带全面上下文管理的单线程方法可能优于多智能体架构专门的上下文压缩模型可能成为 AI 流水线的标准组件上下文完整性与 token 限制之间的张力将驱动上下文处理技术的创新随着模型在高效类人沟通上变得更强大真正的多智能体协作可能变得更加可行MCP 实现可能逐步标准化当前实验中涌现出的上下文管理模式。结语与仓库内延伸阅读上下文工程是一个新兴的探索领域很可能成为高效 MCP 应用的核心。通过审慎思考信息如何在系统中流动你有可能创造出更高效、更准确、对用户更有价值的 AI 体验。本文介绍的技术与方法是该领域的早期思考而非既定实践实验 审慎度量是目前最具生产力的路径。随着 AI 能力演进与理解深化上下文工程有望发展为一门更成体系、更明确的学科。若想在本仓库中继续深入建议按以下顺序阅读01-CoreConcepts/mcp-2026-07-28.md理解无状态协议、显式句柄状态模式与多轮往返请求是上下文持久化挑战的最新协议背景04-PracticalImplementation/pagination/README.md游标分页的完整服务端/客户端实现对应资源可分页、可渐进加载的设计响应05-AdvancedTopics/mcp-root-contexts/README.md学习 Roots 的弃用状态与替代方案工具参数、资源 URI、服务器配置05-AdvancedTopics/mcp-adversarial-agents/README.md对抗式多智能体架构如何通过共享 MCP 会话维护统一信息环境05-AdvancedTopics/web-search-mcp/server.py 与 05-AdvancedTopics/mcp-realtimesearch/README.md动态检索与上下文连续性在真实搜索工具中的落地接下来按课程顺序可进入 05-AdvancedTopics/mcp-transport/README.md 学习自定义传输机制。赞分享教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载相关推荐Mermaid Live Editor 在线编辑器敲 5 行字一条链接拿到流程图Mermaid Live Editor 在线编辑器敲 5 行字一条链接拿到流程图 Mermaid Live Editor 是一款免费的 Mermaid 在线前端开发者工具数据可视化基于 Model Context Protocol 的实时 Web 搜索实战指南在 mcp-for-beginners 中构建上下文感知搜索架构基于 Model Context Protocol 的实时 Web 搜索实战指南在 mcp for beginners 中构建上下文感知搜索架构 本篇指南围绕教程文档人工智能CHIPageControl架构设计探究CHIBasePageControl基类的强大扩展性CHIPageControl架构设计探究CHIBasePageControl基类的强大扩展性 CHIPageControl是一款由ChiliLabs开发的SwUI组件移动开发上一篇freeCodeCamp 每日编码挑战 Challenge 10「3 Strikes」统计平方数中包含数字 3 的个数下一篇PyTorch torch.compile 降低 Guard 开销实战install_free_tensors、guard_filter_fn 与 skip_guard_eval_unsafe 详解创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表