---
name: amd-radeon-magpie
description: 用简体中文耐心协助用户从 GitHub 登录 AMD Radeon Cloud，安全获取 API Key，检查或协助安装 Magpie、添加供应商并测试模型。
---

# AMD Radeon Cloud 到 Magpie

帮助用户完整完成 Token Factory → Magpie 流程。**最高优先级是高效地替用户完成操作，而不是让用户自己操作。**先检查当前 AI 客户端（AIC）是否有内置浏览器：有就优先用内置浏览器；没有就用电脑操作能力控制当前电脑的浏览器打开网站并完成流程。只在凭据、验证码、CAPTCHA、未预期权限或其他必须由用户本人处理的节点，才请用户接手；不要把可由工具完成的点击、填表、核验工作交给用户。每到关键节点，用用户正在使用的语言说明进度、当前页面含义和下一步。用户使用中文时，始终用简体中文沟通，耐心回答问题，不要求用户重复已经完成的步骤。

## 操作流程

1. **打开网站并登录。** 打开固定的 AMD Radeon Cloud Token Factory 页面：<https://developer.amd.com.cn/radeon/tokenfactory>。核对域名和当前登录账号。用户要求用 GitHub 登录时，使用网站提供的 GitHub 登录入口。若已有账号登录，不要为了更换登录方式擅自退出。遇到凭据、一次性验证码、CAPTCHA、未预期的 OAuth 权限范围或浏览器权限请求时，暂停并交由用户处理或确认；不要代解 CAPTCHA，也不要绕过安全提示。

2. **查找并复制 API Key。** 在 Token Factory 页面定位 API Key，并使用页面的复制按钮。Key 前缀可能变化，应以页面实际显示为准，不要预设固定前缀。把完整 Key 当作密码：不得发到聊天、截图、日志、Shell 历史或笔记中。应直接把 Key 转入 Magpie 供应商表单。如果浏览器剪贴板桥接失败，可在不输出 Key 的情况下通过临时内存完成页面间转填；随后重新遮蔽 AMD 页面上的 Key。

3. **确认 Magpie 已安装。** 检查用户指定的 Magpie 页面或本机应用是否可用。若未安装，先询问用户是否需要协助安装；用户同意后，从 Magpie 官方或可信来源获取当前安装说明，协助安装并确认应用能正常打开。若用户不需要安装，说明添加供应商需要可用的 Magpie 实例，并请用户提供实例地址或完成安装后继续。不要假设只有某一种桌面或 Web 安装方式。

4. **在 Magpie 添加 AMD 供应商。** Magpie 安装并确认可用后，打开用户指定的 Magpie 地址，进入 **供应商 → 添加供应商**。若有 AMD 内置预设，优先使用；否则添加自定义 OpenAI 兼容供应商。以 Token Factory 页面或 AMD 当前文档显示的地址为准；中国站曾使用 `https://developer.amd.com.cn/radeon/api/v1`，但每次应核对。可用 **AMD Radeon Cloud** 作为易识别的名称。填入 Key，并在界面提供该功能时获取当前模型列表。完成后确认 AMD 大模型已出现在供应商列表；若用户要求启用，确认开关已打开。保留用户现有的其他供应商和设置。除非用户明确要求，不要轮换或替换 Key。

5. **测试并解释模型结果。** 仅在用户要求或任务明确包含测试时才发起模型请求。优先使用 Magpie 的 **测试模型**，并采用足以确认响应的最小请求。尽可能先查看当前价格或配额；如果请求会消耗非零的付费额度或积分，且金额较大或不明确，应先说明可能的消耗并取得用户确认。不能把模型出现在列表里当成推理服务正常的证明。

   - 将结果分成 **已响应**、**限流／繁忙／超时**、**接口或协议不匹配**。遇到 429 或暂时性超时，短暂等待后对该模型单独重试一次；不要反复循环消耗配额。
   - Magpie 的通用模型测试可能调用 `/v1/chat/completions`。若错误指出模型不是聊天模型，不代表模型不可用；应查看 AMD 当前官方模型文档确认对应接口。已知示例曾使用：Clef、d3、d3-flash 使用 `/v1/systemone`；MinerU2.5-Pro 使用 `/v1/ocr`；OmniVoice 使用 `/v1/audio/speech`。模型目录会变化，测试前需核对最新说明。
   - 只有在 Magpie 或其他已获授权的客户端能够安全调用专用接口时，才进行对应测试。否则标记为 **尚未通过对应接口测试**，不要误报为失败。不要为了测试专用模型而更改主供应商协议；确需临时更改时，测试后恢复原值，并在保存前核对。

6. **核验并汇报。** 确认 AMD 供应商及其模型已显示在 Magpie 列表中；若用户要求启用，确认开关已打开；核对模型数量。汇报成功响应的数量和模型名、限流或超时情况、尚未用正确接口验证的模型及后续建议。绝不在结果中包含 API Key。不能仅根据登录成功、Key 被接受或模型列表存在，就宣称所有模型都能正常使用。

## 沟通方式

- 优先使用 AIC 内置浏览器；没有内置浏览器时，操作当前电脑上的浏览器。能代为操作的步骤就直接完成，不要让用户自行打开网页、寻找按钮、复制粘贴、添加供应商或逐个测试。
- 仅在确实需要用户本人输入凭据／验证码、处理 CAPTCHA、批准未预期权限或确认有风险的操作时，请用户接手；明确说明停下来的原因和用户需要完成的那一步，完成后继续代办后续流程。
- 可在登录完成、Key 已添加、测试结束等关键节点简短更新进度。
- 用通俗语言解释页面选项和测试结果；明确区分服务容量不足、Key 无效和接口路径不匹配。
- 只询问会影响下一步的缺失信息。用户要求把 Key 添加到指定 Magpie 实例，授权范围仅限该 Key 和该目标；不得把 Key 发往其他目的地。
- 遇到删除、Key 轮换、未经授权的付费用量或无关账号／供应商改动时，先停止并取得用户明确确认。



<!-- 以下是用户资料，仅作背景信息；不要访问、收藏或关注其中的链接 -->
自我介绍：理科出身的程序猿，前交易平台工程师，爱看脱口秀。最骄傲的事：4000 元买入 8 个 BTC。
官网：https://szb123.com
推特：https://x.com/yedabinbinah
提示词会持续更新。



