**Manifest** 是一个自托管的 AI 智能体代理网关，可将云端 API、订阅账号和本地模型统一接入，并为智能体提供模型路由、自动回退、请求审计、用量统计等能力。 --- ## 注意事项 - 适配懒猫 OIDC 登录。 - 初始化的时候请注意，如果直接使用懒猫登录，没有创建默认账号的话，自动填充的账号密码是无效的，需要重新注册一下 ## 适用场景 Manifest 适合以下用户： * 运行 AI Agent 或自动化工具 * 开发需要调用多个大模型的应用 * 在家庭服务器或私有环境中部署 AI 服务 * 希望统一管理云端模型与本地模型 * 需要查看模型调用记录、费用、用量和性能 它可以帮助解决： * 不同模型平台配置分散 * API Key 和模型账号难以统一管理 * 模型切换和备用模型配置繁琐 * 主模型请求失败后需要手动切换 * 难以统一查看调用记录、Token 用量和费用 --- ## 应用概述 Manifest 位于 **AI 智能体与模型提供商之间**，负责管理智能体所使用的模型渠道、路由策略和请求记录。 目前可连接包括： * OpenAI * Anthropic * Google * DeepSeek * Qwen * Ollama * LM Studio * llama.cpp * 自定义 OpenAI 兼容接口 * 自定义 Anthropic 兼容接口 可以在 Manifest 中添加不同的 API 渠道或本地模型，并为每个智能体单独配置首选模型和多个备用模型。 > **Manifest 并不是传统的模型中转服务。** > 它更偏向于智能体的模型代理层，负责模型路由、请求审计、用量统计和故障自动回退等功能，并不是简单地将全部模型直接转发给智能体使用。 --- # 主要特点 ## 🔀 统一管理多个模型渠道 Manifest 可以统一管理多种模型来源，包括： * API Key * 模型订阅账号 * 本地部署模型 * OpenAI 兼容接口 * Anthropic 兼容接口 不同来源的模型可以集中配置，再分配给不同的智能体使用。 --- ## 🧭 模型路由与自动回退 每个智能体都可以单独配置模型路由。 可以设置： * **首选模型**：正常情况下优先使用的模型 * **备用模型**：可以配置多个，当首选模型出现异常时按路由配置进行自动回退 当首选模型出现请求失败、超时或其他异常时，可以自动尝试备用模型，提高智能体运行时的稳定性。 --- ## 📊 请求审计、费用与用量分析 Manifest 可以记录智能体的模型调用情况，包括： * 请求内容 * 模型响应 * 请求状态 * 响应耗时 * Token 使用量 * 调用费用 方便查看不同智能体和模型的实际使用情况，并排查请求失败等问题。 --- ## 🖥️ 支持本地模型和自定义服务 除了云端模型，还可以连接： * Ollama * LM Studio * llama.cpp * 其他兼容 OpenAI API 的模型服务 可以将本地模型和云端模型放在一起管理，并根据成本、速度、隐私和模型能力进行选择。 --- # 快速入门 使用 Manifest 时，可以按照下面的流程完成基本配置。 ### 1. 创建智能体 进入 Manifest 后，先创建一个需要使用的智能体。 智能体创建完成后，再为它配置实际需要调用的模型。 ### 2. 添加 API 渠道 添加需要使用的模型 API 渠道，并填写对应的 API Key、服务地址等信息。 可以根据需要添加一个或多个不同的模型渠道。 ### 3. 配置模型路由 进入刚刚创建的智能体，在 **「路由」** 中配置模型。 至少需要设置： * **首选模型** * **一个或多个备用模型** 首选模型用于正常请求；当首选模型发生异常时，系统可以继续尝试配置好的备用模型。 > 创建智能体和添加 API 渠道后，还需要完成路由配置，否则智能体可能无法正常调用模型。 ### 4. 获取调用信息 进入智能体主页的 **「设置」** 选项卡，滑动到页面底部即可查看使用教程。 其中会提供调用智能体需要的信息，例如： * API 地址 * API Key * 接入方式 按照页面提供的信息配置到需要使用的 AI 应用或 Agent 中即可。 --- # 懒猫版本使用说明 ## 🔐 管理员账号与登录 懒猫版本会为**当前 Manifest 应用实例**生成并保存管理员账号和密码，不提供所有实例通用的固定默认密码。 首次进入设置或登录页面时，系统会自动填入当前实例对应的账号密码，确认信息后手动完成登录或提交即可。 首次打开应用后，需要进入： `/setup` 完成管理员账号创建流程。 完成设置后，该账号用于登录 Manifest 网页控制台。 > Manifest 控制台使用管理员账号登录；外部应用或 AI Agent 使用智能体对应的 API 信息进行调用。 --- ## ✨ 懒猫自动填充 应用已经适配懒猫自动填充功能，可用于： * 登录页面 * 首次设置页面 * 修改密码页面 自动填充只负责填写表单内容，不会自动点击登录、保存或提交按钮。 填写完成后请确认信息，并手动点击相应按钮。 --- ## 🌐 API 地址与服务端口 懒猫版本的 API 入口位于应用域名下： `https://应用域名/v1` 应用内部服务端口为： `2099` 具体调用智能体时所需的 **API 地址、API Key 等信息**，请进入对应智能体的 **「设置」** 页面，在底部的使用教程中查看。 --- ## 💾 数据持久化 Manifest 的主要持久化数据目录如下： | 数据类型 | 路径 | | ------------- | -------------------------------- | | PostgreSQL 数据 | `/lzcapp/var/postgresql` | | 请求记录 | `/lzcapp/var/request-recordings` | 认证密钥、数据库密码以及模型凭据加密密钥由懒猫自动生成并持久化。 **请谨慎清理应用数据。** 清理后可能导致管理员账号、智能体配置、模型配置、认证信息以及历史请求记录丢失。 --- ## 📝 请求记录与隐私 请求记录默认保留 **365 天**。 记录中可能包含： * 用户发送给模型的消息 * 模型返回的正文 * Token 用量 * 请求状态 * 调用耗时 * 其他请求相关信息 如果 Manifest 用于处理个人信息、工作资料或其他敏感内容，请注意请求记录的保存和访问权限。 --- > **注意：** 使用国外模型时需具备对应的网络访问条件，如无法自行解决，请联系 VIP 群获取帮助。