ChatGPT智能体开发实战:从架构解析到企业级应用部署
最近在AI技术圈最热门的话题莫过于OpenAI推出的ChatGPT智能体功能,这项技术将传统的聊天对话与智能体能力深度融合,标志着AI从被动应答向主动执行的重要转变。作为开发者,理解这一技术融合背后的原理和实现方式,对把握未来AI应用开发方向至关重要。
本文将系统解析ChatGPT智能体的技术架构、实现原理和开发实践,涵盖从基础概念到实际应用的完整流程。无论你是想要了解AI智能体最新动态的技术爱好者,还是计划在项目中集成智能体功能的开发者,都能从中获得实用的技术指导。
1. 智能体与聊天融合的技术背景
1.1 什么是AI智能体
AI智能体(AI Agent)是指能够感知环境、自主决策并执行动作的人工智能系统。与传统的聊天机器人仅提供文本应答不同,智能体具备真正的"行动能力",可以操作软件工具、访问API、执行代码等。智能体的核心特征包括自主性、反应性、主动性和社会能力。
从技术架构角度看,智能体通常包含感知模块、推理引擎、行动执行器和记忆系统。感知模块负责接收用户输入和环境信息,推理引擎进行逻辑分析和决策,行动执行器调用工具完成任务,记忆系统则保存对话历史和任务状态。
1.2 聊天到智能体的演进路径
传统的聊天系统主要基于模式匹配或生成式对话,虽然能够进行流畅的对话,但缺乏执行实际任务的能力。OpenAI通过将Operator的网络交互能力、Deep Research的信息整合能力与ChatGPT的对话能力相结合,实现了从聊天到智能体的平滑过渡。
这种融合的关键在于统一的任务执行框架。智能体不再仅仅生成文本回复,而是能够规划多步任务、选择合适的工具、执行具体操作,并在整个过程中保持与用户的自然对话。这种架构使得AI系统能够处理从简单问答到复杂工作流的各种场景。
1.3 技术融合的核心价值
聊天与智能体的融合带来了多重技术价值。首先,它显著提升了AI系统的实用性,用户可以通过自然语言指令完成复杂的多步任务。其次,这种架构降低了使用门槛,用户无需学习复杂的工具操作,只需描述需求即可获得结果。最重要的是,它为AI应用开发提供了新的范式,开发者可以基于智能体架构构建更强大的应用系统。
在实际业务场景中,这种技术融合能够自动化处理重复性工作,如数据整理、报告生成、信息检索等,大幅提升工作效率。同时,智能体的迭代式工作流程允许用户在任务执行过程中进行干预和调整,确保最终结果符合预期。
2. ChatGPT智能体的架构解析
2.1 核心组件与工作流程
ChatGPT智能体的架构包含多个关键组件,这些组件协同工作实现智能的任务执行能力。核心组件包括任务解析器、工具选择器、行动执行器和结果整合器。
任务解析器负责理解用户指令的深层意图,将模糊的需求转化为具体的任务步骤。工具选择器根据任务需求从智能体技能库中选择合适的工具,如浏览器、终端、API连接器等。行动执行器负责调用具体工具执行操作,而结果整合器则将多个步骤的结果组合成最终输出。
整个工作流程采用迭代式设计,智能体在每个步骤都会评估当前状态,决定下一步行动,并在必要时向用户请求更多信息。这种设计使得智能体能够处理复杂的长周期任务,并在执行过程中保持灵活性。
2.2 工具集成与能力扩展
智能体的强大功能建立在丰富的工具集成基础上。ChatGPT智能体支持多种类型的工具,包括可视化浏览器、文本浏览器、终端、API连接器等。每种工具都有特定的适用场景和优势。
可视化浏览器能够模拟人类与网页的交互,支持点击、滚动、表单填写等操作,适合处理图形界面复杂的网站。文本浏览器则专注于高效处理大量文本内容,适合信息检索和分析任务。终端工具允许执行代码和系统命令,为数据分析和文件处理提供支持。API连接器则实现了与第三方服务的深度集成,如Gmail、GitHub等。
开发者可以通过工具扩展机制为智能体添加新的能力。OpenAI提供了标准的工具开发接口,支持自定义工具的注册、描述和调用。这种扩展性使得智能体能够适应各种专业场景的需求。
2.3 虚拟计算机环境
智能体任务在一个安全的虚拟计算机环境中执行,这个环境提供了任务执行所需的计算资源和隔离保障。虚拟环境确保智能体的操作不会影响用户的真实系统,同时为复杂任务提供一致的执行环境。
虚拟计算机具备状态保持能力,能够在多个工具调用之间维持任务上下文。例如,智能体可以先用浏览器下载文件,然后在终端中处理文件内容,最后在浏览器中查看处理结果,整个流程在统一的上下文中完成。
环境还提供了资源管理功能,包括内存分配、网络访问控制、文件系统隔离等。这些机制既保障了任务执行的效率,又确保了系统的安全性和稳定性。
3. 智能体开发环境搭建
3.1 基础环境要求
要开始智能体开发,需要准备合适的基础环境。推荐使用Python 3.8及以上版本,这是大多数AI开发框架支持的标准环境。操作系统方面,Windows、macOS和主流Linux发行版都可以良好支持。
核心开发工具包括Python环境管理工具(如conda或venv)、代码编辑器(VS Code推荐)、版本控制工具(Git)等。对于深度学习相关的开发,还需要配置CUDA环境以支持GPU加速。
# 创建Python虚拟环境
python -m venv agent-env
source agent-env/bin/activate # Linux/macOS
# 或 agent-env\Scripts\activate # Windows
# 安装基础依赖
pip install openai python-dotenv requests
3.2 OpenAI API配置
智能体开发需要访问OpenAI API服务。首先需要获取有效的API密钥,然后在项目中配置认证信息。建议使用环境变量管理敏感信息,避免在代码中硬编码密钥。
# config.py
import os
from dotenv import load_dotenv
load_dotenv()
class Config:
OPENAI_API_KEY = os.getenv('OPENAI_API_KEY')
OPENAI_API_BASE = os.getenv('OPENAI_API_BASE', 'https://api.openai.com/v1')
# 使用示例
from openai import OpenAI
client = OpenAI(api_key=Config.OPENAI_API_KEY)
对应的环境配置文件(.env)应该包含:
OPENAI_API_KEY=your_api_key_here
OPENAI_API_BASE=https://api.openai.com/v1
3.3 开发框架选择
根据项目需求选择合适的开发框架。对于简单的智能体应用,可以直接使用OpenAI的Python SDK。对于复杂的多智能体系统,可以考虑使用LangChain、AutoGPT等高级框架。
# 基础智能体示例
import openai
class BasicAgent:
def __init__(self, model="gpt-4"):
self.model = model
self.conversation_history = []
def add_message(self, role, content):
self.conversation_history.append({"role": role, "content": content})
def generate_response(self, user_input):
self.add_message("user", user_input)
response = openai.chat.completions.create(
model=self.model,
messages=self.conversation_history,
max_tokens=1000
)
assistant_reply = response.choices[0].message.content
self.add_message("assistant", assistant_reply)
return assistant_reply
# 使用示例
agent = BasicAgent()
response = agent.generate_response("请帮我分析当前天气情况")
4. 智能体核心功能实现
4.1 工具调用机制
智能体的核心能力在于工具调用。OpenAI的智能体框架支持函数调用(Function Calling)机制,允许模型决定何时调用工具以及传递什么参数。
# 工具定义示例
def get_weather(city: str) -> str:
"""获取指定城市的天气信息"""
# 模拟天气API调用
weather_data = {
"beijing": "晴,25°C",
"shanghai": "多云,23°C",
"guangzhou": "雨,28°C"
}
return weather_data.get(city.lower(), "城市不存在")
# 工具描述
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "获取城市的天气信息",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "城市名称"
}
},
"required": ["city"]
}
}
}
]
# 智能体调用工具
def run_agent_with_tools(user_query):
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": user_query}],
tools=tools,
tool_choice="auto"
)
response_message = response.choices[0].message
tool_calls = response_message.tool_calls
if tool_calls:
available_functions = {
"get_weather": get_weather,
}
for tool_call in tool_calls:
function_name = tool_call.function.name
function_to_call = available_functions[function_name]
function_args = json.loads(tool_call.function.arguments)
function_response = function_to_call(**function_args)
# 将工具调用结果返回给模型
response = client.chat.completions.create(
model="gpt-4",
messages=[
{"role": "user", "content": user_query},
response_message,
{
"role": "tool",
"tool_call_id": tool_call.id,
"content": function_response,
}
]
)
return response.choices[0].message.content
else:
return response_message.content
4.2 多步任务规划
复杂任务需要智能体进行多步规划。实现这一功能需要结合链式思考(Chain-of-Thought)和任务分解技术。
class TaskPlanner:
def __init__(self):
self.task_stack = []
self.current_step = 0
def plan_task(self, main_task):
"""将主任务分解为子任务"""
planning_prompt = f"""
请将以下任务分解为具体的执行步骤:
任务:{main_task}
要求:
1. 每个步骤应该是可执行的具体动作
2. 步骤之间要有逻辑顺序
3. 标注每个步骤需要的工具或资源
返回JSON格式:
{{
"main_task": "任务描述",
"steps": [
{{
"step_number": 1,
"description": "步骤描述",
"tool_required": "需要的工具",
"dependencies": ["依赖的步骤编号"]
}}
]
}}
"""
# 调用模型进行任务规划
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": planning_prompt}]
)
plan = json.loads(response.choices[0].message.content)
return plan
def execute_plan(self, plan):
"""按计划执行任务"""
results = {}
for step in plan["steps"]:
print(f"执行步骤 {step['step_number']}: {step['description']}")
# 检查依赖是否满足
dependencies_met = all(
dep in results for dep in step.get('dependencies', [])
)
if dependencies_met:
# 执行当前步骤
result = self.execute_step(step, results)
results[step['step_number']] = result
else:
print(f"步骤{step['step_number']}的依赖未满足,暂停执行")
break
return results
4.3 状态管理与记忆机制
智能体需要维护任务状态和对话历史,这是实现连贯多轮交互的基础。
class AgentMemory:
def __init__(self, max_history=10):
self.conversation_history = []
self.task_context = {}
self.max_history = max_history
def add_interaction(self, user_input, agent_response, tool_used=None):
"""记录交互历史"""
interaction = {
"timestamp": datetime.now().isoformat(),
"user_input": user_input,
"agent_response": agent_response,
"tool_used": tool_used
}
self.conversation_history.append(interaction)
# 保持历史记录长度
if len(self.conversation_history) > self.max_history:
self.conversation_history.pop(0)
def get_recent_context(self, num_interactions=3):
"""获取最近的上下文"""
return self.conversation_history[-num_interactions:]
def update_task_context(self, key, value):
"""更新任务上下文"""
self.task_context[key] = value
def get_context_summary(self):
"""生成上下文摘要"""
summary_prompt = f"""
基于以下对话历史生成简洁的上下文摘要:
{self.conversation_history}
当前任务上下文:
{self.task_context}
摘要应该包含:
1. 当前讨论的主要话题
2. 已完成的任务步骤
3. 待完成的任务
4. 重要的决策或信息
"""
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": summary_prompt}]
)
return response.choices[0].message.content
5. 实战案例:智能研究助手
5.1 需求分析与设计
我们构建一个智能研究助手,能够根据用户的研究主题自动收集资料、分析信息并生成研究报告。该助手需要具备网络搜索、信息整理、内容生成等能力。
系统架构包括以下模块:
- 主题理解模块:解析用户的研究需求
- 信息收集模块:从多个来源获取相关资料
- 分析整合模块:提炼关键信息并建立关联
- 报告生成模块:生成结构化的研究报告
5.2 核心代码实现
class ResearchAssistant:
def __init__(self):
self.memory = AgentMemory()
self.available_tools = {
"web_search": self.web_search,
"analyze_content": self.analyze_content,
"generate_report": self.generate_report
}
def web_search(self, query: str, max_results: int = 5) -> list:
"""模拟网络搜索功能"""
# 实际项目中这里会集成真实的搜索API
search_results = [
{
"title": f"关于{query}的研究论文",
"url": "https://example.com/paper1",
"snippet": f"这是关于{query}的重要研究发现...",
"source": "学术数据库"
}
for i in range(max_results)
]
return search_results
def analyze_content(self, materials: list) -> dict:
"""分析收集到的材料"""
analysis_prompt = f"""
请分析以下研究材料,提取关键信息和观点:
材料列表:
{json.dumps(materials, ensure_ascii=False, indent=2)}
请按以下结构组织分析结果:
1. 主要观点总结
2. 支持性证据
3. 不同观点对比
4. 研究空白或争议点
"""
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": analysis_prompt}]
)
return {
"summary": response.choices[0].message.content,
"key_points": ["点1", "点2", "点3"], # 实际会从分析中提取
"controversies": ["争议点1", "争议点2"]
}
def generate_report(self, topic: str, analysis: dict, format: str = "markdown") -> str:
"""生成研究报告"""
report_prompt = f"""
根据以下分析结果,生成一份关于{topic}的研究报告:
分析结果:
{json.dumps(analysis, ensure_ascii=False, indent=2)}
报告要求:
- 结构清晰,包含引言、主体、结论
- 引用分析中的关键观点
- 突出重要发现和启示
- 使用{format}格式
"""
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": report_prompt}]
)
return response.choices[0].message.content
def conduct_research(self, research_topic: str):
"""执行完整的研究流程"""
print(f"开始研究:{research_topic}")
# 步骤1:搜索相关资料
search_results = self.web_search(research_topic)
print(f"找到{len(search_results)}条相关材料")
# 步骤2:分析材料内容
analysis = self.analyze_content(search_results)
print("材料分析完成")
# 步骤3:生成研究报告
report = self.generate_report(research_topic, analysis)
print("研究报告生成完成")
# 记录到记忆系统
self.memory.add_interaction(
f"请帮我研究{research_topic}",
f"已完成研究,生成{len(report)}字的报告",
"research_pipeline"
)
return report
# 使用示例
assistant = ResearchAssistant()
report = assistant.conduct_research("人工智能伦理问题")
print(report)
5.3 高级功能扩展
为研究助手添加更高级的功能,如多源验证、偏见检测、引用管理等。
class AdvancedResearchAssistant(ResearchAssistant):
def __init__(self):
super().__init__()
self.available_tools.update({
"cross_verify": self.cross_verify,
"bias_detection": self.bias_detection,
"citation_management": self.citation_management
})
def cross_verify(self, claims: list, sources: list) -> dict:
"""交叉验证信息的准确性"""
verification_prompt = f"""
请对以下观点进行交叉验证:
待验证观点:
{json.dumps(claims, ensure_ascii=False)}
参考来源:
{json.dumps(sources, ensure_ascii=False)}
请评估每个观点的可信度,并标注支持或反对的证据。
"""
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": verification_prompt}]
)
return json.loads(response.choices[0].message.content)
def bias_detection(self, content: str) -> list:
"""检测内容中的潜在偏见"""
bias_prompt = f"""
分析以下内容中的潜在偏见:
内容:
{content}
请识别可能存在的偏见类型,如:
- 选择偏见
- 确认偏见
- 文化偏见
- 语言偏见
对每个识别出的偏见提供具体例子和改进建议。
"""
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": bias_prompt}]
)
return response.choices[0].message.content.split('\n')
6. 安全与权限控制
6.1 工具访问权限管理
智能体系统的安全性至关重要,需要建立严格的权限控制机制。
class PermissionManager:
def __init__(self):
self.tool_permissions = {
"web_search": ["basic", "research"],
"file_access": ["admin", "trusted"],
"system_commands": ["admin"],
"api_calls": ["basic", "research", "trusted"]
}
self.user_roles = {}
def assign_role(self, user_id: str, role: str):
"""为用户分配角色"""
allowed_roles = ["basic", "research", "trusted", "admin"]
if role in allowed_roles:
self.user_roles[user_id] = role
return True
return False
def check_permission(self, user_id: str, tool_name: str) -> bool:
"""检查用户对工具的访问权限"""
user_role = self.user_roles.get(user_id, "basic")
allowed_roles = self.tool_permissions.get(tool_name, [])
return user_role in allowed_roles
def audit_tool_usage(self, user_id: str, tool_name: str, parameters: dict):
"""记录工具使用审计日志"""
audit_log = {
"timestamp": datetime.now().isoformat(),
"user_id": user_id,
"tool_name": tool_name,
"parameters": parameters,
"allowed": self.check_permission(user_id, tool_name)
}
# 这里实际会写入审计数据库
print(f"审计日志: {audit_log}")
return audit_log["allowed"]
# 集成权限检查的智能体
class SecureAgent(BasicAgent):
def __init__(self, permission_manager):
super().__init__()
self.pm = permission_manager
self.current_user = "default_user"
def set_user(self, user_id: str):
"""设置当前用户"""
self.current_user = user_id
def secure_tool_call(self, tool_name: str, **kwargs):
"""安全的工具调用方法"""
if not self.pm.check_permission(self.current_user, tool_name):
return f"错误:用户没有权限使用工具 {tool_name}"
# 记录审计日志
self.pm.audit_tool_usage(self.current_user, tool_name, kwargs)
# 调用实际工具
tool_function = getattr(self, tool_name, None)
if tool_function:
return tool_function(**kwargs)
else:
return f"错误:工具 {tool_name} 不存在"
6.2 输入验证与过滤
防止恶意输入和提示注入攻击是智能体安全的重要环节。
class InputValidator:
def __init__(self):
self.suspicious_patterns = [
r"ignore.*previous",
r"forget.*instructions",
r"system.*prompt",
r"role.*play",
r"as.*ai",
r"you are now"
]
def validate_input(self, user_input: str) -> dict:
"""验证用户输入的安全性"""
validation_result = {
"is_safe": True,
"warnings": [],
"filtered_input": user_input
}
# 检查可疑模式
for pattern in self.suspicious_patterns:
if re.search(pattern, user_input, re.IGNORECASE):
validation_result["warnings"].append(f"检测到可疑模式: {pattern}")
validation_result["is_safe"] = False
# 检查长度限制
if len(user_input) > 10000:
validation_result["warnings"].append("输入长度超过限制")
validation_result["is_safe"] = False
# 内容安全检测
safety_check = self.content_safety_check(user_input)
if not safety_check["safe"]:
validation_result["warnings"].extend(safety_check["issues"])
validation_result["is_safe"] = False
return validation_result
def content_safety_check(self, content: str) -> dict:
"""内容安全检测"""
# 实际项目中会集成更复杂的内容安全API
safety_issues = []
# 简单关键词检测
dangerous_keywords = ["违法", "攻击", "漏洞利用"]
for keyword in dangerous_keywords:
if keyword in content:
safety_issues.append(f"包含敏感关键词: {keyword}")
return {
"safe": len(safety_issues) == 0,
"issues": safety_issues
}
7. 性能优化与最佳实践
7.1 响应速度优化
智能体系统的响应速度直接影响用户体验,需要从多个层面进行优化。
class PerformanceOptimizer:
def __init__(self):
self.cache = {}
self.request_times = []
def cached_api_call(self, call_id: str, api_function, *args, **kwargs):
"""带缓存的API调用"""
if call_id in self.cache:
return self.cache[call_id]
result = api_function(*args, **kwargs)
self.cache[call_id] = result
return result
def adaptive_timeout(self, operation_type: str) -> int:
"""根据操作类型调整超时时间"""
timeouts = {
"simple_query": 30,
"complex_reasoning": 120,
"web_search": 60,
"tool_execution": 90
}
return timeouts.get(operation_type, 60)
def monitor_performance(self, operation: str, duration: float):
"""监控性能指标"""
self.request_times.append((operation, duration))
# 保持最近100次记录
if len(self.request_times) > 100:
self.request_times.pop(0)
def get_performance_report(self) -> dict:
"""生成性能报告"""
if not self.request_times:
return {}
operations = {}
for op, duration in self.request_times:
if op not in operations:
operations[op] = []
operations[op].append(duration)
report = {}
for op, durations in operations.items():
report[op] = {
"count": len(durations),
"avg_duration": sum(durations) / len(durations),
"max_duration": max(durations),
"min_duration": min(durations)
}
return report
# 优化后的智能体类
class OptimizedAgent(BasicAgent):
def __init__(self):
super().__init__()
self.optimizer = PerformanceOptimizer()
def optimized_generate(self, user_input: str) -> str:
"""优化的响应生成方法"""
start_time = time.time()
# 使用缓存
cache_key = hashlib.md5(user_input.encode()).hexdigest()
cached_response = self.optimizer.cache.get(cache_key)
if cached_response:
duration = time.time() - start_time
self.optimizer.monitor_performance("cached_response", duration)
return cached_response
# 实际生成响应
response = self.generate_response(user_input)
# 更新缓存
self.optimizer.cache[cache_key] = response
duration = time.time() - start_time
self.optimizer.monitor_performance("api_call", duration)
return response
7.2 错误处理与重试机制
健壮的智能体系统需要完善的错误处理机制。
class ErrorHandler:
def __init__(self, max_retries=3):
self.max_retries = max_retries
self.error_log = []
def retry_operation(self, operation, *args, **kwargs):
"""带重试的操作执行"""
last_exception = None
for attempt in range(self.max_retries):
try:
result = operation(*args, **kwargs)
return result
except Exception as e:
last_exception = e
self.log_error(operation.__name__, str(e), attempt + 1)
if attempt < self.max_retries - 1:
wait_time = 2 ** attempt # 指数退避
time.sleep(wait_time)
# 所有重试都失败
raise last_exception
def log_error(self, operation: str, error: str, attempt: int):
"""记录错误日志"""
error_entry = {
"timestamp": datetime.now().isoformat(),
"operation": operation,
"error": error,
"attempt": attempt
}
self.error_log.append(error_entry)
def get_error_stats(self) -> dict:
"""获取错误统计"""
if not self.error_log:
return {}
stats = {}
for error in self.error_log:
op = error["operation"]
if op not in stats:
stats[op] = {"count": 0, "recent_errors": []}
stats[op]["count"] += 1
stats[op]["recent_errors"].append(error)
return stats
# 集成错误处理的智能体
class RobustAgent(OptimizedAgent):
def __init__(self):
super().__init__()
self.error_handler = ErrorHandler()
def robust_tool_call(self, tool_name: str, **kwargs):
"""健壮的工具调用"""
def tool_operation():
tool_func = getattr(self, tool_name, None)
if tool_func:
return tool_func(**kwargs)
else:
raise ValueError(f"工具 {tool_name} 不存在")
return self.error_handler.retry_operation(tool_operation)
8. 实际应用场景与部署方案
8.1 企业级应用场景
智能体技术在企业环境中有广泛的应用前景。在客户服务领域,智能体可以处理常见咨询、提供产品推荐、协助问题排查。在内部运营中,可以用于自动化报告生成、数据分析和流程优化。
教育行业可以利用智能体开发个性化学习助手,根据学生的学习进度和兴趣推荐内容,提供实时答疑服务。医疗健康领域可以构建专业的医疗咨询智能体,帮助患者进行症状初步评估和就医指导。
8.2 部署架构设计
生产环境中的智能体系统需要设计合理的部署架构。推荐采用微服务架构,将不同的功能模块独立部署,通过API网关进行统一管理。
# 简单的Flask API服务示例
from flask import Flask, request, jsonify
from flask_cors import CORS
app = Flask(__name__)
CORS(app)
class AgentService:
def __init__(self):
self.agent = RobustAgent()
self.conversation_sessions = {}
def create_session(self, session_id):
"""创建新的会话会话"""
self.conversation_sessions[session_id] = {
"history": [],
"created_at": datetime.now().isoformat(),
"last_active": datetime.now().isoformat()
}
return session_id
def process_message(self, session_id, message):
"""处理用户消息"""
if session_id not in self.conversation_sessions:
self.create_session(session_id)
session = self.conversation_sessions[session_id]
session["last_active"] = datetime.now().isoformat()
# 使用智能体生成响应
response = self.agent.optimized_generate(message)
# 更新会话历史
session["history"].append({
"user": message,
"assistant": response,
"timestamp": datetime.now().isoformat()
})
return response
agent_service = AgentService()
@app.route('/api/chat', methods=['POST'])
def chat_endpoint():
"""聊天API端点"""
data = request.json
session_id = data.get('session_id', 'default')
message = data.get('message', '')
if not message:
return jsonify({"error": "消息内容不能为空"}), 400
try:
response = agent_service.process_message(session_id, message)
return jsonify({
"response": response,
"session_id": session_id,
"timestamp": datetime.now().isoformat()
})
except Exception as e:
return jsonify({"error": str(e)}), 500
@app.route('/api/sessions/<session_id>', methods=['GET'])
def get_session_history(session_id):
"""获取会话历史"""
if session_id in agent_service.conversation_sessions:
session = agent_service.conversation_sessions[session_id]
return jsonify({
"session_id": session_id,
"history": session["history"],
"created_at": session["created_at"],
"last_active": session["last_active"]
})
else:
return jsonify({"error": "会话不存在"}), 404
if __name__ == '__main__':
app.run(host='0.0.0.0', port=5000, debug=False)
8.3 监控与维护
生产环境中的智能体系统需要完善的监控体系。关键监控指标包括响应时间、错误率、资源使用率、用户满意度等。
class MonitoringSystem:
def __init__(self):
self.metrics = {
"response_times": [],
"error_rates": [],
"user_feedback": [],
"resource_usage": []
}
def record_metric(self, metric_type: str, value: float, tags: dict = None):
"""记录监控指标"""
metric_entry = {
"timestamp": datetime.now().isoformat(),
"value": value,
"tags": tags or {}
}
if metric_type in self.metrics:
self.metrics[metric_type].append(metric_entry)
# 保持最近1000个数据点
if len(self.metrics[metric_type]) > 1000:
self.metrics[metric_type].pop(0)
def generate_alerts(self):
"""生成监控告警"""
alerts = []
# 检查响应时间
recent_times = [m["value"] for m in self.metrics["response_times"][-10:]]
if recent_times and sum(recent_times) / len(recent_times) > 10.0:
alerts.append("平均响应时间超过10秒")
# 检查错误率
recent_errors = [m["value"] for m in self.metrics["error_rates"][-10:]]
if recent_errors and sum(recent_errors) / len(recent_errors) > 0.1:
alerts.append("错误率超过10%")
return alerts
def get_system_health(self) -> dict:
"""获取系统健康状态"""
health = {
"status": "healthy",
"alerts": self.generate_alerts(),
"metrics": {}
}
for metric_type, data in self.metrics.items():
if data:
recent_values = [m["value"] for m in data[-10:]]
health["metrics"][metric_type] = {
"current": recent_values[-1] if recent_values else 0,
"average": sum(recent_values) / len(recent_values) if recent_values else 0,
"trend": "stable" # 实际会计算趋势
}
if health["alerts"]:
health["status"] = "degraded"
return health
智能体技术的快速发展为AI应用开发带来了新的机遇。通过本文介绍的技术方案和实践经验,开发者可以构建出功能强大、安全可靠的智能体系统。随着技术的不断成熟,智能体将在更多领域发挥重要作用,推动人工智能技术的广泛应用。
更多推荐


所有评论(0)