聊天 API
聊天 API 为 GenAI/语义助手提供对话入口。可用模型与工具能力取决于服务器配置；401、模型不可用和上游 5xx 应分别显示。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
模型
客户端不要假定固定模型名，应读取服务器配置或允许管理员选择。
上下文
发送摄像头/事件上下文前要控制大小，避免超出提供方 context window。
超时
生成式请求可能比普通 API 慢，使用更长但有限的超时并允许取消。
隐私
上传到云端 Provider 的图像/文本应由管理员明确知晓；本地 Provider 可用于敏感环境。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Chat API
Chat APIs provide the GenAI assistant entry point. Available models/tools depend on server configuration and errors should be distinguished.
Core behavior
This page is topic-specific rather than a generic placeholder.
Model
Do not hardcode a model name; use server configuration.
Context
Bound camera/event context to provider limits.
Timeout
Use longer but bounded timeouts and cancellation.
Privacy
Administrators should know what media/text is sent to cloud providers.
Verification and troubleshooting
- Record the current version/config before changes so rollback is possible.
- Verify both UI state and backend logs after the change.
- If only one camera/plugin is affected, isolate it before making global changes.
API de chat
La API de chat es la entrada del asistente GenAI; modelos/herramientas dependen del servidor y los errores deben diferenciarse.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Modelo
No fije un modelo en el cliente.
Contexto
Limite contexto al tamaño permitido.
Timeout
Use timeout mayor pero limitado y cancelación.
Privacidad
Informe qué datos se envían a proveedores cloud.
Verificación y diagnóstico
- Registre versión/configuración antes de cambiar para poder revertir.
- Compruebe UI y logs del backend después.
- Si afecta a una sola cámara/plugin, aíslelo antes de cambios globales.