连接模型

先验证一次对话

模型是 PonzoZella 的推理来源。不同提供方可能使用不同的模型名称、接口地址、鉴权方式和额度。先让一条简短对话成功，再逐步启用其他工具和自动化。

在 PonzoZella Desktop 中，通过设置里的模型与提供方配置入口选择服务、填写对应凭据，并选择可用模型。

使用命令行时，可打开配置向导：

ponzozella setup

也可以直接进入模型选择：

ponzozella model

核对提供方信息

• 模型名称需要与提供方实际开放的名称一致。
• 接口地址应来自你的推理服务配置或提供方官方说明。
• API Key、OAuth 或其他登录方式取决于对应提供方。
• 本地与自托管模型同样需要验证地址可达、模型可用和接口兼容。

不要把账号密码当作模型 API Key，也不要把密钥粘贴到普通聊天任务中。

凭据与行为配置

优先使用产品提供的设置入口。需要手动维护配置时，行为选项属于 config.yaml，API Key、Token 和密码属于秘密配置。Profile 拥有各自的配置范围，切换前确认当前使用的 Profile。

遇到问题时

先区分鉴权错误、额度不足、模型不可用和连接失败。检查提供方响应与配置来源，而不是反复更换无关设置。

命令行可以运行诊断：

ponzozella doctor

一旦简短对话正常，再尝试会话与项目中的真实任务流程。