{"id":1563,"date":"2026-03-18T20:08:45","date_gmt":"2026-03-18T12:08:45","guid":{"rendered":"http:\/\/www.cmd137blog.top\/?p=1563"},"modified":"2026-03-19T22:58:06","modified_gmt":"2026-03-19T14:58:06","slug":"langchain-%e9%95%bf%e6%9c%9fmemory%e4%b8%89%e5%89%91%e5%ae%a2%e5%ae%9e%e6%88%98%ef%bc%9aredis-chatmessagehistory-%e6%89%93%e9%80%a0%e5%a4%9a%e7%94%a8%e6%88%b7-ai-%e5%ae%a2%e6%9c%8d","status":"publish","type":"post","link":"http:\/\/www.cmd137blog.top\/?p=1563","title":{"rendered":"LangChain \u957f\u671fmemory\u4e09\u5251\u5ba2\u5b9e\u6218\uff1aRedis + ChatMessageHistory \u6253\u9020\u591a\u7528\u6237 AI \u5ba2\u670d"},"content":{"rendered":"\n<p>\u6b64\u9879\u76ee\u6f14\u793a LangChain \u5728\u751f\u4ea7\u73af\u5883\u4e2d\u63a8\u8350\u7684\u201cChatMessageHistory + RunnableWithMessageHistory + \u5916\u90e8\u5b58\u50a8\uff08Redis\uff09\u201d\u7ec4\u5408\uff0c\u6784\u5efa\u4e00\u4e2a\u591a\u7528\u6237 AI \u5ba2\u670d\u63a5\u53e3\u3002\u6240\u6709\u5386\u53f2\u8bb0\u5f55\u90fd\u6309\u7167&nbsp;<code>user_id<\/code>&nbsp;\u7ef4\u5ea6\u7f13\u5b58\u5728 Redis \u4e2d\uff0c\u9002\u5408\u63a5\u5165 Web\/\u5c0f\u7a0b\u5e8f\/\u5ba2\u670d\u5de5\u4f5c\u53f0\u7b49\u573a\u666f\uff1b\u6a21\u578b\u4fa7\u9ed8\u8ba4\u8c03\u7528\u901a\u4e49\u5343\u95ee&nbsp;<code>qwen-max<\/code>\u3002<br><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>LangChain LCEL<\/strong>\uff1a<code>ChatPromptTemplate<\/code>&nbsp;+&nbsp;<code>MessagesPlaceholder<\/code>&nbsp;+&nbsp;<code>RunnableWithMessageHistory<\/code>&nbsp;\u81ea\u52a8\u6ce8\u5165\u5386\u53f2\u3002<\/li>\n\n\n\n<li><strong>RedisChatMessageHistory<\/strong>\uff1a\u590d\u7528\u793e\u533a\u5b9e\u73b0\uff0c\u652f\u6301 TTL\u3001\u6c34\u5e73\u6269\u5c55\u548c\u6570\u636e\u6dd8\u6c70\u7b56\u7565\u3002<\/li>\n\n\n\n<li><strong>FastAPI<\/strong>\uff1a\u63d0\u4f9b&nbsp;<code>\/chat<\/code>&nbsp;\u4e0e&nbsp;<code>\/health<\/code>&nbsp;\u63a5\u53e3\uff0c\u65b9\u4fbf\u5bb9\u5668\u5316\u90e8\u7f72\u6216\u4e0e API \u7f51\u5173\u96c6\u6210\u3002<\/li>\n<\/ul>\n\n\n\n<p><strong>\u4e3a\u4ec0\u4e48\u4e0d\u7528\u65e7\u7248 Memory\uff1f<\/strong>&nbsp;\u65e7 Memory API \u4e0d\u652f\u6301\u5f02\u6b65 + \u6d41\u5f0f + \u591a Session \u9694\u79bb\uff0c\u5b98\u65b9\u4ec5\u5efa\u8bae\u5728\u539f\u578b\u9636\u6bb5\u4f7f\u7528\uff0c\u672c\u793a\u4f8b\u4f53\u73b0\u4e86\u63a8\u8350\u505a\u6cd5\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"\u4ee3\u7801\u8981\u70b9\">\u4ee3\u7801\u8981\u70b9<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>app\/main.py<\/code>&nbsp;\u4e2d\u7684&nbsp;<code>conversation_chain<\/code>&nbsp;\u5b9a\u4e49\u4e86\u4e3b\u94fe\u8def\uff1a<code>Prompt -&gt; ChatTongyi -&gt; StrOutputParser<\/code>\u3002<\/li>\n\n\n\n<li><code>RunnableWithMessageHistory<\/code>&nbsp;\u8d1f\u8d23\u5728\u6bcf\u6b21\u8c03\u7528\u524d\u540e\u81ea\u52a8\u8ffd\u52a0\u6d88\u606f\uff1b<code>history_messages_key=\"history\"<\/code>&nbsp;\u8981\u4e0e&nbsp;<code>MessagesPlaceholder<\/code>&nbsp;\u4e00\u81f4\u3002<\/li>\n\n\n\n<li><code>get_history(session_id)<\/code>&nbsp;\u8fd4\u56de&nbsp;<code>RedisChatMessageHistory<\/code>\uff0c\u53ef\u66ff\u6362\u6210 Postgres\/Mongo \u7b49\u81ea\u5b9a\u4e49\u5b9e\u73b0\uff0c\u53ea\u8981\u7ee7\u627f&nbsp;<code>BaseChatMessageHistory<\/code>\u3002<\/li>\n\n\n\n<li><code>ttl<\/code>&nbsp;\u8ba9 Redis \u81ea\u52a8\u6e05\u7406\u957f\u65f6\u95f4\u672a\u6d3b\u8dc3\u7684\u5bf9\u8bdd\uff0c\u9002\u5408\u5ba2\u670d\u573a\u666f\u3002<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">\u6e90\u7801\uff1a<\/h1>\n\n\n\n<pre class=\"wp-block-code\"><code>import logging\nimport os\nimport traceback\nfrom datetime import datetime\nfrom typing import Optional\n\nfrom dotenv import load_dotenv\nfrom fastapi import FastAPI, HTTPException\nfrom langchain_community.chat_message_histories import (\n    RedisChatMessageHistory,\n)\nfrom langchain_core.output_parsers import StrOutputParser\nfrom langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder\nfrom langchain_core.runnables.history import RunnableWithMessageHistory\nfrom langchain_community.chat_models.tongyi import ChatTongyi\nfrom pydantic import BaseModel\n\nload_dotenv()\n\napp = FastAPI(title=\"AI Customer Service Demo\", version=\"0.1.0\")\nlogger = logging.getLogger(\"ai-customer-service\")\n\n#\u6784\u9020 Prompt\uff08\u63d0\u793a\u6a21\u677f\uff09\n#   - system \u6d88\u606f\u56fa\u5b9a\u5ba2\u670d\u4eba\u8bbe\n#   - MessagesPlaceholder \u662f\u5386\u53f2\u6d88\u606f\u7684\u5360\u4f4d\u7b26\uff0c\u7a0d\u540e\u4f1a\u7531 RunnableWithMessageHistory \u81ea\u52a8\u586b\u5145\n#   - human \u6d88\u606f\u7559\u7ed9\u5b9e\u65f6\u8f93\u5165\nSYSTEM_PROMPT = (\n    \"\u4f60\u662f\u4e00\u4e2a\u7ec6\u81f4\u8010\u5fc3\u7684 AI \u5ba2\u670d\uff0c\u8d1f\u8d23\u56de\u7b54\u7528\u6237\u5173\u4e8e\u4ea7\u54c1\u653f\u7b56\u3001\u8ba2\u8d2d\u4e0e\u6545\u969c\u6392\u67e5\u7684\u95ee\u9898\u3002\"\n    \"\u9047\u5230\u9700\u8981\u4eba\u5de5\u4ecb\u5165\u7684\u60c5\u51b5\u65f6\uff0c\u5148\u6574\u7406\u5df2\u77e5\u4fe1\u606f\uff0c\u518d\u5efa\u8bae\u8f6c\u4eba\u5de5\u3002\"\n    f\"\u5f53\u524d\u65f6\u95f4\uff1a{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\u3002\"\n)\n\nprompt = ChatPromptTemplate.from_messages(\n    &#91;\n        (\"system\", SYSTEM_PROMPT),\n        MessagesPlaceholder(variable_name=\"history\"),\n        (\"human\", \"{user_input}\"),\n    ]\n)\n\nmodel = ChatTongyi(\n    model=os.getenv(\"TONGYI_MODEL\", \"qwen-max\"),\n    api_key=os.getenv(\"OPENAI_API_KEY\"),\n    temperature=0.2,\n)\n\n# Prompt + Model + OutputParser \u5408\u6210\u6700\u57fa\u7840\u7684\u5bf9\u8bdd\u94fe\u6761\nbase_chain = prompt | model | StrOutputParser()\n\n# \u957f\u671f\u8bb0\u5fc6\u5b58\u50a8\uff08Redis\uff09\n#   - \u901a\u8fc7 RedisChatMessageHistory \u628a\u6bcf\u4e2a user_id \u7684\u6d88\u606f\u5199\u5165 Redis \u5217\u8868\n#   - ttl \u63a7\u5236\u6d88\u606f\u4fdd\u7559\u65f6\u95f4\uff08\u9ed8\u8ba4 7 \u5929\uff09\uff0c\u4e5f\u53ef\u4ee5\u8c03\u6210\u6309\u9700\u6e05\u7406\n#   - REDIS_URL \u53ef\u5e26\u5bc6\u7801\u3001\u6570\u636e\u5e93 index\uff0c\u9002\u5408\u751f\u4ea7\u73af\u5883\u90e8\u7f72\nredis_url = os.getenv(\"REDIS_URL\", \"redis:\/\/:123456@localhost:6379\/0\")\nredis_ttl_seconds = int(os.getenv(\"REDIS_TTL_SECONDS\", str(60 * 60 * 24 * 7)))\n\ndef get_history(session_id: str) -> RedisChatMessageHistory:\n    if not session_id:\n        raise ValueError(\"session_id must not be empty\")\n    return RedisChatMessageHistory(\n        session_id=session_id,\n        url=redis_url,\n        ttl=redis_ttl_seconds,\n    )\n\n# RunnableWithMessageHistory = \u201c\u80f6\u6c34\u201d\uff1a\n#   - \u6bcf\u6b21\u8c03\u7528\u524d\u5728 prompt \u91cc\u6ce8\u5165\u5386\u53f2\uff1b\u8c03\u7528\u540e\u5c06\u6700\u65b0 AI\/Human \u6d88\u606f\u5199\u56de Redis\n#   - input_messages_key \u5bf9\u5e94 prompt \u4e2d human \u90e8\u5206\u7684\u53d8\u91cf\u540d\n#   - history_messages_key \u5bf9\u5e94 MessagesPlaceholder \u7684\u53d8\u91cf\u540d\nconversation_chain = RunnableWithMessageHistory(\n    base_chain,\n    get_session_history=get_history,\n    input_messages_key=\"user_input\",\n    history_messages_key=\"history\",\n)\n\n\nclass ChatRequest(BaseModel):\n    user_id: str\n    message: str\n    locale: Optional&#91;str] = None\n\n\nclass ChatResponse(BaseModel):\n    user_id: str\n    reply: str\n\n\n@app.get(\"\/health\")\nasync def health_check():\n    return {\"status\": \"ok\"}\n\n\n@app.post(\"\/chat\", response_model=ChatResponse)\nasync def chat_endpoint(payload: ChatRequest):\n    if not payload.user_id.strip():\n        raise HTTPException(status_code=400, detail=\"user_id is required\")\n\n    try:\n        reply = await conversation_chain.ainvoke(\n            {\"user_input\": payload.message},\n            config={\"configurable\": {\"session_id\": payload.user_id}},\n        )\n    except Exception as exc:  # pragma: no cover - demo level error surfacing\n        tb = traceback.format_exc()\n        logger.error(\"LLM \u8c03\u7528\u5931\u8d25: %s\\n%s\", exc, tb)\n        raise HTTPException(\n            status_code=500,\n            detail={\n                \"error\": str(exc),\n                \"hint\": \"\u68c0\u67e5 OPENAI_API_KEY \u662f\u5426\u4e3a\u6709\u6548\u7684 DashScope Key \u6216 Redis \u8fde\u63a5\u662f\u5426\u53ef\u7528\u3002\",\n                \"traceback\": tb,\n            },\n        ) from exc\n\n    return ChatResponse(user_id=payload.user_id, reply=reply)\n<\/code><\/pre>\n\n\n\n<h1 class=\"wp-block-heading\">\u7ed3\u679c\uff1a<\/h1>\n\n\n\n<pre class=\"wp-block-code\"><code>C:\\Users\\29924&gt;curl -X POST http:\/\/127.0.0.1:8000\/chat -H \"Content-Type: application\/json\" -d \"{\\\"user_id\\\": \\\"zhangsan\\\", \\\"message\\\": \\\"\u6211\u7684\u732b\u53eb\u54aa\u54aa\uff0c\u5b83\u662f\u4e00\u53ea\u4e09\u82b1\u732b\\\"}\"\n{\"user_id\":\"zhangsan\",\"reply\":\"\u8c22\u8c22\u60a8\u7684\u5206\u4eab\uff01\u54aa\u54aa\u542c\u8d77\u6765\u662f\u4e2a\u975e\u5e38\u53ef\u7231\u7684\u540d\u5b57\uff0c\u4e09\u82b1\u732b\u7684\u989c\u8272\u7ec4\u5408\u901a\u5e38\u4e5f\u975e\u5e38\u6f02\u4eae\u3002\u5982\u679c\u60a8\u6709\u5173\u4e8e\u7167\u987e\u54aa\u54aa\u7684\u95ee\u9898\uff0c\u6bd4\u5982\u996e\u98df\u3001\u5065\u5eb7\u6216\u662f\u884c\u4e3a\u4e60\u60ef\u7b49\u65b9\u9762\u7684\u7591\u95ee\uff0c\u6211\u5f88\u4e50\u610f\u5e2e\u52a9\u63d0\u4f9b\u4e00\u4e9b\u5efa\u8bae\u3002\u6216\u8005\uff0c\u60a8\u6709\u5176\u4ed6\u60f3\u8981\u4e86\u89e3\u7684\u5185\u5bb9\u5417\uff1f\"}\n\nC:\\Users\\29924&gt;curl -X POST http:\/\/127.0.0.1:8000\/chat -H \"Content-Type: application\/json\" -d \"{\\\"user_id\\\": \\\"lisi\\\", \\\"message\\\": \\\"\u6211\u8ba1\u5212\u4e0b\u4e2a\u6708\u53bb\u5317\u4eac\u65c5\u6e38\\\"}\"\n{\"user_id\":\"lisi\",\"reply\":\"\u90a3\u542c\u8d77\u6765\u5f88\u4ee4\u4eba\u5174\u594b\uff01\u5317\u4eac\u662f\u4e00\u4e2a\u5145\u6ee1\u5386\u53f2\u548c\u6587\u5316\u7684\u57ce\u5e02\uff0c\u6709\u5f88\u591a\u503c\u5f97\u6e38\u89c8\u7684\u5730\u65b9\u3002\u5982\u679c\u60a8\u9700\u8981\u4e00\u4e9b\u5efa\u8bae\u6765\u89c4\u5212\u60a8\u7684\u65c5\u884c\uff0c\u6bd4\u5982\u5fc5\u53bb\u7684\u666f\u70b9\u3001\u7f8e\u98df\u63a8\u8350\u6216\u662f\u4f4f\u5bbf\u5efa\u8bae\u7b49\uff0c\u6211\u5f88\u4e50\u610f\u4e3a\u60a8\u63d0\u4f9b\u5e2e\u52a9\u3002\u53e6\u5916\uff0c\u5982\u679c\u60a8\u6709\u5173\u4e8e\u4ea4\u901a\u5b89\u6392\u3001\u5929\u6c14\u60c5\u51b5\u6216\u4efb\u4f55\u5176\u4ed6\u65b9\u9762\u7684\u7591\u95ee\uff0c\u4e5f\u8bf7\u968f\u65f6\u544a\u8bc9\u6211\uff01\u60a8\u73b0\u5728\u6709\u4ec0\u4e48\u5177\u4f53\u60f3\u8981\u4e86\u89e3\u7684\u4fe1\u606f\u5417\uff1f\"}\n\nC:\\Users\\29924&gt;curl -X POST http:\/\/127.0.0.1:8000\/chat -H \"Content-Type: application\/json\" -d \"{\\\"user_id\\\": \\\"zhangsan\\\", \\\"message\\\": \\\"\u5b83\u5e73\u65f6\u559c\u6b22\u5403\u4ec0\u4e48\uff1f\\\"}\"\n{\"user_id\":\"zhangsan\",\"reply\":\"\u4e09\u82b1\u732b\u548c\u5176\u4ed6\u732b\u54aa\u4e00\u6837\uff0c\u5bf9\u98df\u7269\u7684\u559c\u597d\u53ef\u80fd\u4f1a\u6709\u6240\u4e0d\u540c\uff0c\u4f46\u4e00\u822c\u6765\u8bf4\uff0c\u5065\u5eb7\u7684\u996e\u98df\u5e94\u8be5\u5305\u62ec\u9ad8\u8d28\u91cf\u7684\u732b\u7cae\u548c\u9002\u91cf\u7684\u6e7f\u7cae\u3002\u8fd9\u91cc\u6709\u4e00\u4e9b\u5173\u4e8e\u732b\u54aa\u996e\u98df\u7684\u4e00\u822c\u6027\u5efa\u8bae\uff1a\\n\\n1. \u9ad8\u8d28\u91cf\u732b\u7cae\uff1a\u9009\u62e9\u4e00\u79cd\u8425\u517b\u5747\u8861\u3001\u9002\u5408\u54aa\u54aa\u5e74\u9f84\uff08\u5e7c\u732b\u3001\u6210\u732b\u6216\u8001\u5e74\u732b\uff09\u4ee5\u53ca\u5065\u5eb7\u72b6\u51b5\u7684\u732b\u7cae\u975e\u5e38\u91cd\u8981\u3002\u5e02\u9762\u4e0a\u6709\u8bb8\u591a\u54c1\u724c\u63d0\u4f9b\u4e0d\u540c\u7c7b\u578b\u7684\u732b\u7cae\uff0c\u60a8\u53ef\u4ee5\u6839\u636e\u54aa\u54aa\u7684\u5177\u4f53\u9700\u6c42\u6765\u6311\u9009\u3002\\n\\n2. \u6e7f\u7cae\uff1a\u6e7f\u7cae\u53ef\u4ee5\u4e3a\u732b\u54aa\u63d0\u4f9b\u989d\u5916\u7684\u6c34\u5206\uff0c\u5e76\u4e14\u5f88\u591a\u732b\u54aa\u90fd\u559c\u6b22\u5b83\u7684\u53e3\u611f\u3002\u6e7f\u7cae\u4e5f\u662f\u589e\u52a0\u732b\u54aa\u996e\u98df\u591a\u6837\u6027\u7684\u597d\u65b9\u6cd5\u4e4b\u4e00\u3002\u4e0d\u8fc7\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u4e0d\u8981\u8ba9\u6e7f\u7cae\u6210\u4e3a\u732b\u54aa\u552f\u4e00\u7684\u98df\u7269\u6765\u6e90\uff0c\u56e0\u4e3a\u5e72\u7cae\u6709\u52a9\u4e8e\u6e05\u6d01\u7259\u9f7f\u3002\\n\\n3. \u65b0\u9c9c\u8089\u7c7b\uff1a\u4e00\u4e9b\u732b\u54aa\u559c\u6b22\u5076\u5c14\u5403\u70b9\u65b0\u9c9c\u716e\u719f\u7684\u9e21\u8089\u3001\u9c7c\u8089\u7b49\u3002\u786e\u4fdd\u8fd9\u4e9b\u8089\u7c7b\u662f\u65e0\u9aa8\u4e14\u672a\u7ecf\u8fc7\u8c03\u5473\u5904\u7406\u7684\u3002\\n\\n4. \u96f6\u98df\uff1a\u9002\u91cf\u7ed9\u4e88\u732b\u54aa\u4e13\u7528\u7684\u5c0f\u96f6\u98df\u4f5c\u4e3a\u5956\u52b1\u662f\u53ef\u4ee5\u7684\uff0c\u4f46\u8981\u63a7\u5236\u597d\u5206\u91cf\uff0c\u907f\u514d\u8fc7\u91cf\u5bfc\u81f4\u80a5\u80d6\u6216\u5176\u4ed6\u5065\u5eb7\u95ee\u9898\u3002\\n\\n5. \u6c34\uff1a\u4fdd\u6301\u5145\u8db3\u7684\u6e05\u6c34\u4f9b\u5e94\u5bf9\u4e8e\u7ef4\u6301\u732b\u54aa\u826f\u597d\u7684\u5065\u5eb7\u72b6\u6001\u81f3\u5173\u91cd\u8981\u3002\\n\\n\u503c\u5f97\u6ce8\u610f\u7684\u662f\uff0c\u6bcf\u53ea\u732b\u54aa\u7684\u8eab\u4f53\u72b6\u51b5\u548c\u4e2a\u4eba\u504f\u597d\u90fd\u4e0d\u540c\uff0c\u5728\u6539\u53d8\u5176\u996e\u98df\u4e60\u60ef\u524d\u6700\u597d\u5148\u54a8\u8be2\u517d\u533b\u7684\u610f\u89c1\u3002\u5982\u679c\u53d1\u73b0\u54aa\u54aa\u6709\u4efb\u4f55\u4e0d\u5bfb\u5e38\u7684\u884c\u4e3a\u6216\u5065\u5eb7\u95ee\u9898\uff0c\u8bf7\u53ca\u65f6\u8054\u7cfb\u4e13\u4e1a\u4eba\u58eb\u8fdb\u884c\u68c0\u67e5\u3002\u5e0c\u671b\u8fd9\u4e9b\u5efa\u8bae\u80fd\u5e2e\u52a9\u5230\u60a8\uff01\"}\n\nC:\\Users\\29924&gt;curl -X POST http:\/\/127.0.0.1:8000\/chat -H \"Content-Type: application\/json\" -d \"{\\\"user_id\\\": \\\"lisi\\\", \\\"message\\\": \\\"\u5b83\u5e73\u65f6\u559c\u6b22\u5403\u4ec0\u4e48\uff1f\\\"}\"\n{\"user_id\":\"lisi\",\"reply\":\"\u770b\u8d77\u6765\u60a8\u53ef\u80fd\u662f\u5728\u8be2\u95ee\u67d0\u4e2a\u4eba\u6216\u67d0\u4e2a\u7279\u5b9a\u5bf9\u8c61\u7684\u996e\u98df\u504f\u597d\uff0c\u4f46\u60a8\u7684\u95ee\u9898\u4e2d\u6ca1\u6709\u660e\u786e\u6307\u51fa\u662f\u201c\u8c01\u201d\u6216\u201c\u4ec0\u4e48\u201d\u3002\u5982\u679c\u60a8\u80fd\u63d0\u4f9b\u66f4\u591a\u80cc\u666f\u4fe1\u606f\uff0c\u6bd4\u5982\u662f\u6307\u5317\u4eac\u7684\u5f53\u5730\u4eba\u3001\u67d0\u79cd\u52a8\u7269\u8fd8\u662f\u5176\u4ed6\u4ec0\u4e48\uff0c\u6211\u5c31\u80fd\u66f4\u597d\u5730\u4e3a\u60a8\u63d0\u4f9b\u76f8\u5173\u4fe1\u606f\u3002\u8bf7\u544a\u8bc9\u6211\u66f4\u591a\u7ec6\u8282\uff0c\u597d\u5417\uff1f\"}\n\n<\/code><\/pre>\n\n\n\n<p>\u91cd\u542f\u670d\u52a1\u540e\uff1a<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>C:\\Users\\29924&gt;  curl -X POST http:\/\/127.0.0.1:8000\/chat -H \"Content-Type: application\/json\" -d \"{\\\"user_id\\\": \\\"zhangsan\\\", \\\"message\\\": \\\"\u5b83\u53eb\u4ec0\u4e48\u6765\u7740\uff1f\\\"}\"\n{\"user_id\":\"zhangsan\",\"reply\":\"\u60a8\u7684\u732b\u54aa\u53eb\u54aa\u54aa\uff0c\u662f\u4e00\u53ea\u4e09\u82b1\u732b\u3002\u5982\u679c\u60a8\u8fd8\u6709\u5176\u4ed6\u5173\u4e8e\u54aa\u54aa\u7684\u95ee\u9898\u6216\u9700\u8981\u66f4\u591a\u5e2e\u52a9\uff0c\u8bf7\u968f\u65f6\u544a\u8bc9\u6211\uff01\"}\n<\/code><\/pre>\n\n\n\n<p>\u8fd95\u6b21API\u8c03\u7528\u6e05\u6670\u5730\u5c55\u793a\u4e86\u7cfb\u7edf\u7684<strong>\u591a\u7528\u6237\u8bb0\u5fc6\u4e0e\u9694\u79bb<\/strong>\u673a\u5236\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>\u9996\u6b21\u5bf9\u8bdd\u5efa\u7acb\u4e0d\u540c\u4e0a\u4e0b\u6587<\/strong>\uff1a\n<ul class=\"wp-block-list\">\n<li><code>zhangsan<\/code>\u804a\u201c\u6211\u7684\u732b\u53eb\u54aa\u54aa\u201d<\/li>\n\n\n\n<li><code>lisi<\/code>\u804a\u201c\u8ba1\u5212\u53bb\u5317\u4eac\u65c5\u6e38\u201d<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>\u540e\u7eed\u76f8\u540c\u95ee\u9898\u9a8c\u8bc1\u9694\u79bb\u6548\u679c<\/strong>\uff1a\n<ul class=\"wp-block-list\">\n<li><strong>zhangsan<\/strong>\u200b \u95ee\u201c\u5b83\u5e73\u65f6\u559c\u6b22\u5403\u4ec0\u4e48\uff1f\u201d \u2192 AI\u51c6\u786e\u7406\u89e3\u201c\u5b83\u201d\u6307\u732b\u201c\u54aa\u54aa\u201d\uff0c\u7ed9\u51fa\u8be6\u7ec6\u517b\u732b\u5efa\u8bae <\/li>\n\n\n\n<li><strong>lisi<\/strong>\u200b \u540c\u6837\u95ee\u201c\u5b83\u5e73\u65f6\u559c\u6b22\u5403\u4ec0\u4e48\uff1f\u201d \u2192 AI\u56f0\u60d1\uff0c\u56e0\u5386\u53f2\u4e2d\u65e0\u201c\u5b83\u201d\u6240\u6307\u5bf9\u8c61\uff0c\u8981\u6c42\u66f4\u591a\u4fe1\u606f<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>\u91cd\u542f\u670d\u52a1\u540e\u9a8c\u8bc1\u5386\u53f2\u8bb0\u5f55\u6301\u4e45\u5316\uff08\u8bb0\u5fc6\u4e3a\u957f\u671f\u800c\u975e\u77ed\u671f\uff09\uff1a<\/strong>\n<ul class=\"wp-block-list\">\n<li> <strong>zhangsan<\/strong>\u200b \u95ee\u201c\u5b83\u53eb\u4ec0\u4e48\u6765\u7740\uff1f\u201d \u2192 \u670d\u52a1\u91cd\u542f\u540e\u7684AI\u4f9d\u7136\u53ef\u4ee5\u51c6\u786e\u56de\u7b54\u201c\u5b83\u201d\u53eb\u201c\u54aa\u54aa\u201d <\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<p><strong>\u6838\u5fc3\u8bc1\u660e<\/strong>\uff1a\u76f8\u540c\u7684\u6a21\u7cca\u63d0\u95ee\uff0c\u56e0\u7528\u6237\u4e0d\u540c\uff0c\u7cfb\u7edf\u4ece\u5404\u81ea\u72ec\u7acb\u7684Redis\u5386\u53f2\u4e2d\u63d0\u53d6\u4e0a\u4e0b\u6587\uff0c\u7ed9\u51fa\u4e86\u5b8c\u5168\u4e0d\u540c\u7684\u56de\u7b54\u3002\u8fd9\u8bc1\u5b9e\u4e86\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u4f1a\u8bdd\u9694\u79bb<\/strong>\uff1a\u7528\u6237\u5386\u53f2\u4e92\u4e0d\u5e72\u6270<\/li>\n\n\n\n<li><strong>\u957f\u671f\u8bb0\u5fc6<\/strong>\uff1a\u80fd\u8bb0\u4f4f\u7528\u6237\u4e4b\u524d\u7684\u5bf9\u8bdd<\/li>\n\n\n\n<li><strong>\u81ea\u52a8\u4e0a\u4e0b\u6587\u7ba1\u7406<\/strong>\uff1a<code>RunnableWithMessageHistory<\/code>\u6b63\u786e\u6ce8\u5165\u4e13\u5c5e\u5386\u53f2<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">\u8bb2\u89e3\uff1a<\/h1>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>\u7ec4\u4ef6<\/th><th>\u4f5c\u7528<\/th><th>\u672c\u8d28<\/th><\/tr><\/thead><tbody><tr><td>\u5916\u90e8\u5b58\u50a8<\/td><td>\u6570\u636e\u6301\u4e45\u5316<\/td><td>Redis \/ DB \/ \u5411\u91cf\u5e93<\/td><\/tr><tr><td>ChatMessageHistory<\/td><td>\u6570\u636e\u8bbf\u95ee\u5c42<\/td><td>CRUD \u5c01\u88c5<\/td><\/tr><tr><td>RunnableWithMessageHistory<\/td><td>\u751f\u547d\u5468\u671f\u7ba1\u7406<\/td><td>\u81ea\u52a8\u6ce8\u5165 + \u81ea\u52a8\u5b58\u50a8<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">ChatMessageHistory<\/h2>\n\n\n\n<p>LangChain \u5df2\u7ecf\u63d0\u4f9b\u4e86\u5e38\u7528\u5b9e\u73b0\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>InMemoryChatMessageHistory<\/code>\uff08\u5185\u5b58\uff09<\/li>\n\n\n\n<li><code>RedisChatMessageHistory<\/code><\/li>\n\n\n\n<li><code>SQLChatMessageHistory<\/code><\/li>\n<\/ul>\n\n\n\n<p>\u4e00\u822c\u4f7f\u7528\u81ea\u5b9a\u4e49\/\u6269\u5c55\u7684ChatMessageHistory\u7ee7\u627fBaseChatMessageHistory\uff0c\u9700\u8981\u81f3\u5c11\u5b9e\u73b0\u4e09\u4e2a\u65b9\u6cd5\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><code>add_message<\/code><\/strong>\uff1a\u5728\u6bcf\u6b21\u5bf9\u8bdd\u53d1\u751f\u65f6\u5199\u5165\u65b0\u6d88\u606f\uff0c\u5e76\u5728\u5199\u5165\u8fc7\u7a0b\u4e2d\u53ef\u9644\u5e26\u88c1\u526a\u3001\u6458\u8981\u3001\u5411\u91cf\u5316\u6216\u4fe1\u606f\u62bd\u53d6\u7b49\u5904\u7406\u3002<\/li>\n\n\n\n<li><strong><code>get_messages<\/code><\/strong>\uff1a\u5728\u6a21\u578b\u8c03\u7528\u524d\u8bfb\u53d6\u5e76\u7ec4\u7ec7\u4e0a\u4e0b\u6587\uff0c\u901a\u5e38\u4f1a\u7ec4\u5408\u201c\u5386\u53f2\u6458\u8981 + \u6700\u8fd1\u5bf9\u8bdd + \u68c0\u7d22\u7ed3\u679c\u201d\u7b49\u5185\u5bb9\u8fd4\u56de\u3002<\/li>\n\n\n\n<li><strong><code>clear<\/code><\/strong>\uff1a\u6e05\u7a7a\u5f53\u524d\u4f1a\u8bdd\u7684\u6240\u6709\u5df2\u5b58\u50a8\u8bb0\u5fc6\uff0c\u7528\u4e8e\u91cd\u7f6e\u4e0a\u4e0b\u6587\u6216\u7ed3\u675f\u4f1a\u8bdd\u3002<\/li>\n\n\n\n<li><\/li>\n<\/ul>\n\n\n\n<p>\u4e0b\u9762\u662f\u4e00\u4e2a\u5178\u578b\u7684\u81ea\u5b9a\u4e49\u793a\u4f8b\uff1a<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>class EnhancedRedisChatMessageHistory:\n\n    def __init__(\n        self,\n        session_id: str,\n        redis_client: Redis,\n        ttl: Optional&#91;int] = None,\n        max_messages: int = 20,  # \u6700\u591a\u4fdd\u7559\u6700\u8fd1 N \u6761\u5bf9\u8bdd\uff08\u9632\u8d85\u957f\uff09\n        prefix: str = \"chat:history\"  # Redis key \u524d\u7f00\uff08\u591a\u4e1a\u52a1\u9694\u79bb\uff09\n    ):\n        # 1. \u57fa\u7840\u6821\u9a8c\uff08\u751f\u4ea7\u5fc5\u5907\uff09\n        if not session_id:\n            raise ValueError(\"session_id \u4e0d\u80fd\u4e3a\u7a7a\")\n        if not isinstance(redis_client, Redis):\n            raise TypeError(\"redis_client \u5fc5\u987b\u662f\u5408\u6cd5\u7684 Redis \u5b9e\u4f8b\")\n\n        # 2. \u6838\u5fc3\u914d\u7f6e\n        self.session_id = session_id\n        self.redis_client = redis_client\n        self.ttl = ttl\n        self.max_messages = max_messages\n        self.key = f\"{prefix}:{session_id}\"  # \u6700\u7ec8 Redis key\n\n    def add_message(self, message: BaseMessage) -> None:\n        \"\"\"\u6dfb\u52a0\u5355\u6761\u6d88\u606f\uff08LangChain \u6807\u51c6\u63a5\u53e3\uff09\"\"\"\n        try:\n            # \u8bfb\u53d6\u73b0\u6709\u5386\u53f2\n            history = self.messages\n            # \u8ffd\u52a0\u65b0\u6d88\u606f\n            history.append(message)\n            # \u622a\u65ad\uff1a\u53ea\u4fdd\u7559\u6700\u8fd1 N \u6761\uff08\u9632\u6b62 token \u7206\u70b8\uff09\n            if self.max_messages > 0:\n                history = history&#91;-self.max_messages:]\n            # \u5e8f\u5217\u5316\u5b58\u50a8\n            self._save_history(history)\n            logger.debug(f\"\u4f1a\u8bdd {self.session_id} \u65b0\u589e\u6d88\u606f\u6210\u529f\uff0c\u5f53\u524d\u603b\u6570\uff1a{len(history)}\")\n\n        except RedisError as e:\n            logger.error(f\"Redis \u5b58\u50a8\u6d88\u606f\u5931\u8d25\uff1a{str(e)}\", exc_info=True)\n            raise  # \u751f\u4ea7\u53ef\u6839\u636e\u9700\u6c42\u9009\u62e9\u662f\u5426\u541e\u5f02\u5e38\n\n    def _save_history(self, messages: List&#91;BaseMessage]) -> None:\n        \"\"\"\u5185\u90e8\u65b9\u6cd5\uff1a\u5e8f\u5217\u5316 + \u5b58\u50a8 + \u8bbe\u7f6e\u8fc7\u671f\u65f6\u95f4\"\"\"\n        try:\n            # \u8f6c\u6210\u53ef\u5e8f\u5217\u5316\u683c\u5f0f\n            dict_messages = messages_to_dict(messages)\n            # \u5b58\u5165 Redis\n            self.redis_client.set(\n                name=self.key,\n                value=json.dumps(dict_messages, ensure_ascii=False),\n                ex=self.ttl\n            )\n        except Exception as e:\n            logger.error(f\"\u5e8f\u5217\u5316\/\u5b58\u50a8\u5931\u8d25\uff1a{str(e)}\", exc_info=True)\n            raise\n\n    def clear(self) -> None:\n        \"\"\"\u6e05\u7a7a\u5386\u53f2\uff08LangChain \u6807\u51c6\u63a5\u53e3\uff09\"\"\"\n        try:\n            self.redis_client.delete(self.key)\n            logger.info(f\"\u4f1a\u8bdd {self.session_id} \u5386\u53f2\u5df2\u6e05\u7a7a\")\n        except RedisError as e:\n            logger.error(f\"\u6e05\u7a7a\u5386\u53f2\u5931\u8d25\uff1a{str(e)}\", exc_info=True)\n            raise\n\n    @property\n    def messages(self) -> List&#91;BaseMessage]:\n        \"\"\"\u8bfb\u53d6\u5386\u53f2\uff08LangChain \u6807\u51c6\u63a5\u53e3\uff09\"\"\"\n        try:\n            # \u4ece Redis \u8bfb\u53d6\n            data = self.redis_client.get(self.key)\n            if not data:\n                return &#91;]\n\n            # \u53cd\u5e8f\u5217\u5316\n            dict_messages = json.loads(data)\n            return messages_from_dict(dict_messages)\n\n        except RedisError as e:\n            logger.error(f\"\u8bfb\u53d6\u5386\u53f2\u5931\u8d25\uff1a{str(e)}\", exc_info=True)\n            return &#91;]  # \u8bfb\u5931\u8d25\u8fd4\u56de\u7a7a\uff0c\u4e0d\u963b\u585e\u4e3b\u6d41\u7a0b\n        except json.JSONDecodeError:\n            logger.error(f\"\u5386\u53f2\u6570\u636e\u683c\u5f0f\u635f\u574f\uff1a{self.key}\")\n            self.clear()\n            return &#91;]\n\n    def add_user_message(self, message: str) -> None:\n        \"\"\"\u5feb\u6377\u6dfb\u52a0\u7528\u6237\u6d88\u606f\uff08\u517c\u5bb9 LangChain\uff09\"\"\"\n        from langchain.schema import HumanMessage\n        self.add_message(HumanMessage(content=message))\n\n    def add_ai_message(self, message: str) -> None:\n        \"\"\"\u5feb\u6377\u6dfb\u52a0 AI \u6d88\u606f\uff08\u517c\u5bb9 LangChain\uff09\"\"\"\n        from langchain.schema import AIMessage\n        self.add_message(AIMessage(content=message))<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">RunnableWithMessageHistory<\/h2>\n\n\n\n<p>\u7ed9\u201c\u539f\u672c\u65e0\u8bb0\u5fc6\u7684\u94fe\uff08base_chain\uff09\u201d\u589e\u52a0<strong>\u591a\u8f6e\u5bf9\u8bdd\u80fd\u529b<\/strong>\uff0c\u4e14\u4e0d\u4fb5\u5165\u539f\u94fe\u4ee3\u7801\u3002<\/p>\n\n\n\n<p>\u5728\u8c03\u7528\u524d\u540e\uff0c\u81ea\u52a8\u5e2e\u4f60\u201c\u8bfb\u5386\u53f2 + \u6ce8\u5165 + \u5199\u56de\u201d<\/p>\n\n\n\n<p><strong>2. \u539f\u7406\uff08\u6267\u884c\u6d41\u7a0b\uff09<\/strong><br>\u6bcf\u6b21\u8bf7\u6c42\u5b9e\u9645\u505a\u4e09\u6b65\uff1a<\/p>\n\n\n\n<p>1\uff09\u6839\u636e <code>session_id<\/code> \u83b7\u53d6\u5386\u53f2<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">history = get_history(session_id)<\/pre>\n\n\n\n<p>2\uff09\u628a\u5386\u53f2\u63d2\u5165 Prompt<br>\u2192 \u586b\u5145 <code>MessagesPlaceholder(\"history\")<\/code><\/p>\n\n\n\n<p>3\uff09\u6a21\u578b\u8fd4\u56de\u540e\u5199\u56de\uff08\u5199\u56de\u7684\u662f\u6574\u4e2a\u94fe\u7684\u7ed3\u679c\uff09<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">history.add_user_message(...)<br>history.add_ai_message(...)<\/pre>\n\n\n\n<p><strong>3. \u53c2\u6570\u4e3a\u4ec0\u4e48\u5fc5\u987b\u8fd9\u6837\u5199<\/strong><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uff081\uff09get_session_history<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">def get_history(session_id) -&gt; RedisChatMessageHistory<\/pre>\n\n\n\n<p>\u4f5c\u7528\uff1a<br> \u628a <code>session_id<\/code> \u6620\u5c04\u5230\u5bf9\u5e94\u7684 Redis \u8bb0\u5f55\uff08\u5b9e\u73b0\u591a\u7528\u6237\u9694\u79bb\uff09<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uff082\uff09input_messages_key<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">input_messages_key=\"user_input\"<\/pre>\n\n\n\n<p>\u4f5c\u7528\uff1a<br>\u6307\u660e\u201c\u7528\u6237\u8f93\u5165\u5728\u54ea\u201d\uff0c\u7528\u4e8e\u5199\u56de\u5386\u53f2<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uff083\uff09history_messages_key<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">history_messages_key=\"history\"<\/pre>\n\n\n\n<p>\u4f5c\u7528\uff1a<br>\u6307\u660e\u201c\u5386\u53f2\u63d2\u5165\u5230 Prompt \u7684\u54ea\u4e2a\u4f4d\u7f6e\u201d<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u6b64\u9879\u76ee\u6f14\u793a LangChain \u5728\u751f\u4ea7\u73af\u5883\u4e2d\u63a8\u8350\u7684\u201cChatMessageHistory + Runnable [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[82,66],"tags":[86,85,71],"class_list":["post-1563","post","type-post","status-publish","format-standard","hentry","category-82","category-66","tag-langchain","tag-rag","tag-redis"],"_links":{"self":[{"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/posts\/1563","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1563"}],"version-history":[{"count":21,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/posts\/1563\/revisions"}],"predecessor-version":[{"id":1596,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=\/wp\/v2\/posts\/1563\/revisions\/1596"}],"wp:attachment":[{"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1563"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1563"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.cmd137blog.top\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1563"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}