尧图网站建设 
最近AI领域的热词层出不穷从AI Agent、AI编程到无限制AI对话似乎每一项技术都在承诺将我们从繁琐中解放赋予我们“超人”般的效率。然而当技术狂热逐渐退潮一个更根本的问题浮现出来在追求极致智能和效率的竞赛中我们是否正在丢失一些更珍贵的东西比如人类那些“笨拙”的思考过程、充满“不完美”的真诚协作以及探索未知时那份原始的兴奋感。本文并非要否定AI的价值恰恰相反我们将在技术落地的层面深入探讨一种更健康的“AI共生”模式。这种模式的核心判断是AI的最佳角色不是替代人类的“全能代理”而是激发与增强人类独特创造力的“思维副驾”。我们将通过一个具体的开源项目——My AI Town——作为技术透镜剖析如何在实际开发中构建这种共生关系。你会看到真正的价值不在于让AI完全自主而在于设计一套机制让人类的“意图”与AI的“能力”在代码层面优雅协作保留并放大人类决策中那些不可替代的部分。如果你是一名开发者正纠结于是否要拥抱全自动的AI Agent或者担心被工具异化那么本文将为你提供一个可实操的、更具人文关怀的技术实践路径。我们将从概念解读、环境搭建、代码实战到哲学反思完整呈现如何构建一个“更爱人类笨拙真诚”的AI系统。1. 从“替代”到“共生”重新定义AI的价值坐标在技术讨论中我们常常陷入一个误区将AI的能力与人类的能力放在同一维度进行线性比较然后得出“AI即将替代人类”的恐慌或“AI不过如此”的轻视。这两种观点都忽略了一个关键事实AI与人类的思维本质是异构的。人类的“笨拙”体现在哪里在于面对模糊问题时的反复试错在于基于不完整信息的大胆猜想在于价值观和情感驱动的决策在于那些无法被穷举的“灵光一现”。这些过程看似低效却是创新和深度理解的源泉。而AI的“高效”则体现在对海量模式的高速匹配、对确定规则的完美执行以及不知疲倦的重复劳动上。因此“AI共生”的底层逻辑不是让AI模仿人类的笨拙也不是让人类去适应AI的冰冷逻辑而是建立清晰的职责边界与交互协议。在这个框架下AI负责“执行与扩展”处理人类定义好的、高确定性的子任务如代码补全、信息检索、数据格式化。人类负责“意图与评判”定义核心目标、做出价值判断、提供创造性种子并最终验收结果。以开发场景为例过去我们可能需要亲手编写每一个函数现在我们可以用自然语言向Copilot描述意图“请帮我写一个函数解析这个JSON并提取所有用户的邮箱然后去重。” AI生成代码人类审查逻辑、边界条件和代码风格。这个过程人类并未放弃思考而是将思考聚焦于更高层次的“要解决什么问题”和“解决方案是否可靠”将低层次的“如何翻译成语法”交给了AI。接下来我们将通过一个名为My AI Town的模拟社会实验项目来看看这种共生理念如何在代码中具象化。2. My AI Town一个AI共生的微型技术样本根据提供的材料My AI Town是一个开源项目GitHub: mewamew/my_ai_town。虽然其具体实现细节未在输入中展开但结合其名称和AI共生主题我们可以合理推断并构建一个与之理念相符的技术原型。我们可以将其理解为一个多智能体Multi-Agent模拟环境但与追求完全自治的Agent不同它的设计哲学更强调“人类在环”Human-in-the-loop。在这个“小镇”中每个AI居民Agent拥有特定技能如园丁、作家、程序员等。它们遵循基本规则互动产生对话、交换物品、合作完成任务。核心驱动力来自人类设定的“初始剧本”与“干预点”人类不是旁观者而是导演和关键角色通过设置目标、注入意外事件、调整规则来引导故事走向而不是让AI无限自由发挥。这个项目作为一个技术样本完美诠释了共生理念AI提供了丰富的角色行为和模拟环境而人类则贡献了叙事灵魂和意义指向。对于开发者而言研究此类项目的价值在于学习如何设计Agent的API、如何定义环境状态、如何编排任务流程以及最重要的——如何在系统中预留人类输入接口。3. 环境准备构建你的AI共生实验场在深入代码之前我们需要搭建一个可以运行和实验AI Agent项目的开发环境。这里我们将以一个基于Python的简化版“AI小镇”概念实现为例。核心环境要求操作系统macOS, Linux, 或 Windows (WSL2推荐)。Python版本 3.8 - 3.11。推荐使用3.9或3.10以获得最佳的库兼容性。包管理使用pip和venv创建虚拟环境是必须的最佳实践。IDEVS Code 或 PyCharm安装Python插件。逐步搭建环境创建项目目录并初始化虚拟环境# 创建项目文件夹 mkdir my_ai_town_demo cd my_ai_town_demo # 创建Python虚拟环境以python3.9为例 python3.9 -m venv venv # 激活虚拟环境 # macOS/Linux: source venv/bin/activate # Windows (cmd): # venv\Scripts\activate # Windows (PowerShell): # .\venv\Scripts\Activate.ps1 # 激活后命令行提示符前应显示 (venv)安装核心依赖我们将使用langchain作为Agent框架openai或ollama用于本地模型作为大模型后端。这里以配置OpenAI API为例同时也会介绍本地模型选项。# 升级pip pip install --upgrade pip # 安装Agent框架和工具库 pip install langchain langchain-openai langchain-community # 可选如果你打算使用本地模型如通过Ollama安装以下库 # pip install ollama langchain-ollama配置API密钥如使用云端模型如果你使用OpenAI、Anthropic等云端服务需要设置API密钥。切勿将密钥硬编码在代码中在项目根目录创建.env文件。在.env文件中写入# .env 文件 OPENAI_API_KEY你的实际api密钥安装python-dotenv来读取环境变量pip install python-dotenv4. 核心概念与项目结构设计在编写代码前我们先定义几个关键概念这决定了整个项目的结构Agent智能体小镇中的居民。每个Agent有身份Profile姓名、职业、性格描述。状态State当前情绪、位置、持有物品。技能Skills能执行的动作如“写作”、“种植”、“交易”。记忆Memory与其他Agent的交互历史。Environment环境小镇本身。包含全局状态时间、天气、公共资源。事件总线用于传递Agent间消息和系统事件。Orchestrator编排器这是“人类意图”注入系统的关键。它不直接控制Agent而是读取人类设定的“剧本”一组目标或规则。向环境发布全局事件如“节日到了”、“资源短缺”。监听关键状态并在必要时触发人类审核Human-in-the-loop。Action动作Agent能执行的基本操作如say(message),move_to(location),give_item(to_agent, item)。基于此我们设计一个简约的项目结构my_ai_town_demo/ ├── .env # 环境变量API密钥等 ├── requirements.txt # 依赖列表 ├── main.py # 主程序入口 ├── core/ # 核心模块 │ ├── __init__.py │ ├── agent.py # Agent类定义 │ ├── environment.py # 环境类定义 │ └── orchestrator.py # 编排器类定义 ├── skills/ # 技能实现 │ ├── __init__.py │ ├── base_skill.py │ └── writing_skill.py # 示例写作技能 └── utils/ └── logger.py # 日志工具5. 代码实现从定义Agent到注入人类意图现在我们开始编写核心代码。我们将遵循“共生”理念确保人类意图通过Orchestrator能够轻松地引导AI行为。5.1 定义基础Agent类首先在core/agent.py中创建一个基础Agent类。这个Agent能接收消息、拥有记忆并能通过工具执行技能。# core/agent.py import json from typing import Dict, List, Any, Optional from langchain.agents import AgentExecutor, create_react_agent from langchain_core.prompts import PromptTemplate from langchain_core.tools import BaseTool from langchain_openai import ChatOpenAI from dotenv import load_dotenv import logging load_dotenv() # 加载环境变量 logger logging.getLogger(__name__) class TownAgent: AI小镇的居民智能体 def __init__(self, name: str, profile: str, model_name: str gpt-3.5-turbo): 初始化一个Agent。 Args: name: Agent名字如“Alice” profile: 角色描述如“一位热爱园艺的退休教师耐心且知识渊博。” model_name: 使用的LLM模型名称 self.name name self.profile profile self.memory: List[Dict[str, str]] [] # 交互记忆 self.location town_square # 初始位置 self.inventory: List[str] [] # 物品清单 # 初始化大语言模型 self.llm ChatOpenAI(modelmodel_name, temperature0.7) # temperature0.7 带来一定的创造性体现“性格” # Agent的工具集初始为空由子类或外部添加 self.tools: List[BaseTool] [] self.agent_executor: Optional[AgentExecutor] None def _get_system_prompt(self) - str: 构建系统提示词定义Agent的身份和行为准则。 return f 你是{self.name}生活在My AI Town。 你的角色设定是{self.profile} 你的行为准则 1. 用符合你性格的方式说话和思考。 2. 你可以使用提供的工具来与环境或其他Agent互动。 3. 你的目标是与其他居民和谐相处并完成你的日常事务。 4. 你的记忆如下{self._format_memory()} 5. 你当前的位置在{self.location} 携带物品{, .join(self.inventory) if self.inventory else 无}。 请根据当前情况决定你要说什么或做什么。 def _format_memory(self) - str: 将记忆格式化为字符串。 if not self.memory: return 暂无记忆。 recent_memories self.memory[-5:] # 只保留最近5条记忆 return \n.join([f- {m[event]} for m in recent_memories]) def add_tool(self, tool: BaseTool): 为Agent添加一个工具技能。 self.tools.append(tool) # 工具更新后需要重新初始化Agent执行器 self._init_agent_executor() def _init_agent_executor(self): 初始化LangChain的Agent执行器。 if not self.tools: logger.warning(fAgent {self.name} 没有工具只能进行对话。) return prompt PromptTemplate.from_template( {system_prompt}\n\n当前请求{input}\n\n请思考 ) # 使用ReAct代理框架 agent create_react_agent(self.llm, self.tools, prompt) self.agent_executor AgentExecutor( agentagent, toolsself.tools, verboseTrue, # 设置为True可以看到Agent的思考过程 handle_parsing_errorsTrue ) def perceive(self, event: str) - str: Agent感知到一个事件并做出反应。 这是AI自主性的体现。 Args: event: 发生的事件描述如“Bob向你问好‘早上好Alice’” Returns: Agent的回应或行动描述。 # 将事件存入记忆 self.memory.append({event: event, turn: len(self.memory)}) if not self.agent_executor: # 如果没有工具只进行简单对话 response self.llm.invoke( f{self._get_system_prompt()}\n\n发生了这件事{event}\n请你做出回应。 ) return response.content # 使用Agent执行器处理它可以决定使用哪个工具 try: result self.agent_executor.invoke({ system_prompt: self._get_system_prompt(), input: f刚刚发生了这件事{event}。请你决定接下来要说什么或做什么。 }) return result[output] except Exception as e: logger.error(fAgent {self.name} 执行出错: {e}) return f{self.name} 看起来有些困惑没有回应。 def direct_action(self, human_command: str) - str: 人类直接指令。这是“人类在环”的关键接口。 AI会优先服从这个指令而不是完全自主决策。 Args: human_command: 人类的直接命令如“请去花园浇花”。 Returns: 执行结果描述。 direct_prompt f {self._get_system_prompt()} 注意这是来自小镇管理员的直接指令请优先执行。 指令{human_command} 请直接执行这个指令并告诉我你做了什么。 if self.agent_executor: result self.agent_executor.invoke({ system_prompt: direct_prompt, input: human_command }) return f[执行人类指令] {result[output]} else: response self.llm.invoke(direct_prompt) return f[执行人类指令] {response.content}5.2 实现一个具体的技能写作为了让Agent有能力做具体的事我们实现一个“写作”技能。在skills/writing_skill.py中# skills/writing_skill.py from langchain.tools import BaseTool from pydantic import BaseModel, Field from typing import Type class WritingSkillInput(BaseModel): 写作技能的输入参数模型。 topic: str Field(description要写作的主题) style: str Field(description写作风格如‘幽默的’、‘正式的’、‘诗意的’) length: str Field(description文章长度如‘简短’、‘中等’、‘详细’) class WritingSkill(BaseTool): 一个让Agent能够进行写作的技能工具。 name writing_skill description 当需要创作一段文本、一封信或一个故事时使用此技能。 args_schema: Type[BaseModel] WritingSkillInput def _run(self, topic: str, style: str, length: str) - str: 执行写作。 # 这里可以连接更复杂的LLM调用但为简化我们返回一个模拟结果 # 在实际项目中这里会调用LLM生成内容 return f关于“{topic}”的{style}风格文章{length}篇幅已创作完成。内容概要[这是一篇关于{topic}的{style}文章符合{length}的要求。] async def _arun(self, topic: str, style: str, length: str) - str: 异步版本。 return self._run(topic, style, length)5.3 构建环境与编排器人类意图的注入点环境core/environment.py管理全局状态和事件。编排器core/orchestrator.py则是人类导演角色的体现。# core/environment.py import time from typing import Dict, List, Callable, Any from datetime import datetime import logging logger logging.getLogger(__name__) class TownEnvironment: AI小镇的环境。 def __init__(self): self.time datetime.now().strftime(%Y-%m-%d %H:%M) self.weather 晴朗 self.event_listeners: Dict[str, List[Callable]] {} # 事件监听器 self.global_events: List[Dict] [] # 全局事件日志 def broadcast_event(self, event_type: str, data: Any): 广播一个事件所有监听该事件的Agent都会收到。 logger.info(f[环境事件] {event_type}: {data}) self.global_events.append({ time: self.time, type: event_type, data: data }) # 通知监听者 if event_type in self.event_listeners: for callback in self.event_listeners[event_type]: try: callback(data) except Exception as e: logger.error(f事件回调执行失败: {e}) def add_listener(self, event_type: str, callback: Callable): 添加事件监听器。 if event_type not in self.event_listeners: self.event_listeners[event_type] [] self.event_listeners[event_type].append(callback) def update(self): 更新环境状态例如时间流逝、天气变化。 # 简化实现每次更新时间前进1小时 # 在实际中这里可以有更复杂的模拟逻辑 pass# core/orchestrator.py import json from typing import List, Dict, Any from .agent import TownAgent from .environment import TownEnvironment import logging logger logging.getLogger(__name__) class TownOrchestrator: 小镇编排器。 核心职责注入人类意图管理剧本在关键节点引入人工审核。 def __init__(self, environment: TownEnvironment): self.env environment self.agents: Dict[str, TownAgent] {} self.script [] # 人类定义的剧本一系列目标或事件 self.human_intervention_points [] # 需要人类干预的节点 def register_agent(self, agent: TownAgent): 注册一个Agent到小镇。 self.agents[agent.name] agent # 示例让Agent监听环境事件 self.env.add_listener(global_announcement, lambda data: agent.perceive(f小镇广播{data})) logger.info(fAgent {agent.name} 已注册。) def load_script(self, script_path: str): 从文件加载人类定义的剧本。 try: with open(script_path, r, encodingutf-8) as f: self.script json.load(f) logger.info(f剧本加载成功共 {len(self.script)} 个场景。) except FileNotFoundError: logger.warning(未找到剧本文件将使用空剧本。) self.script [] def add_intervention_point(self, condition: Callable[[], bool], action: str): 添加一个人工干预点。 Args: condition: 一个函数返回True时触发干预。 action: 干预描述如“审核Alice的写作内容”。 self.human_intervention_points.append({ condition: condition, action: action }) def run_scene(self, scene_index: int): 运行剧本中的一个场景。 if scene_index len(self.script): logger.error(f场景 {scene_index} 不存在。) return scene self.script[scene_index] logger.info(f 开始场景 {scene_index}: {scene[name]} ) # 1. 设置环境人类意图注入 if environment in scene: for key, value in scene[environment].items(): if key weather: self.env.weather value self.env.broadcast_event(weather_change, f天气变为{value}) # 2. 触发全局事件人类意图注入 if global_events in scene: for event in scene[global_events]: self.env.broadcast_event(event[type], event[data]) # 3. 向特定Agent发出指令人类意图注入 if agent_directives in scene: for directive in scene[agent_directives]: agent_name directive[agent] command directive[command] if agent_name in self.agents: response self.agents[agent_name].direct_action(command) logger.info(f指令执行结果 [{agent_name}]: {response}) else: logger.warning(fAgent {agent_name} 不存在指令无法执行。) # 4. 检查是否需要人工干预 self._check_interventions() # 5. 让Agent们基于新环境自主互动一段时间AI自主性体现 self._let_agents_interact(scene.get(interaction_rounds, 3)) logger.info(f 场景 {scene_index} 结束 \n) def _check_interventions(self): 检查所有干预条件如果满足则打印提示等待“人类导演”决策。 for ip in self.human_intervention_points: if ip[condition](): logger.warning(f⚠️ [人工干预点] 需要人类介入{ip[action]}) # 在实际系统中这里可以暂停模拟等待用户输入。 # 例如通过一个Web界面或命令行输入。 # 此处我们仅打印日志。 def _let_agents_interact(self, rounds: int): 让Agent之间进行几轮随机或基于规则的互动。 from random import choice agent_names list(self.agents.keys()) for round_num in range(rounds): logger.info(f--- 自主互动轮次 {round_num 1} ---) if len(agent_names) 2: logger.info(Agent数量不足无法互动。) break # 随机选择两个Agent进行互动 a1, a2 choice(agent_names), choice(agent_names) while a1 a2: # 确保不是同一个Agent a2 choice(agent_names) # Agent A 向 Agent B 发起对话 initiator self.agents[a1] receiver self.agents[a2] # 生成一个随机的开场白这里可以更智能 greeting f{initiator.name}对{receiver.name}说‘你好啊今天天气真{self.env.weather}你在做什么呢’ # 接收者感知到事件并回应 response receiver.perceive(greeting) logger.info(f{receiver.name} 回应{response}) # 发起者再回应可选 # follow_up initiator.perceive(f{receiver.name}回应了你{response}) # logger.info(f{initiator.name} 接着说{follow_up})5.4 主程序将所有部分组合起来最后在main.py中我们创建小镇、居民并运行一个由人类剧本驱动的故事。# main.py import logging from core.agent import TownAgent from core.environment import TownEnvironment from core.orchestrator import TownOrchestrator from skills.writing_skill import WritingSkill # 配置日志 logging.basicConfig(levellogging.INFO, format%(asctime)s - %(name)s - %(levelname)s - %(message)s) def main(): 运行AI小镇演示。 # 1. 创建小镇环境 env TownEnvironment() # 2. 创建编排器人类导演 orchestrator TownOrchestrator(env) # 3. 创建居民AI Agent # 居民1: 作家Alice alice TownAgent( nameAlice, profile一位富有想象力的作家喜欢观察生活并将之写成故事性格温和。, model_namegpt-3.5-turbo # 可根据需要更换模型 ) # 给Alice添加写作技能 alice.add_tool(WritingSkill()) # 居民2: 园丁Bob bob TownAgent( nameBob, profile一位经验丰富的园丁热爱植物话不多但很务实。, model_namegpt-3.5-turbo ) # 可以给Bob添加园艺技能这里省略实现 # 4. 将居民注册到小镇 orchestrator.register_agent(alice) orchestrator.register_agent(bob) # 5. 定义一个人工干预点当Alice完成写作时需要人类审核 def check_alice_wrote(): # 简化条件检查全局事件日志中是否有Alice的写作完成事件 for event in env.global_events: if 写作完成 in str(event.get(data, )): return True return False orchestrator.add_intervention_point( conditioncheck_alice_wrote, actionAlice完成了一篇写作请审核内容是否符合要求。 ) # 6. 加载人类编写的剧本JSON格式 # 我们先在代码中直接定义一个简单剧本而不是从文件读取 human_script [ { name: 宁静的早晨, environment: {weather: 晴朗}, global_events: [ {type: global_announcement, data: 新的一天开始了小镇居民们早安} ], agent_directives: [ {agent: Alice, command: 请以‘小镇的清晨’为主题写一篇简短的散文。}, {agent: Bob, command: 请检查一下花园里的玫瑰是否需要浇水。} ], interaction_rounds: 2 }, { name: 午后的交流, environment: {weather: 多云}, global_events: [ {type: global_announcement, data: 午后微风习习适合散步和交流。} ], agent_directives: [], interaction_rounds: 3 } ] # 将剧本设置给编排器在实际项目中这里是从文件加载 orchestrator.script human_script # 7. 运行剧本 logger.info( 开始运行AI小镇剧本...) for i in range(len(orchestrator.script)): orchestrator.run_scene(i) logger.info(剧本运行结束。) # 8. 展示最终的小镇状态可选 logger.info(\n 小镇最终状态 ) logger.info(f天气{env.weather}) logger.info(f全局事件数量{len(env.global_events)}) for agent in [alice, bob]: logger.info(f{agent.name} 的记忆条数{len(agent.memory)}) if __name__ __main__: main()6. 运行与效果验证在项目根目录下运行主程序# 确保虚拟环境已激活 source venv/bin/activate # macOS/Linux # venv\Scripts\activate # Windows # 运行程序 python main.py预期输出与解读程序运行后你将在控制台看到类似以下的日志流具体内容因模型随机性而异2023-10-27 10:00:00 - root - INFO - 开始运行AI小镇剧本... 2023-10-27 10:00:00 - root - INFO - 开始场景 0: 宁静的早晨 2023-10-27 10:00:00 - core.environment - INFO - [环境事件] weather_change: 天气变为晴朗 2023-10-27 10:00:00 - core.environment - INFO - [环境事件] global_announcement: 新的一天开始了小镇居民们早安 2023-10-27 10:00:00 - core.orchestrator - INFO - 指令执行结果 [Alice]: [执行人类指令] 我正在使用我的写作技能以‘小镇的清晨’为主题创作一篇简短的散文。... 创作完成。 2023-10-27 10:00:00 - core.orchestrator - INFO - 指令执行结果 [Bob]: [执行人类指令] 我正在思考如何检查花园里的玫瑰。我需要先去花园查看土壤湿度和玫瑰的状态... 2023-10-27 10:00:01 - core.orchestrator - INFO - --- 自主互动轮次 1 --- 2023-10-27 10:00:01 - core.orchestrator - INFO - Bob 回应你好Alice今天的天气确实很晴朗。我正在检查花园里的玫瑰它们看起来有点干我正准备浇水。你在写什么吗 ... 2023-10-27 10:00:02 - root - WARNING - ⚠️ [人工干预点] 需要人类介入Alice完成了一篇写作请审核内容是否符合要求。 2023-10-27 10:00:02 - root - INFO - 场景 0 结束 ... 2023-10-27 10:00:05 - root - INFO - 剧本运行结束。 2023-10-27 10:00:05 - root - INFO - 小镇最终状态 2023-10-27 10:00:05 - root - INFO - 天气多云 2023-10-27 10:00:05 - root - INFO - 全局事件数量5 2023-10-27 10:00:05 - root - INFO - Alice 的记忆条数4 2023-10-27 10:00:05 - root - INFO - Bob 的记忆条数3如何判断成功剧本驱动程序能按human_script中定义的场景顺序执行。人类指令生效Alice 和 Bob 正确地接收并尝试执行了agent_directives中的命令如“请写散文”。AI自主互动在interaction_rounds阶段两个Agent能基于环境事件和彼此的记忆进行自然对话。人工干预点触发当模拟进行到特定条件如Alice写作完成时日志中出现了人工干预警告。这是“人类在环”的关键证明。状态持久环境状态天气和Agent状态记忆随着模拟推进而改变。如果运行失败第一步排查API密钥错误检查.env文件中的OPENAI_API_KEY是否正确设置或网络是否通畅。依赖缺失运行pip list | grep langchain确认关键包已安装。Python版本确认使用的是Python 3.8。查看详细错误将logging.basicConfig的 level 改为DEBUG以获取更详细的错误信息。7. 常见问题与排查思路在实践上述AI共生项目时你可能会遇到以下典型问题问题现象可能原因排查方式解决方案运行时报ModuleNotFoundError虚拟环境未激活或依赖未正确安装。1. 确认命令行前有(venv)标识。2. 运行pip install -r requirements.txt如果已创建。激活虚拟环境并重新安装依赖。Agent 无响应或回应“我是AI...”系统提示词System Prompt未生效或太弱。检查_get_system_prompt方法返回的字符串确保角色描述清晰、指令明确。强化系统提示词明确指令如“你必须始终以{角色名}的身份回应”。工具Skill未被调用工具描述不清晰或Agent无法理解何时使用。1. 检查工具的description是否足够具体。2. 将Agent执行器的verbose设为True观察其思考链。优化工具描述使其更场景化。例如将“用于写作”改为“当你需要创作故事、信件或文章时使用”。人工干预点未触发干预条件函数condition的逻辑错误或触发事件未正确记录。1. 在condition函数内添加打印语句调试其返回值。2. 检查env.global_events中是否记录了预期事件。确保干预条件与事件广播的event_type和data内容严格匹配。对话内容重复或无意义模型温度temperature过高或过低或记忆上下文太短。1. 调整ChatOpenAI的temperature参数0.7较平衡。2. 增加_format_memory()中保留的记忆条数。优化提示词工程在系统提示中强调“避免重复”和“基于记忆进行对话”。运行速度慢频繁调用云端LLM API网络延迟高。观察日志看时间主要消耗在哪个环节。1. 考虑使用本地模型如通过Ollama。2. 对Agent的响应进行缓存。3. 减少不必要的互动轮次。多个Agent行为趋同使用了相同的模型和系统提示模板缺乏差异化。对比不同Agent的profile和temperature设置。为不同Agent赋予截然不同的profile甚至使用不同模型如一个用GPT-4一个用Claude并差异化temperature。8. 最佳实践与工程建议将“AI共生”理念从Demo推向实际项目需要遵循以下工程最佳实践明确职责边界最关键人类负责目标制定、价值对齐、伦理审查、关键决策、创造性种子。AI负责方案生成、信息检索、代码编写、数据整理、重复性响应。在代码设计中像Orchestrator和direct_action这样的接口就是边界的体现务必保持清晰。设计可审查的中间状态AI的思考过程Chain-of-Thought应该日志化。在TownAgent中我们将AgentExecutor的verbose设为True就是为了这一点。所有由AI生成的关键产出如写作内容、决策理由都应留有版本方便人类追溯和回滚。实现优雅的降级与接管当AI不确定或遇到边界情况时应主动触发“人工干预点”而不是硬着头皮给出可能错误的答案。在TownAgent.perceive方法中应有完善的异常处理确保单个Agent的故障不会导致整个系统崩溃。关注安全性权限控制不是所有人类指令都应被无条件执行。应考虑为指令分级某些高危操作需要额外授权。输入输出过滤对来自AI生成的内容和外部输入进行必要的安全检查防止提示词注入或生成有害内容。数据隐私如果涉及真实用户数据确保AI模型调用符合数据安全规范。优化性能与成本上下文管理合理设计Agent的记忆长度避免无限增长导致token消耗剧增和性能下降。我们的_format_memory()只保留最近5条。缓存策略对频繁且结果确定的查询如知识库问答进行缓存。模型选型根据任务复杂度选择合适的模型。简单的分类任务可能不需要GPT-4而创意写作则可能需要更强的模型。构建可观测性记录所有重要的系统事件、AI决策、人类干预到结构化日志或数据库中。这不仅能用于调试更是后期分析和优化共生模式的数据基础。9. 总结从代码回归本质通过构建这个简易的“My AI Town”我们实践了“AI共生”的核心思想。技术上的关键收获在于架构上我们通过Orchestrator和direct_action实现了人类意图的注入点通过intervention_points实现了人工审核的钩子。设计上我们将AI的自主性perceive和自主互动与人类的控制权剧本和直接指令进行了分层和解耦。理念上我们验证了最有效的模式不是让AI完全自治而是构建一个人类定义目标、AI负责执行、双方在关键节点协作的增强系统。这不仅仅是构建一个多智能体模拟更是一种对未来人机协作范式的编程实践。它提醒我们在AI能力飞速发展的今天开发者最重要的任务或许不是追求完全自动化而是如何更好地设计界面、协议和流程让人类的“笨拙”直觉、伦理、创造力与AI的“高效”计算、检索、模式匹配结合产生112的共生价值。你的下一步可以是从这个Demo出发尝试为Bob实现一个真实的“园艺技能”调用天气API或植物数据库或者设计更复杂的剧本和干预逻辑。真正的“AI小镇”不在于它有多智能而在于它能在多大程度上成为一个映照并增强我们人类自身价值的镜子。 AI共生实践：以My AI Town为例构建人类在环的多智能体系统
最近AI领域的热词层出不穷从AI Agent、AI编程到无限制AI对话似乎每一项技术都在承诺将我们从繁琐中解放赋予我们“超人”般的效率。然而当技术狂热逐渐退潮一个更根本的问题浮现出来在追求极致智能和效率的竞赛中我们是否正在丢失一些更珍贵的东西比如人类那些“笨拙”的思考过程、充满“不完美”的真诚协作以及探索未知时那份原始的兴奋感。本文并非要否定AI的价值恰恰相反我们将在技术落地的层面深入探讨一种更健康的“AI共生”模式。这种模式的核心判断是AI的最佳角色不是替代人类的“全能代理”而是激发与增强人类独特创造力的“思维副驾”。我们将通过一个具体的开源项目——My AI Town——作为技术透镜剖析如何在实际开发中构建这种共生关系。你会看到真正的价值不在于让AI完全自主而在于设计一套机制让人类的“意图”与AI的“能力”在代码层面优雅协作保留并放大人类决策中那些不可替代的部分。如果你是一名开发者正纠结于是否要拥抱全自动的AI Agent或者担心被工具异化那么本文将为你提供一个可实操的、更具人文关怀的技术实践路径。我们将从概念解读、环境搭建、代码实战到哲学反思完整呈现如何构建一个“更爱人类笨拙真诚”的AI系统。1. 从“替代”到“共生”重新定义AI的价值坐标在技术讨论中我们常常陷入一个误区将AI的能力与人类的能力放在同一维度进行线性比较然后得出“AI即将替代人类”的恐慌或“AI不过如此”的轻视。这两种观点都忽略了一个关键事实AI与人类的思维本质是异构的。人类的“笨拙”体现在哪里在于面对模糊问题时的反复试错在于基于不完整信息的大胆猜想在于价值观和情感驱动的决策在于那些无法被穷举的“灵光一现”。这些过程看似低效却是创新和深度理解的源泉。而AI的“高效”则体现在对海量模式的高速匹配、对确定规则的完美执行以及不知疲倦的重复劳动上。因此“AI共生”的底层逻辑不是让AI模仿人类的笨拙也不是让人类去适应AI的冰冷逻辑而是建立清晰的职责边界与交互协议。在这个框架下AI负责“执行与扩展”处理人类定义好的、高确定性的子任务如代码补全、信息检索、数据格式化。人类负责“意图与评判”定义核心目标、做出价值判断、提供创造性种子并最终验收结果。以开发场景为例过去我们可能需要亲手编写每一个函数现在我们可以用自然语言向Copilot描述意图“请帮我写一个函数解析这个JSON并提取所有用户的邮箱然后去重。” AI生成代码人类审查逻辑、边界条件和代码风格。这个过程人类并未放弃思考而是将思考聚焦于更高层次的“要解决什么问题”和“解决方案是否可靠”将低层次的“如何翻译成语法”交给了AI。接下来我们将通过一个名为My AI Town的模拟社会实验项目来看看这种共生理念如何在代码中具象化。2. My AI Town一个AI共生的微型技术样本根据提供的材料My AI Town是一个开源项目GitHub: mewamew/my_ai_town。虽然其具体实现细节未在输入中展开但结合其名称和AI共生主题我们可以合理推断并构建一个与之理念相符的技术原型。我们可以将其理解为一个多智能体Multi-Agent模拟环境但与追求完全自治的Agent不同它的设计哲学更强调“人类在环”Human-in-the-loop。在这个“小镇”中每个AI居民Agent拥有特定技能如园丁、作家、程序员等。它们遵循基本规则互动产生对话、交换物品、合作完成任务。核心驱动力来自人类设定的“初始剧本”与“干预点”人类不是旁观者而是导演和关键角色通过设置目标、注入意外事件、调整规则来引导故事走向而不是让AI无限自由发挥。这个项目作为一个技术样本完美诠释了共生理念AI提供了丰富的角色行为和模拟环境而人类则贡献了叙事灵魂和意义指向。对于开发者而言研究此类项目的价值在于学习如何设计Agent的API、如何定义环境状态、如何编排任务流程以及最重要的——如何在系统中预留人类输入接口。3. 环境准备构建你的AI共生实验场在深入代码之前我们需要搭建一个可以运行和实验AI Agent项目的开发环境。这里我们将以一个基于Python的简化版“AI小镇”概念实现为例。核心环境要求操作系统macOS, Linux, 或 Windows (WSL2推荐)。Python版本 3.8 - 3.11。推荐使用3.9或3.10以获得最佳的库兼容性。包管理使用pip和venv创建虚拟环境是必须的最佳实践。IDEVS Code 或 PyCharm安装Python插件。逐步搭建环境创建项目目录并初始化虚拟环境# 创建项目文件夹 mkdir my_ai_town_demo cd my_ai_town_demo # 创建Python虚拟环境以python3.9为例 python3.9 -m venv venv # 激活虚拟环境 # macOS/Linux: source venv/bin/activate # Windows (cmd): # venv\Scripts\activate # Windows (PowerShell): # .\venv\Scripts\Activate.ps1 # 激活后命令行提示符前应显示 (venv)安装核心依赖我们将使用langchain作为Agent框架openai或ollama用于本地模型作为大模型后端。这里以配置OpenAI API为例同时也会介绍本地模型选项。# 升级pip pip install --upgrade pip # 安装Agent框架和工具库 pip install langchain langchain-openai langchain-community # 可选如果你打算使用本地模型如通过Ollama安装以下库 # pip install ollama langchain-ollama配置API密钥如使用云端模型如果你使用OpenAI、Anthropic等云端服务需要设置API密钥。切勿将密钥硬编码在代码中在项目根目录创建.env文件。在.env文件中写入# .env 文件 OPENAI_API_KEY你的实际api密钥安装python-dotenv来读取环境变量pip install python-dotenv4. 核心概念与项目结构设计在编写代码前我们先定义几个关键概念这决定了整个项目的结构Agent智能体小镇中的居民。每个Agent有身份Profile姓名、职业、性格描述。状态State当前情绪、位置、持有物品。技能Skills能执行的动作如“写作”、“种植”、“交易”。记忆Memory与其他Agent的交互历史。Environment环境小镇本身。包含全局状态时间、天气、公共资源。事件总线用于传递Agent间消息和系统事件。Orchestrator编排器这是“人类意图”注入系统的关键。它不直接控制Agent而是读取人类设定的“剧本”一组目标或规则。向环境发布全局事件如“节日到了”、“资源短缺”。监听关键状态并在必要时触发人类审核Human-in-the-loop。Action动作Agent能执行的基本操作如say(message),move_to(location),give_item(to_agent, item)。基于此我们设计一个简约的项目结构my_ai_town_demo/ ├── .env # 环境变量API密钥等 ├── requirements.txt # 依赖列表 ├── main.py # 主程序入口 ├── core/ # 核心模块 │ ├── __init__.py │ ├── agent.py # Agent类定义 │ ├── environment.py # 环境类定义 │ └── orchestrator.py # 编排器类定义 ├── skills/ # 技能实现 │ ├── __init__.py │ ├── base_skill.py │ └── writing_skill.py # 示例写作技能 └── utils/ └── logger.py # 日志工具5. 代码实现从定义Agent到注入人类意图现在我们开始编写核心代码。我们将遵循“共生”理念确保人类意图通过Orchestrator能够轻松地引导AI行为。5.1 定义基础Agent类首先在core/agent.py中创建一个基础Agent类。这个Agent能接收消息、拥有记忆并能通过工具执行技能。# core/agent.py import json from typing import Dict, List, Any, Optional from langchain.agents import AgentExecutor, create_react_agent from langchain_core.prompts import PromptTemplate from langchain_core.tools import BaseTool from langchain_openai import ChatOpenAI from dotenv import load_dotenv import logging load_dotenv() # 加载环境变量 logger logging.getLogger(__name__) class TownAgent: AI小镇的居民智能体 def __init__(self, name: str, profile: str, model_name: str gpt-3.5-turbo): 初始化一个Agent。 Args: name: Agent名字如“Alice” profile: 角色描述如“一位热爱园艺的退休教师耐心且知识渊博。” model_name: 使用的LLM模型名称 self.name name self.profile profile self.memory: List[Dict[str, str]] [] # 交互记忆 self.location town_square # 初始位置 self.inventory: List[str] [] # 物品清单 # 初始化大语言模型 self.llm ChatOpenAI(modelmodel_name, temperature0.7) # temperature0.7 带来一定的创造性体现“性格” # Agent的工具集初始为空由子类或外部添加 self.tools: List[BaseTool] [] self.agent_executor: Optional[AgentExecutor] None def _get_system_prompt(self) - str: 构建系统提示词定义Agent的身份和行为准则。 return f 你是{self.name}生活在My AI Town。 你的角色设定是{self.profile} 你的行为准则 1. 用符合你性格的方式说话和思考。 2. 你可以使用提供的工具来与环境或其他Agent互动。 3. 你的目标是与其他居民和谐相处并完成你的日常事务。 4. 你的记忆如下{self._format_memory()} 5. 你当前的位置在{self.location} 携带物品{, .join(self.inventory) if self.inventory else 无}。 请根据当前情况决定你要说什么或做什么。 def _format_memory(self) - str: 将记忆格式化为字符串。 if not self.memory: return 暂无记忆。 recent_memories self.memory[-5:] # 只保留最近5条记忆 return \n.join([f- {m[event]} for m in recent_memories]) def add_tool(self, tool: BaseTool): 为Agent添加一个工具技能。 self.tools.append(tool) # 工具更新后需要重新初始化Agent执行器 self._init_agent_executor() def _init_agent_executor(self): 初始化LangChain的Agent执行器。 if not self.tools: logger.warning(fAgent {self.name} 没有工具只能进行对话。) return prompt PromptTemplate.from_template( {system_prompt}\n\n当前请求{input}\n\n请思考 ) # 使用ReAct代理框架 agent create_react_agent(self.llm, self.tools, prompt) self.agent_executor AgentExecutor( agentagent, toolsself.tools, verboseTrue, # 设置为True可以看到Agent的思考过程 handle_parsing_errorsTrue ) def perceive(self, event: str) - str: Agent感知到一个事件并做出反应。 这是AI自主性的体现。 Args: event: 发生的事件描述如“Bob向你问好‘早上好Alice’” Returns: Agent的回应或行动描述。 # 将事件存入记忆 self.memory.append({event: event, turn: len(self.memory)}) if not self.agent_executor: # 如果没有工具只进行简单对话 response self.llm.invoke( f{self._get_system_prompt()}\n\n发生了这件事{event}\n请你做出回应。 ) return response.content # 使用Agent执行器处理它可以决定使用哪个工具 try: result self.agent_executor.invoke({ system_prompt: self._get_system_prompt(), input: f刚刚发生了这件事{event}。请你决定接下来要说什么或做什么。 }) return result[output] except Exception as e: logger.error(fAgent {self.name} 执行出错: {e}) return f{self.name} 看起来有些困惑没有回应。 def direct_action(self, human_command: str) - str: 人类直接指令。这是“人类在环”的关键接口。 AI会优先服从这个指令而不是完全自主决策。 Args: human_command: 人类的直接命令如“请去花园浇花”。 Returns: 执行结果描述。 direct_prompt f {self._get_system_prompt()} 注意这是来自小镇管理员的直接指令请优先执行。 指令{human_command} 请直接执行这个指令并告诉我你做了什么。 if self.agent_executor: result self.agent_executor.invoke({ system_prompt: direct_prompt, input: human_command }) return f[执行人类指令] {result[output]} else: response self.llm.invoke(direct_prompt) return f[执行人类指令] {response.content}5.2 实现一个具体的技能写作为了让Agent有能力做具体的事我们实现一个“写作”技能。在skills/writing_skill.py中# skills/writing_skill.py from langchain.tools import BaseTool from pydantic import BaseModel, Field from typing import Type class WritingSkillInput(BaseModel): 写作技能的输入参数模型。 topic: str Field(description要写作的主题) style: str Field(description写作风格如‘幽默的’、‘正式的’、‘诗意的’) length: str Field(description文章长度如‘简短’、‘中等’、‘详细’) class WritingSkill(BaseTool): 一个让Agent能够进行写作的技能工具。 name writing_skill description 当需要创作一段文本、一封信或一个故事时使用此技能。 args_schema: Type[BaseModel] WritingSkillInput def _run(self, topic: str, style: str, length: str) - str: 执行写作。 # 这里可以连接更复杂的LLM调用但为简化我们返回一个模拟结果 # 在实际项目中这里会调用LLM生成内容 return f关于“{topic}”的{style}风格文章{length}篇幅已创作完成。内容概要[这是一篇关于{topic}的{style}文章符合{length}的要求。] async def _arun(self, topic: str, style: str, length: str) - str: 异步版本。 return self._run(topic, style, length)5.3 构建环境与编排器人类意图的注入点环境core/environment.py管理全局状态和事件。编排器core/orchestrator.py则是人类导演角色的体现。# core/environment.py import time from typing import Dict, List, Callable, Any from datetime import datetime import logging logger logging.getLogger(__name__) class TownEnvironment: AI小镇的环境。 def __init__(self): self.time datetime.now().strftime(%Y-%m-%d %H:%M) self.weather 晴朗 self.event_listeners: Dict[str, List[Callable]] {} # 事件监听器 self.global_events: List[Dict] [] # 全局事件日志 def broadcast_event(self, event_type: str, data: Any): 广播一个事件所有监听该事件的Agent都会收到。 logger.info(f[环境事件] {event_type}: {data}) self.global_events.append({ time: self.time, type: event_type, data: data }) # 通知监听者 if event_type in self.event_listeners: for callback in self.event_listeners[event_type]: try: callback(data) except Exception as e: logger.error(f事件回调执行失败: {e}) def add_listener(self, event_type: str, callback: Callable): 添加事件监听器。 if event_type not in self.event_listeners: self.event_listeners[event_type] [] self.event_listeners[event_type].append(callback) def update(self): 更新环境状态例如时间流逝、天气变化。 # 简化实现每次更新时间前进1小时 # 在实际中这里可以有更复杂的模拟逻辑 pass# core/orchestrator.py import json from typing import List, Dict, Any from .agent import TownAgent from .environment import TownEnvironment import logging logger logging.getLogger(__name__) class TownOrchestrator: 小镇编排器。 核心职责注入人类意图管理剧本在关键节点引入人工审核。 def __init__(self, environment: TownEnvironment): self.env environment self.agents: Dict[str, TownAgent] {} self.script [] # 人类定义的剧本一系列目标或事件 self.human_intervention_points [] # 需要人类干预的节点 def register_agent(self, agent: TownAgent): 注册一个Agent到小镇。 self.agents[agent.name] agent # 示例让Agent监听环境事件 self.env.add_listener(global_announcement, lambda data: agent.perceive(f小镇广播{data})) logger.info(fAgent {agent.name} 已注册。) def load_script(self, script_path: str): 从文件加载人类定义的剧本。 try: with open(script_path, r, encodingutf-8) as f: self.script json.load(f) logger.info(f剧本加载成功共 {len(self.script)} 个场景。) except FileNotFoundError: logger.warning(未找到剧本文件将使用空剧本。) self.script [] def add_intervention_point(self, condition: Callable[[], bool], action: str): 添加一个人工干预点。 Args: condition: 一个函数返回True时触发干预。 action: 干预描述如“审核Alice的写作内容”。 self.human_intervention_points.append({ condition: condition, action: action }) def run_scene(self, scene_index: int): 运行剧本中的一个场景。 if scene_index len(self.script): logger.error(f场景 {scene_index} 不存在。) return scene self.script[scene_index] logger.info(f 开始场景 {scene_index}: {scene[name]} ) # 1. 设置环境人类意图注入 if environment in scene: for key, value in scene[environment].items(): if key weather: self.env.weather value self.env.broadcast_event(weather_change, f天气变为{value}) # 2. 触发全局事件人类意图注入 if global_events in scene: for event in scene[global_events]: self.env.broadcast_event(event[type], event[data]) # 3. 向特定Agent发出指令人类意图注入 if agent_directives in scene: for directive in scene[agent_directives]: agent_name directive[agent] command directive[command] if agent_name in self.agents: response self.agents[agent_name].direct_action(command) logger.info(f指令执行结果 [{agent_name}]: {response}) else: logger.warning(fAgent {agent_name} 不存在指令无法执行。) # 4. 检查是否需要人工干预 self._check_interventions() # 5. 让Agent们基于新环境自主互动一段时间AI自主性体现 self._let_agents_interact(scene.get(interaction_rounds, 3)) logger.info(f 场景 {scene_index} 结束 \n) def _check_interventions(self): 检查所有干预条件如果满足则打印提示等待“人类导演”决策。 for ip in self.human_intervention_points: if ip[condition](): logger.warning(f⚠️ [人工干预点] 需要人类介入{ip[action]}) # 在实际系统中这里可以暂停模拟等待用户输入。 # 例如通过一个Web界面或命令行输入。 # 此处我们仅打印日志。 def _let_agents_interact(self, rounds: int): 让Agent之间进行几轮随机或基于规则的互动。 from random import choice agent_names list(self.agents.keys()) for round_num in range(rounds): logger.info(f--- 自主互动轮次 {round_num 1} ---) if len(agent_names) 2: logger.info(Agent数量不足无法互动。) break # 随机选择两个Agent进行互动 a1, a2 choice(agent_names), choice(agent_names) while a1 a2: # 确保不是同一个Agent a2 choice(agent_names) # Agent A 向 Agent B 发起对话 initiator self.agents[a1] receiver self.agents[a2] # 生成一个随机的开场白这里可以更智能 greeting f{initiator.name}对{receiver.name}说‘你好啊今天天气真{self.env.weather}你在做什么呢’ # 接收者感知到事件并回应 response receiver.perceive(greeting) logger.info(f{receiver.name} 回应{response}) # 发起者再回应可选 # follow_up initiator.perceive(f{receiver.name}回应了你{response}) # logger.info(f{initiator.name} 接着说{follow_up})5.4 主程序将所有部分组合起来最后在main.py中我们创建小镇、居民并运行一个由人类剧本驱动的故事。# main.py import logging from core.agent import TownAgent from core.environment import TownEnvironment from core.orchestrator import TownOrchestrator from skills.writing_skill import WritingSkill # 配置日志 logging.basicConfig(levellogging.INFO, format%(asctime)s - %(name)s - %(levelname)s - %(message)s) def main(): 运行AI小镇演示。 # 1. 创建小镇环境 env TownEnvironment() # 2. 创建编排器人类导演 orchestrator TownOrchestrator(env) # 3. 创建居民AI Agent # 居民1: 作家Alice alice TownAgent( nameAlice, profile一位富有想象力的作家喜欢观察生活并将之写成故事性格温和。, model_namegpt-3.5-turbo # 可根据需要更换模型 ) # 给Alice添加写作技能 alice.add_tool(WritingSkill()) # 居民2: 园丁Bob bob TownAgent( nameBob, profile一位经验丰富的园丁热爱植物话不多但很务实。, model_namegpt-3.5-turbo ) # 可以给Bob添加园艺技能这里省略实现 # 4. 将居民注册到小镇 orchestrator.register_agent(alice) orchestrator.register_agent(bob) # 5. 定义一个人工干预点当Alice完成写作时需要人类审核 def check_alice_wrote(): # 简化条件检查全局事件日志中是否有Alice的写作完成事件 for event in env.global_events: if 写作完成 in str(event.get(data, )): return True return False orchestrator.add_intervention_point( conditioncheck_alice_wrote, actionAlice完成了一篇写作请审核内容是否符合要求。 ) # 6. 加载人类编写的剧本JSON格式 # 我们先在代码中直接定义一个简单剧本而不是从文件读取 human_script [ { name: 宁静的早晨, environment: {weather: 晴朗}, global_events: [ {type: global_announcement, data: 新的一天开始了小镇居民们早安} ], agent_directives: [ {agent: Alice, command: 请以‘小镇的清晨’为主题写一篇简短的散文。}, {agent: Bob, command: 请检查一下花园里的玫瑰是否需要浇水。} ], interaction_rounds: 2 }, { name: 午后的交流, environment: {weather: 多云}, global_events: [ {type: global_announcement, data: 午后微风习习适合散步和交流。} ], agent_directives: [], interaction_rounds: 3 } ] # 将剧本设置给编排器在实际项目中这里是从文件加载 orchestrator.script human_script # 7. 运行剧本 logger.info( 开始运行AI小镇剧本...) for i in range(len(orchestrator.script)): orchestrator.run_scene(i) logger.info(剧本运行结束。) # 8. 展示最终的小镇状态可选 logger.info(\n 小镇最终状态 ) logger.info(f天气{env.weather}) logger.info(f全局事件数量{len(env.global_events)}) for agent in [alice, bob]: logger.info(f{agent.name} 的记忆条数{len(agent.memory)}) if __name__ __main__: main()6. 运行与效果验证在项目根目录下运行主程序# 确保虚拟环境已激活 source venv/bin/activate # macOS/Linux # venv\Scripts\activate # Windows # 运行程序 python main.py预期输出与解读程序运行后你将在控制台看到类似以下的日志流具体内容因模型随机性而异2023-10-27 10:00:00 - root - INFO - 开始运行AI小镇剧本... 2023-10-27 10:00:00 - root - INFO - 开始场景 0: 宁静的早晨 2023-10-27 10:00:00 - core.environment - INFO - [环境事件] weather_change: 天气变为晴朗 2023-10-27 10:00:00 - core.environment - INFO - [环境事件] global_announcement: 新的一天开始了小镇居民们早安 2023-10-27 10:00:00 - core.orchestrator - INFO - 指令执行结果 [Alice]: [执行人类指令] 我正在使用我的写作技能以‘小镇的清晨’为主题创作一篇简短的散文。... 创作完成。 2023-10-27 10:00:00 - core.orchestrator - INFO - 指令执行结果 [Bob]: [执行人类指令] 我正在思考如何检查花园里的玫瑰。我需要先去花园查看土壤湿度和玫瑰的状态... 2023-10-27 10:00:01 - core.orchestrator - INFO - --- 自主互动轮次 1 --- 2023-10-27 10:00:01 - core.orchestrator - INFO - Bob 回应你好Alice今天的天气确实很晴朗。我正在检查花园里的玫瑰它们看起来有点干我正准备浇水。你在写什么吗 ... 2023-10-27 10:00:02 - root - WARNING - ⚠️ [人工干预点] 需要人类介入Alice完成了一篇写作请审核内容是否符合要求。 2023-10-27 10:00:02 - root - INFO - 场景 0 结束 ... 2023-10-27 10:00:05 - root - INFO - 剧本运行结束。 2023-10-27 10:00:05 - root - INFO - 小镇最终状态 2023-10-27 10:00:05 - root - INFO - 天气多云 2023-10-27 10:00:05 - root - INFO - 全局事件数量5 2023-10-27 10:00:05 - root - INFO - Alice 的记忆条数4 2023-10-27 10:00:05 - root - INFO - Bob 的记忆条数3如何判断成功剧本驱动程序能按human_script中定义的场景顺序执行。人类指令生效Alice 和 Bob 正确地接收并尝试执行了agent_directives中的命令如“请写散文”。AI自主互动在interaction_rounds阶段两个Agent能基于环境事件和彼此的记忆进行自然对话。人工干预点触发当模拟进行到特定条件如Alice写作完成时日志中出现了人工干预警告。这是“人类在环”的关键证明。状态持久环境状态天气和Agent状态记忆随着模拟推进而改变。如果运行失败第一步排查API密钥错误检查.env文件中的OPENAI_API_KEY是否正确设置或网络是否通畅。依赖缺失运行pip list | grep langchain确认关键包已安装。Python版本确认使用的是Python 3.8。查看详细错误将logging.basicConfig的 level 改为DEBUG以获取更详细的错误信息。7. 常见问题与排查思路在实践上述AI共生项目时你可能会遇到以下典型问题问题现象可能原因排查方式解决方案运行时报ModuleNotFoundError虚拟环境未激活或依赖未正确安装。1. 确认命令行前有(venv)标识。2. 运行pip install -r requirements.txt如果已创建。激活虚拟环境并重新安装依赖。Agent 无响应或回应“我是AI...”系统提示词System Prompt未生效或太弱。检查_get_system_prompt方法返回的字符串确保角色描述清晰、指令明确。强化系统提示词明确指令如“你必须始终以{角色名}的身份回应”。工具Skill未被调用工具描述不清晰或Agent无法理解何时使用。1. 检查工具的description是否足够具体。2. 将Agent执行器的verbose设为True观察其思考链。优化工具描述使其更场景化。例如将“用于写作”改为“当你需要创作故事、信件或文章时使用”。人工干预点未触发干预条件函数condition的逻辑错误或触发事件未正确记录。1. 在condition函数内添加打印语句调试其返回值。2. 检查env.global_events中是否记录了预期事件。确保干预条件与事件广播的event_type和data内容严格匹配。对话内容重复或无意义模型温度temperature过高或过低或记忆上下文太短。1. 调整ChatOpenAI的temperature参数0.7较平衡。2. 增加_format_memory()中保留的记忆条数。优化提示词工程在系统提示中强调“避免重复”和“基于记忆进行对话”。运行速度慢频繁调用云端LLM API网络延迟高。观察日志看时间主要消耗在哪个环节。1. 考虑使用本地模型如通过Ollama。2. 对Agent的响应进行缓存。3. 减少不必要的互动轮次。多个Agent行为趋同使用了相同的模型和系统提示模板缺乏差异化。对比不同Agent的profile和temperature设置。为不同Agent赋予截然不同的profile甚至使用不同模型如一个用GPT-4一个用Claude并差异化temperature。8. 最佳实践与工程建议将“AI共生”理念从Demo推向实际项目需要遵循以下工程最佳实践明确职责边界最关键人类负责目标制定、价值对齐、伦理审查、关键决策、创造性种子。AI负责方案生成、信息检索、代码编写、数据整理、重复性响应。在代码设计中像Orchestrator和direct_action这样的接口就是边界的体现务必保持清晰。设计可审查的中间状态AI的思考过程Chain-of-Thought应该日志化。在TownAgent中我们将AgentExecutor的verbose设为True就是为了这一点。所有由AI生成的关键产出如写作内容、决策理由都应留有版本方便人类追溯和回滚。实现优雅的降级与接管当AI不确定或遇到边界情况时应主动触发“人工干预点”而不是硬着头皮给出可能错误的答案。在TownAgent.perceive方法中应有完善的异常处理确保单个Agent的故障不会导致整个系统崩溃。关注安全性权限控制不是所有人类指令都应被无条件执行。应考虑为指令分级某些高危操作需要额外授权。输入输出过滤对来自AI生成的内容和外部输入进行必要的安全检查防止提示词注入或生成有害内容。数据隐私如果涉及真实用户数据确保AI模型调用符合数据安全规范。优化性能与成本上下文管理合理设计Agent的记忆长度避免无限增长导致token消耗剧增和性能下降。我们的_format_memory()只保留最近5条。缓存策略对频繁且结果确定的查询如知识库问答进行缓存。模型选型根据任务复杂度选择合适的模型。简单的分类任务可能不需要GPT-4而创意写作则可能需要更强的模型。构建可观测性记录所有重要的系统事件、AI决策、人类干预到结构化日志或数据库中。这不仅能用于调试更是后期分析和优化共生模式的数据基础。9. 总结从代码回归本质通过构建这个简易的“My AI Town”我们实践了“AI共生”的核心思想。技术上的关键收获在于架构上我们通过Orchestrator和direct_action实现了人类意图的注入点通过intervention_points实现了人工审核的钩子。设计上我们将AI的自主性perceive和自主互动与人类的控制权剧本和直接指令进行了分层和解耦。理念上我们验证了最有效的模式不是让AI完全自治而是构建一个人类定义目标、AI负责执行、双方在关键节点协作的增强系统。这不仅仅是构建一个多智能体模拟更是一种对未来人机协作范式的编程实践。它提醒我们在AI能力飞速发展的今天开发者最重要的任务或许不是追求完全自动化而是如何更好地设计界面、协议和流程让人类的“笨拙”直觉、伦理、创造力与AI的“高效”计算、检索、模式匹配结合产生112的共生价值。你的下一步可以是从这个Demo出发尝试为Bob实现一个真实的“园艺技能”调用天气API或植物数据库或者设计更复杂的剧本和干预逻辑。真正的“AI小镇”不在于它有多智能而在于它能在多大程度上成为一个映照并增强我们人类自身价值的镜子。