Files
company-ai-platform/app/modules/ai_agent/service.py
JiuContinent 0cda45238a ```
feat: 添加AI记忆模块和事件调度系统

- 新增AI记忆模块,支持本地记忆召回和自动写入功能
- 实现事件调度系统,支持批量处理待定事件和重试机制
- 集成心跳监控机制,跟踪API、调度器和工作节点状态
- 扩展仪表板数据统计,包含AI记忆条目和心跳概要
- 添加企业运营分析报告功能,提供财务、采购等多维度分析
- 更新配置设置,增加事件调度和AI记忆相关参数
- 优化任务队列,添加事件分发任务类型
- 扩展审计日志,记录AI记忆操作和事件调度行为
- 实现领域事件模型,支持事件持久化和状态管理
- 添加观察性服务,监控系统组件健康状况
```
2026-07-09 17:26:19 +08:00

242 lines
8.0 KiB
Python

from typing import Any
from sqlalchemy.orm import Session
from app.core.constants import ActorValue
from app.core.config import get_settings
from app.modules.ai_agent.adapters import HermesAdapter, OpenClawAdapter, get_adapter
from app.modules.ai_agent.constants import (
AIDefault,
AI_AUDIT_MAX_DEPTH,
AI_AUDIT_MAX_SEQUENCE_ITEMS,
AI_AUDIT_MAX_TEXT_LENGTH,
AI_AUDIT_REDACTED_VALUE,
AI_AUDIT_SENSITIVE_KEYS,
AI_AUDIT_TRUNCATED_VALUE,
AIToolAuditKey,
AIContextKey,
AIProviderName,
AIRequestKey,
AIResponseKey,
)
from app.modules.ai_memory.constants import AIMemoryPayloadKey, AIMemoryScope
from app.modules.ai_memory.service import AIMemoryService
from app.modules.ai_agent.skills import AISkillId, get_ai_skill
from app.modules.audit.constants import (
AuditAction,
AuditRiskLevel,
AuditSource,
AuditTargetType,
)
from app.modules.audit.schemas import AuditLogCreate
from app.modules.audit.service import AuditService
class AIService:
"""Coordinate AI provider calls and audit logging."""
def __init__(self, db: Session):
self.db = db
self.audit = AuditService(db)
def ask(
self,
prompt: str,
context: dict[str, Any] | None = None,
actor: str = ActorValue.API,
source: str = AuditSource.API,
) -> dict[str, Any]:
adapter = get_adapter()
original_context = context or {}
adapter_context = dict(original_context)
memory_service = AIMemoryService(self.db)
local_memory = memory_service.recall(
query=prompt,
scope=_memory_scope(original_context),
subject=_memory_subject(original_context),
actor=actor,
)
if local_memory:
adapter_context[AIContextKey.LOCAL_MEMORY] = local_memory
result = adapter.ask(prompt, adapter_context)
answer = result[AIResponseKey.ANSWER]
raw = dict(result.get(AIResponseKey.RAW, {}))
if local_memory:
raw[AIResponseKey.LOCAL_MEMORY] = local_memory
memory_record = memory_service.auto_write(
prompt=prompt,
context=original_context,
answer=answer,
actor=actor,
)
if memory_record is not None:
raw[AIResponseKey.MEMORY_WRITE] = {
AIMemoryPayloadKey.CODE: memory_record.code,
AIMemoryPayloadKey.STATUS: memory_record.status,
}
response = {
AIResponseKey.PROVIDER: adapter.provider_name,
AIResponseKey.ANSWER: answer,
AIResponseKey.RAW: raw,
}
self.audit.log(
AuditLogCreate(
actor=actor,
source=source,
action=AuditAction.AI_ASK,
target_type=AuditTargetType.AI,
risk_level=AuditRiskLevel.MEDIUM,
request_payload=_audit_safe_payload({
AIRequestKey.PROMPT: prompt,
AIRequestKey.CONTEXT: context or {},
}),
response_payload=_audit_safe_payload(response),
)
)
return response
def run_skill(
self,
skill_id: AISkillId | str,
context: dict[str, Any] | None = None,
variables: dict[str, Any] | None = None,
actor: str = ActorValue.API,
) -> dict[str, Any]:
skill = get_ai_skill(skill_id)
return self.ask(
skill.render(variables),
context=context or {},
actor=actor,
source=skill.source,
)
def provider_health(self, actor: str = ActorValue.API) -> dict[str, Any]:
settings = get_settings()
openclaw = self._health_result(OpenClawAdapter(settings).health)
hermes = self._health_result(HermesAdapter(settings).health)
response = {
"model_provider": settings.model_provider,
AIProviderName.OPENCLAW: openclaw,
AIProviderName.HERMES: hermes,
}
self.audit.log(
AuditLogCreate(
actor=actor,
source=AuditSource.API,
action=AuditAction.AI_PROVIDER_HEALTH,
target_type=AuditTargetType.AI,
risk_level=AuditRiskLevel.LOW,
response_payload=_audit_safe_payload(response),
)
)
return response
def invoke_openclaw_tool(
self,
tool: str,
action: str = AIDefault.ACTION_JSON,
args: dict[str, Any] | None = None,
session_key: str = AIDefault.SESSION_KEY_MAIN,
actor: str = ActorValue.API,
) -> dict[str, Any]:
result = OpenClawAdapter(get_settings()).invoke_tool(tool, action, args or {}, session_key)
response = {AIResponseKey.PROVIDER: AIProviderName.OPENCLAW, AIResponseKey.RESULT: result}
self.audit.log(
AuditLogCreate(
actor=actor,
source=AuditSource.OPENCLAW,
action=AuditAction.OPENCLAW_TOOLS_INVOKE,
target_type=AuditTargetType.OPENCLAW_TOOL,
target_id=tool,
risk_level=AuditRiskLevel.HIGH,
request_payload=_audit_safe_payload({
AIToolAuditKey.TOOL: tool,
AIToolAuditKey.ACTION: action,
AIToolAuditKey.ARGS: args or {},
AIToolAuditKey.SESSION_KEY: session_key,
}),
response_payload=_audit_safe_payload(result),
)
)
return response
@staticmethod
def _health_result(check: Any) -> dict[str, Any]:
try:
return check()
except Exception as exc:
# Health checks should report failures, not mask the other provider.
return {
AIResponseKey.OK: False,
AIResponseKey.ERROR: str(exc),
AIResponseKey.TYPE: type(exc).__name__,
}
def draft_policy(
self,
title: str,
policy_type: str,
requirements: list[str],
actor: str,
) -> dict[str, Any]:
return self.run_skill(
AISkillId.DRAFT_POLICY,
variables={
"title": title,
"policy_type": policy_type,
"requirements": requirements,
},
actor=actor,
)
def draft_investment_research(
self,
symbol_or_topic: str,
risk_preference: str,
actor: str,
) -> dict[str, Any]:
return self.run_skill(
AISkillId.INVESTMENT_RESEARCH,
variables={
"symbol_or_topic": symbol_or_topic,
"risk_preference": risk_preference,
},
actor=actor,
)
def _audit_safe_payload(value: Any, depth: int = 0) -> Any:
if depth >= AI_AUDIT_MAX_DEPTH:
return AI_AUDIT_TRUNCATED_VALUE
if isinstance(value, dict):
safe: dict[str, Any] = {}
for key, item in value.items():
key_text = str(key)
if key_text.lower() in AI_AUDIT_SENSITIVE_KEYS:
safe[key_text] = AI_AUDIT_REDACTED_VALUE
else:
safe[key_text] = _audit_safe_payload(item, depth + 1)
return safe
if isinstance(value, (list, tuple)):
items = list(value[:AI_AUDIT_MAX_SEQUENCE_ITEMS])
safe_items = [_audit_safe_payload(item, depth + 1) for item in items]
if len(value) > AI_AUDIT_MAX_SEQUENCE_ITEMS:
safe_items.append(AI_AUDIT_TRUNCATED_VALUE)
return safe_items
if isinstance(value, str) and len(value) > AI_AUDIT_MAX_TEXT_LENGTH:
return value[:AI_AUDIT_MAX_TEXT_LENGTH] + AI_AUDIT_TRUNCATED_VALUE
return value
def _memory_scope(context: dict[str, Any]) -> str:
return str(
context.get(AIContextKey.MEMORY_SCOPE)
or context.get(AIMemoryPayloadKey.SCOPE)
or AIMemoryScope.GLOBAL
)
def _memory_subject(context: dict[str, Any]) -> str | None:
value = context.get(AIContextKey.MEMORY_SUBJECT) or context.get(AIMemoryPayloadKey.SUBJECT)
return str(value) if value else None