DeepSeek + ReAct 实现 Agent

1. 大模型自身的范围

近来 DeepSeek 的爆火，再一次点燃了大家对于大模型的热情，身边许多一样平常不关注 AI 范畴的人，也开始交换 DeepSeek 的使用体验。DeepSeek 简直非常强盛，它将推理本领拉齐到了 GPT 水平的同时，还大幅降低了训练资源，成为当下最炙手可热的大模型。
但是，即使像 DS 云云强盛的大模型，它也不是全能的，有一些问题它也回答不了，特别是一些垂直范畴的知识或实时性比较高的知识。比如我们想做一个居家生活小助手，直接调用 DeepSeek 是行不通的（未开启联网搜索的环境下）。

那么如何办理这个问题呢？每当我们遇到这种需要模型做自主判断、自行调用工具、自行决定下一步举措的时候，Agent 就轮到进场了。
Agent 概述

后面偶尔机我们会详细讲解下 AI Agent，这里简单理解： Agent 是一种基于 LLM 驱动的、可以或许自主感知四周环境、做出决定、采取举措达成特定目标的体系。一个 Agent 体系的整体架构如下：

一个 Agent 通常包罗了以下几个关键模块：

• 规划（Planning）：它负责将大目标分解成小的子目标，也可以对已有行为进行反思和自我改善。
  
• 记忆（Memory）：包罗短期记忆和恒久记忆，短期记忆提供上下文内的学习，恒久记忆则提供长时间保留和回忆信息的本领。
  
• 工具（Tools）：通过调用外部 API 获取外部信息（作为感知器），执行外部动作（作为执行器）。
  

Agent 看起来是一个非常复杂的体系，但是现实上有一种快速的实现方式，那就是 LLM + ReAct 框架。那么什么是 ReAct 呢？
ReAct 焦点原理

ReAct 现实上是两个单词的缩写：Reasoning + Acting，也就是推理 + 举措，它是一个引导大语言模型进行推理和举措的思维框架。在《ReAct: Synergizing Reasoning and Acting in Language Models》这篇论文中首次提出。
我们引用论文中的示例来解释一下。假设我们想要问大模型这样一个问题：
   除了苹果遥控器，另有哪些装备可以控制苹果遥控器最初计划用来交互的步调?Aside from the Apple Remote, what other devices can control the program Apple Remote was originally designed to interact with?
  使用 ReAct 框架，可以引导大模型进行如下的推理：

在这个例子中，大模型为了完成一个复杂任务时，首先会进行子任务拆分，且每个子任务的执行都会经过如下几个阶段：

• Thought 思索：大模型根据任务进行思索和推理，订定执行计划。
  
• Action 举措：大模型从可用的工具列表中筛选出可用的工具，执行详细的动作。
  
• Observation 观察：动作执行完成后，由大模型观察执行效果，并判断是继续下一步动作，照旧执行结束返回效果。
  

理论好像大概相识了，但详细要如何实现呢？下面我们就基于 DeepSeek 大模型 + ReAct 框架，实现一个简单的 Agent，办理文章开头提出的那个查询水果价格的问题。
ReAct Agent 实战

申请 api_key

一步一步来。首先，我们需要搞定 DeepSeek 的 api_key。
近来 DeepSeek 实在太火了，由于算力和资源的限定，DeepSeek 的官方平台可能没有那么稳定，我们可以考虑使用大厂的云平台，比如阿里云百炼，使用阿里云私有部署的 DeepSeek 模型。详细的流程就不睁开了，大家按照官网的说明操作即可。

定义 Tools 工具

**工具本质上就是我们为大模型提供的扩展本领，它可以是一些 Open API（如 Google 搜索、高德天气等等），也可以是我们内部的一些函数，乃至是第三方的服务。**这里为了方便演示，我们实现一个本地的函数 query_fruit_unit_price 作为工具, 它以 Mock 的方式查询水果的价格。别的，我们也针对该工具编写标准的调用参数：

1. # -*- coding: utf-8 -*-
2. """
3. @Time    : 2025/3/4 20:35
4. @Author  : ZhangShenao
5. @File    : tools.py
6. @Desc    : 工具模块
7. """
10. def query_fruit_unit_price(fruit_name: str) -> str:
11.     """
12.     查询水果单价
13.     :param fruit_name: 水果名称
14.     :return: 水果单价
15.     """
16.     if fruit_name == "苹果":
17.         return "2.8"
18.     if fruit_name == "香蕉":
19.         return "1.6"
20.     return "未查询到该种类水果的价格"
23. # 可以调用的外部工具描述
24. TOOLS_DESCRIPTION = [
25.     {
26.         "name": "query_fruit_unit_price",
27.         "description": "使用该工具可以查询到指定种类水果的单价",
28.         "parameters": {
29.             "type": "object",
30.             "properties": {
31.                 "fruit_name": {
32.                     "type": "string",
33.                     "description": "水果名称",
34.                 }
35.             },
36.             "required": ["fruit_name"]
37.         },
38.     },
39. ]

复制代码

构造 Promot

ReAct 的 Prompt 比较复杂，但是我们并不需要本身探索，因为 LangChain 官方的 Prompt Hub 中已经提供了一个 Prompt 模版，个人认为这是一段可以封神的 Promopt，我们直接拿来用就可以了。

1. {instructions}
3. TOOLS:
4. ------
6. You have access to the following tools:
8. {tools}
10. To use a tool, please use the following format:
12. ```
13. Thought: Do I need to use a tool? Yes
14. Action: the action to take, should be one of [{tool_names}]
15. Action Input: the input to the action
16. Observation: the result of the action
17. ```
19. When you have a response to say to the Human, or if you do not need to use a tool, you MUST use the format:
21. ```
22. Thought: Do I need to use a tool? No
23. Final Answer: [your response here]
24. ```
26. Begin!
28. Previous conversation history:
29. {chat_history}
31. New input: {input}
32. {agent_scratchpad}

复制代码

这段 Prompt 中重要包罗下面这些关键内容：

• instructions：类似 System Prompt，是为大模型设置的指令和人设。
  
• tools：定义工具列表和描述信息，告诉大模型有哪些工具是可以使用的，而且详细的用法是什么。
  
• chat_history：谈天历史，即对话的上下文信息。
  
• agent_scratchpad：这是一个 Agent 剪贴板，用于记录 Agent 的思索过程。这部分是可选的，并不影响整个 Agent 的执行过程。
  

对这段 Prompt 进行格式化，就可以生成一个完备的 ReAct Prompt 了。

1. # -*- coding: utf-8 -*-
2. """
3. @Time    : 2025/3/4 20:37
4. @Author  : ZhangShenao
5. @File    : prompt.py
6. @Desc    : prompt提示词模块
7. """
8. from typing import List, Dict
10. # ReAct Prompt模板
11. REACT_PROMPT_TEMPLATE = """
12. {instructions}
14. TOOLS:
15. ------
17. You have access to the following tools:
19. {tools}
21. To use a tool, please use the following format:
23. ```
24. Thought: Do I need to use a tool? Yes
25. Action: the action to take, should be one of [{tool_names}]
26. Action Input: the input to the action
27. ```
29. Then wait for Human will response to you the result of action by use Observation.
30. ... (this Thought/Action/Action Input/Observation can repeat N times)
31. When you have a response to say to the Human, or if you do not need to use a tool, you MUST use the format:
33. ```
34. Thought: Do I need to use a tool? No
35. Final Answer: [your response here]
36. ```
38. Begin!
40. New input: {input}
42. """
45. def build_react_prompt(instructions: str, query: str, tool_desc: List[Dict], tool_name: str) -> str:
46.     """
47.     构造ReAct Prompt
48.     :param instructions: 系统指令
49.     :param query: 用户的提问
50.     :param tool_desc: 外部工具描述
51.     :param tool_name: 外部工具名称
52.     :return: React Prompt
53.     """
55.     return REACT_PROMPT_TEMPLATE.format(instructions=instructions,
56.                                         tools=tool_desc,
57.                                         tool_names=tool_name,
58.                                         input=query)

复制代码

封装 LLM

接下来，我们对大模型进行一些简单的封装，便于后面的调用。

1. # -*- coding: utf-8 -*-
2. """
3. @Time    : 2025/3/4 20:45
4. @Author  : ZhangShenao
5. @File    : llm.py
6. @Desc    : LLM大模型模块
7. """
8. import os
9. from typing import List, Dict
11. import dotenv
12. from openai import OpenAI, Stream
13. from openai.types.chat import ChatCompletion, ChatCompletionChunk
16. class LLM:
17.     def __init__(self, model_name: str):
18.         """
19.         初始化LLM大模型
20.         :param model_name: LLM大模型名称
21.         """
23.         # 加载环境变量
24.         dotenv.load_dotenv()
26.         # 创建通义百炼客户端,兼容OpenAI协议
27.         self._client = OpenAI(
28.             api_key=os.getenv("DASHSCOPE_API_KEY"),
29.             base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
30.         )
31.         self._model_name = model_name
33.     def send_msg(self, messages: List[Dict]) -> ChatCompletion | Stream[ChatCompletionChunk]:
34.         """
35.         发送消息
36.         :param messages: 消息列表
37.         :return: 消息发送结果
38.         """
40.         return self._client.chat.completions.create(
41.             model=self._model_name,
42.             messages=messages,
43.         )

复制代码

执行 Agent

1. # -*- coding: utf-8 -*-
2. """
3. @Time    : 2025/3/4 20:45
4. @Author  : ZhangShenao
5. @File    : agent.py
6. @Desc    : Agent模块
7. """
8. import json
9. import re
11. from llm import LLM
12. from prompt import build_react_prompt
13. from tools import TOOLS_DESCRIPTION, query_fruit_unit_price
15. if __name__ == '__main__':
16.     # 构造Prompt
17.     instructions = "你是一个居家生活小助手，可以回答用户的日常问题。"
18.     query = "我想买2个苹果和3根香蕉，一共需要多少钱？"
19.     prompt = build_react_prompt(instructions=instructions,
20.                                 query=query,
21.                                 tool_desc=TOOLS_DESCRIPTION,
22.                                 tool_name="query_fruit_unit_price",
23.                                 )
25.     # 创建LLM
26.     llm = LLM(model_name="deepseek-v3")
28.     # 保存上下文
29.     print(f"初始提问: {prompt}")
30.     messages = [{"role": "user", "content": prompt}]
32.     # 执行ReAct过程
33.     while True:
34.         response = llm.send_msg(messages)
35.         response_text = response.choices[0].message.content
37.         print(f"大模型的回复：\n{response_text}")
39.         # 通过正则表达式匹配,判断是否结束执行
40.         final_answer_match = re.search(r'Final Answer:\s*(.*)', response_text)
41.         if final_answer_match:
42.             final_answer = final_answer_match.group(1)
43.             print("最终答案:", final_answer)
44.             break
46.         # 保存上下文
47.         messages.append(response.choices[0].message)
49.         # 通过正则表达式匹配,解析Function Calling参数
50.         action_match = re.search(r'Action:\s*(\w+)', response_text)
51.         action_input_match = re.search(r'Action Input:\s*({.*?}|".*?")', response_text, re.DOTALL)
53.         # 匹配需要调用的工具
54.         if action_match and action_input_match:
55.             tool_name = action_match.group(1)
56.             params = json.loads(action_input_match.group(1))
57.             print(f"需要执行Function Calling, 工具名称: {tool_name}, 调用参数: {params}")
59.             # 调用工具,获取执行结果
60.             if tool_name == "query_fruit_unit_price":
61.                 observation = query_fruit_unit_price(params['fruit_name'])
62.                 print(f"工具的执行结果: \n{observation}", )
64.                 # 保存上下文
65.                 messages.append({"role": "user", "content": f"Observation: {observation}"})

复制代码

可以看到完备执行过程：

从执行过程可以看出，大模型重要进行了以下的推理过程：

• Planning：判断出需要调用工具。
  
• Action：生成现实的 Function Calling 参数。
  
• Observation: 工具调用完成后，观察执行效果，最终生成回答。
  

可以看出：基于 DeepSeek 模型强盛的推理本领，再联合 ReAct 框架的驱动，我们非常轻松就可以实现一个简单的 Agent。
最后，对于以上的实现做出一些提示：

• 这里我们使用的是 DeepSeek-V3 这个 Chat Model，而并没有选择 DeepSeek-R1 这个 Reasoning Model，因为在我们的场景里，模型的推理本领是由 ReAct Prompt 驱动的，而 DeepSeek-R1 自身内置了思维链，可能与我们的 Prompt 产生冲突。
  
• 最终的执行效果在不同的模型上可能有差异，特别是一些小参数模型，可能无法识别出工具调用，进而产生幻觉。
  
• 在我们的实现中，工具参数调用的解析是基于正则表达式匹配来完成的，这种方式可能存在肯定的偏差，可以接纳大模型的 Function Calling 功能来优化，但是需要对 Prompt 进行一些改造，这个工作就留给大家来完成了。
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。