xunzhi-agent-domain

name	xunzhi-agent-domain
description	通用智能体（Agent）业务域 Skill。当需求涉及 /api/xunzhi/v1/agents/** 或 /api/xunzhi/v1/agent-properties/** 的会话、SSE 聊天、历史消息、文件上传、智能体属性管理，或关键词"场景绑定/BusinessAgentScene/星辰/flow_id"时使用。

xunzhi-agent-domain

通用 Agent 会话与配置管理；interview 域的 4 个智能体调用不走这里（见 interview 域）。

使用顺序

• 先看 references/module-map.md，确认本域管不管这个需求。
• 改会话/聊天行为，看 references/session-flow.md。
• 改场景绑定或智能体名解析，看 references/agent-binding.md 与 references/generated-agent-scene-map.md。
• 对象/集合归属看 references/object-dictionary.md，踩坑先看 references/gotchas.md。

关键入口

• app/agent/router.py（会话与聊天，6 端点）
• app/agent/properties_router.py（属性 CRUD，5 端点）
• app/agent/file_router.py（文件上传，1 端点）
• app/agent/resolver.py（BusinessAgentScene + 60s TTL 加载器）
• app/integrations/xingchen.py（星辰 SSE 转发）

必守约束

• 建会话的 agentId 取 resolver 的 GENERAL_AGENT_CHAT 场景，不取请求体；chat 的 agentId 由会话绑定决定。
• 候选名顺序是契约：默认名在前，别名在后。

参考资料

• references/module-map.md
• references/session-flow.md
• references/agent-binding.md
• references/generated-agent-scene-map.md
• references/object-dictionary.md
• references/gotchas.md
• scripts/extract_agent_scene_map.py（生成 references/generated-agent-scene-map.md）