常见问题
快速解答。
最常被问到的问题，需要更多细节时，附上了完整指南的链接。
快速上手
跟着「快速开始」走一遍：登录、选择团队、确认模型可用，然后完成第一次智能体对话。跑通之后，再阅读智能体、知识库和工作流的概念页，了解各部分如何协同。
智能体负责理解目标、规划步骤、检索知识并调用工具；工作流则把已经明确的流程固化为可重复执行的步骤。很多团队用智能体处理开放性的任务，用工作流承载每次都应保持一致的环节。
核心平台基于 GPL-3.0 开源。在遵守许可证的前提下，你可以下载、部署、定制，并在内部商业环境中使用。服务支持与企业版则提供专业协助与更高级的能力。
部署与运维
可以部署在自有服务器、私有云或 Kubernetes 集群中。文档涵盖 Docker Compose、Kubernetes、Sealos 以及源码运行。
可以。配合本地模型、嵌入模型和本地向量数据库，无需公网连接即可运行。只有当你主动配置外部模型或 API 时，请求才会离开你的网络。
自托管文档列出了全部环境变量，参考章节则涵盖站点设置、速率限制与权限说明。
切换版本之前，请先阅读升级与备份指南，并查看更新日志中是否有影响你部署的变更。
先看「故障排查」和自托管常见问题，它们覆盖了最常见的部署问题。如果仍未解决，请通过支持表单把详细信息发给我们（版本、部署方式和相关日志），我们会协助排查。
模型、知识库与工具
可通过 Ollama、vLLM 或任意兼容 OpenAI 接口的网关接入本地开源模型，也可连接 OpenAI、Anthropic、Gemini、Azure OpenAI 等商业 API。模型与 Token 配额可按团队、智能体和工作流分配。
检索效果取决于文档如何分块，以及检索如何配置。请检查这两项，参考知识库优化指南，并用几个有代表性的问题反复测试。
可以。智能体可以使用内置工具、自定义工具、MCP 服务和 Skills，工作流也可以通过 Webhook 接入现有的自动化链路。
团队、权限与安全
Clouisle 以团队作为资源边界，支持角色、RBAC、SSO、API Key 与审计日志。个人会话和草稿默认保持私有，直到你主动共享。
二者都在管理后台中配置。API Key 可以限定到特定的智能体或工作流，并设置有效期和请求频率上限。
你所在组织的管理员可以在用户管理中处理成员账号。如果已经没有管理员能够登录，请通过支持表单把部署信息发给我们，我们会协助你找到最稳妥的恢复方式。
请不要公开提交 Issue。请直接发邮件给我们并附上详细信息，我们会私下回复。
仍然没解决？
和真人聊聊。
不是所有问题都适合写进 FAQ。选择最符合你情况的入口，我们会把它转给合适的人。
支持表单部署与使用协助
卡在部署、配置，或某个工作流怎么都不对？告诉我们你试过什么，我们会帮你继续往前走。
填写支持表单支持表单方案、授权与企业版
关于商业使用、服务支持或企业版、SSO、合规与 SLA 的问题？留下你的信息，我们会与你联系。
联系我们GITHUB缺陷与功能建议
发现了缺陷，或有新的想法？公开的 Issue 对所有人都有帮助，讨论也更透明。
提交 GitHub Issue邮件安全与隐私
请私下报告安全漏洞或隐私问题，这类问题请避免使用公开 Issue。
发送邮件 附上这些信息，我们能更快帮到你。
- Clouisle 版本，以及部署方式（Docker Compose、Kubernetes 等）
- 你期望的结果，以及实际发生了什么
- 复现步骤，或涉及的页面与功能
- 相关日志或错误信息
- 你希望我们如何联系你
请勿提交密码、API Key 或令牌，日志中如有请先删除。
