1. API快速配置
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置（推荐）
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
    • WorkBuddy 配置指南
    • TRAE Work 配置指南
    • AWS Quick Suite 配置指南
    • DeepSeek Harness (DSH) 配置指南
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • API文档
    • 文本接口
      • Anthropic 文本接口
      • 豆包文本接口
      • Gemini 文本接口
      • OpenAI 文本接口
      • 🖼️ DeepSeek-V4-Flash-Vision 视觉理解
      • 🖼️ GLM-5.3-Flash 多模态理解
      • rerank文本重排序 API 文档
    • 图片接口
      • 🎨 Doubao 图片接口
      • Seedream 图生图接口
      • Gemini 图片生成接口
      • GPT-Image-2 图片接口
      • MiniMax-Hailuo 图片接口
      • OpenAI 图片接口
      • Gemini 图生图调用示例
      • 即梦 & 生数异步图片接口
    • 视频接口
      • kling-v3-传入参考视频
      • 🎬 Kling-v3 系列视频接口
      • 豆包（Doubao）视频接口
      • Happy Horse 视频接口
      • 即梦视频接口
      • Kling 视频接口
      • Seedance 2.0 多图生视频调用示例
      • Sora 视频接口
      • Veo 视频生成 API 接口文档
      • MiniMax-H3 视频生成 API 文档
      • MiniMax-H3-Max 视频生成 API 文档
      • 🎬 Vidu 系列视频接口
      • wan万相 3.0 视频接口
      • Shuchuang 高清直出视频生成接口
      • 拍我AI PixVerse视频生成 API 文档
    • 语音接口
      • 🎙️ 豆包端到端实时语音接口
      • seed-audio-1.0语音合成 API 文档
      • MiniMax Speech API 文档
      • Mureka 音乐生成接口
  • API接口
    • 模型
      • 获取可用模型列表
    • 文本对话
      • OpenAI 对话补全
      • OpenAI Responses
      • Anthropic 消息接口
      • Gemini 内容生成
    • 图片生成
      • 图片编辑
      • 图片编辑 gpt-image
      • 图片生成
    • 视频生成
      • 提交视频生成任务
      • 查询视频生成任务
      • 按令牌获取视频任务列表
    • 素材库
      • 真人素材 API 接口文档（H5 人脸认证）
      • 创建素材 / 批量上传
      • 查询素材列表
      • 查询单个素材
      • 按批次查询素材
      • 更新素材名称
      • 删除素材
      • 获取素材库列表
      • 创建素材库
      • 删除素材库
      • 转移素材库
    • 素材管理
      • 素材管理 API 接口文档
      • 素材库自定义阿里云OSS教程
  • Seedance2文档
    • 豆包 Seedance 2.0 / 2.5 视频生成接口
    • 豆包 Seedance 2.5 草稿样片与正片 API 接口文档
    • 按令牌获取视频任务列表
    • 素材库 API 接口文档
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. API快速配置

AWS Quick Suite 配置指南

AWS Quick Suite（原 Amazon QuickSight / Amazon Q Business 的智能体办公套件）是亚马逊云科技推出的一体化 AI 办公平台，支持接入大模型与外部工具，用于办公问答、文档处理、数据分析等场景。通过 MCP（Model Context Protocol） 与 OpenAPI Actions 两种扩展机制，可以把魔芋AI（MoyuAI）平台上的 GPT、Claude、Gemini、豆包等各类模型接入 Quick Suite 智能体，实现由魔芋AI 统一计费与路由的模型调用。
本文以「魔芋AI」平台为例，讲解如何在 AWS Quick Suite 中完成接入配置。

1. 前置条件#

在开始配置前，请确认已具备以下条件：
项目要求
AWS 账号已开通 Amazon Quick Suite 的 AWS 账号（Quick Suite 目前仅在部分 Region 提供，请以控制台实际可用区为准）
魔芋AI API Key形如 sk-XXXXXX，在平台「令牌管理」页面创建
服务地址https://www.moyu.cn
管理员权限需要 Quick Suite 的 管理员（Admin） 权限才能添加集成与配置模型
前置条件：需要拥有魔芋AI的 API Key（形如 sk-XXXXXX，在平台「令牌管理」页面创建），以及服务地址 https://www.moyu.cn。

2. 进入 Quick Suite 控制台#

1.
登录 AWS 控制台，在顶部搜索框输入 Quick Suite，进入 Amazon Quick Suite 服务页面。
2.
首次使用需按向导完成初始化：选择部署 Region、连接数据源、定义用户/团队权限、选择默认模型。初始化完成后进入 Quick Suite 主界面。
3.
主界面左侧为功能导航栏，点击 Integrations（集成） —— 若无该入口，请点击左下角 设置（Settings） 后进入 Integrations。

3. 添加接入方式#

Quick Suite 不直接提供「粘贴第三方模型 base URL」的表单，接入魔芋AI 需要通过其扩展机制完成。请根据你的实际部署情况，从下列两种方式中选择一种，并在本节后续补充对应的实际操作步骤。

3.1 方式一：MCP 集成（推荐）#

通过 Integrations → 添加（+）→ Model Context Protocol (MCP) 注册一个 MCP Server 端点，由该 Server 转发到魔芋AI。
1.
在 Integrations 页面点击 添加（+），在弹出的集成类型列表中选择 Model Context Protocol (MCP)。
2.
填写集成基本信息：
配置项填写内容说明
名称 / NameMoyuAI集成的展示名称，便于在智能体中区分
描述 / Description魔芋AI 模型服务可选，用于说明用途
MCP Server 端点 URLhttps://<你的 MCP Server 域名>/mcp必须为 HTTPS 公网地址；不支持端口号、localhost、IP 与 EC2 默认 DNS 名
传输方式Streamable HTTP（推荐）也支持 SSE，官方推荐 HTTP streaming
认证方式见 3.3由你的 MCP Server 决定
3.
点击 创建 / Create。Quick Suite 会调用 MCP Server 的 listTools 自动发现可用工具，创建完成后页面会列出发现的工具列表。
4.
确认工具列表无误后点击 Done，并可将该集成 共享（Share） 给需要的用户或团队。
注意：集成创建后，工具列表会被视为静态配置。若后续 MCP Server 的工具定义发生不兼容变更，需要 删除并重新创建 该集成定义，客户端不会自动感知变化。

3.2 方式二：OpenAPI Actions#

通过 Integrations → Actions 注册 OpenAPI schema，把魔芋AI 的 chat/completions 等接口包装成一个可调用动作，由智能体在对话过程中按需调用。
1.
在 Integrations 页面进入 Actions，点击 添加动作。
2.
上传或粘贴 OpenAPI schema，并在其中指向魔芋AI 的服务地址：
配置项填写内容说明
OpenAPI 地址（servers）https://www.moyu.cn/v1魔芋AI 的 OpenAI 兼容地址，不要以斜杠结尾
路径（paths）/chat/completions由 servers + path 拼出完整端点
认证方式Bearer Token对应你的魔芋AI API Key
3.
保存后在 Test APIs 中验证接口可正常返回，再到 Chat Agent 中启用该动作。

3.3 配置认证#

Quick Suite 的 MCP 集成支持三种认证方式，请与你的 MCP Server 实现保持一致：
认证方式适用场景需要填写的字段
用户认证（User authentication）每个用户以自己的身份授权OAuth 2.0 授权码流程相关字段、Client ID / Secret、Token URL、Scope
服务认证（Service authentication）服务间调用，无需用户登录Client ID / Secret、Token URL、Scope（client_credentials 流程）
无认证（No authentication）仅公开或演示环境无需填写
安全提示：不建议在 MCP Server 代码中硬编码魔芋AI 的 API Key。请将 Key 存放于 AWS Secrets Manager 或等价的密钥托管服务中，由服务端在转发请求时注入。
配置完成后点击 确认 / Done 保存。

4. 验证#

配置保存后，进入 Chat / Chat Agent 发起一次会话进行验证：
1.
新建一个会话，向智能体发送一条测试消息（如"你好"）。
2.
若智能体调用了魔芋AI，应能正常返回内容。
3.
可同时在 魔芋AI 平台「日志 / 调用记录」 页面确认是否有对应请求落账，以此确认流量确实走了魔芋AI。
注意：与桌面端工具不同，Quick Suite 不会在对话框直接列出「自定义模型」供手动切换。是否调用到魔芋AI，取决于智能体的工具调用编排，而非手动选择。

5. 切换 / 指定其他模型#

魔芋AI 平台已将各家模型统一转换为 OpenAI 格式，因此 服务地址、API Key、认证方式均保持不变，只需更换 模型 ID 即可路由到平台上的其他模型。

5.1 配置不同模型#

在你的 MCP Server（或 OpenAPI 动作）实现中，把请求体里的 model 字段改为目标模型 ID 即可：
模型 ID 示例说明
gpt-5.6-solGPT 系列
claude-opus-4-8Claude 系列
deepseek-v4-proDeepSeek 系列（纯文本模型）
请以平台「模型广场」或 GET https://www.moyu.cn/v1/models 返回的实际模型名称为准；模型 ID 需 完全一致（含大小写与连字符）。
若希望一次暴露多个模型，可在 MCP Server 中以 listTools 的方式为每个模型注册一个工具，或提供一个带 model 参数的统一工具。

5.2 按能力区分模型#

不同模型支持的能力不同：
多模态（图片输入）：多模态模型（如 gpt-4o、claude、gemini 系列）可在工具 schema 中接受图片 URL 或 base64 输入。
纯文本模型：如 DeepSeek 系列，仅支持文本输入，请勿向其传递图片参数。
修改完成后，若工具定义发生变更，记得按 3.1 的说明 重新认证或重建集成，再在会话中验证。

6. 常见问题#

Q：Integrations 页面找不到 MCP 选项？
A：确认当前账号具备 Quick Suite 管理员权限，且所在 Region 支持该功能。部分 Region 的功能上线节奏不同。
Q：提示 401 / 密钥无效？
A：检查 API Key 是否完整、有无多余空格；确认令牌未过期、账户额度充足。若使用服务认证，需确认 Token URL 与 Scope 与 MCP Server 配置一致。
Q：提示 404 Not Found？
A：确认服务地址与接口路径的拼接结果正确——魔芋AI 的 OpenAI 兼容地址为 https://www.moyu.cn/v1，不要以斜杠结尾，也不要重复拼 /chat/completions。
Q：请求超时？
A：Quick Suite 对单次 MCP 操作有固定超时限制（约 300 秒），超时返回 HTTP 424。长耗时任务请改为异步提交 + 轮询结果的方式。
Q：MCP Server 端点 URL 填本机地址或 IP 不行？
A：Quick Suite 要求 MCP Server 通过 HTTPS 公网可达，不接受端口号、localhost、纯 IP 以及 EC2 默认 DNS 名。请为服务配置域名与证书（如通过 ALB 暴露）。
Q：工具列表改了，Quick Suite 里没变化？
A：集成创建后工具列表按静态处理，变更需删除并重建集成定义，重新完成认证。
Q：提示 connect ETIMEDOUT？
A：说明网络无法连接到端点，检查网络环境或代理设置，确认 https://www.moyu.cn 可正常访问。
Q：为什么我不能在对话框里直接切换模型？
A：Quick Suite 的模型选择由平台侧与智能体编排决定，不提供桌面工具那样的「自定义模型」下拉切换。要切换路由到魔芋AI 的模型，请在 MCP Server / OpenAPI 动作中修改模型 ID。
修改于 2026-09-15 07:16:24
上一页
TRAE Work 配置指南
下一页
DeepSeek Harness (DSH) 配置指南
Built with