XingSkill智能体广场用户指南

登录

登录与账号开通

打开浏览器访问XingSkill智能体广场控制台，使用天翼 AI 开放平台账号登录，并完成实名认证。

首次使用需提交账号申请：

1. 填写账号使用申请，内容包括姓名、邮箱、公司、职位、预期使用场景等；
2. 提交后进入审批流程，审批通过前页面会提示等待审批；
3. 审批通过后，提示页面不再显示，即可正常使用XingSkill智能体广场全部功能；
4. 审批驳回后，页面显示驳回结果，可修改后再次提交。

控制台功能导航

审批通过后进入控制台，左侧导航即本指南的章节结构：概览、MCP 中心、Skills 中心、A2A 中心、API Key 管理。

概览

服务概览

概览页按 A2A、MCP、Skills 三个页签展示资源调用量与下载量趋势、资源排行等信息，默认展示近 7 天数据。主要指标如下：

类别	核心指标
A2A	发现成功率、任务发起数量、调用总量、任务成功率、平均任务耗时
MCP	工具总量、调用总量、调用成功率、平均响应耗时
Skills	下载总量、调用总量、调用成功率、平均调用耗时

 

**时间筛选规则：**支持近 7 天 / 近 30 天 / 近 90 天及自定义区间，自定义最大跨度 90 天；资源排行为采样统计（一天统计一次），非实时精确值。

MCP 中心

MCP 中心用于管理 MCP 工具资源。MCP（Model Context Protocol）是大模型发现和调用工具的标准协议，让 AI 应用能够开箱即用地使用您发布的工具能力。

资源列表

MCP 中心列表分为「私有 MCP」与「公有 MCP」两类页签：

• 搜索：在顶部搜索框输入资源名称或能力描述，点击搜索即返回命中资源；
• 筛选：支持按资产状态（已启用 / 已关闭）、广场状态（已上架 / 待审核 / 未上架 / 下架审核中 / 已禁用 / 未通过）、标签分类组合筛选；
• 资源卡片：展示图标、名称、启用状态、上架状态、最新版本、已创建版本数、总调用量、最近变更时间；卡片「更多」菜单提供发起下架、删除资源、查看详情。

创建 MCP

进入「MCP 中心」，点击右上角「新建 MCP」，按两步完成创建：基础配置 → 介绍（可选）。仅支持 streamable 协议类型的 MCP。

创建方式支持原生MCP转换和HTTP转MCP两种方式，基本信息填写要求如列表所示：

字段	必填	说明
MCP 名称	是	支持中文、英文、数字、下划线，最多 50 字符
配置版本号	是	默认 1.0.0，只能递增
所属分类	是	下拉选择平台分类标签，默认归入"其他"
标签	否	最多 20 个；标签键 1-128 字符、标签值 0-256 字符，仅可包含语言字符、数字、空格及英文符号_. : / = + - @
功能描述	否	不超过 500 字符

 

方式一：原生 MCP 转换

1.MCP Server 配置：选择「URL 输入」填写地址，或选择「JSON 配置」粘贴配置。JSON 一次只能导入一个，格式不合法会提示无效 JSON。

2.安全方案（必填，默认"无需鉴权"）：

• 需要鉴权 · 标准 Key；
• 需要鉴权 · 用户 OAuth：平台托管须填写授权端点、Token 端点、Refresh 端点、用户信息端点、Scopes、Client ID / Secret，并点击「授权验证」，验证通过后才能导入工具；开发者 H5 免配置；
• 无需鉴权。

1. 工具管理 ：从MCP实例导入：获取工具列表包含 Tools、Resources、Prompts 三类，勾选需要导入的工具（默认全选）；

1. 介绍（可选）：Markdown 格式，页面提供参考示例模板。

方式二：HTTP 转 MCP

适用于将已有 REST API 标准化为 MCP，基础信息与原生 MCP 一致，差异如下：

• MCP Server 配置输入 API Base URL；
• 工具管理为「从 API 文档导入」，须提供符合 Swagger 2.0 或 OpenAPI 3.0 规范的 API JSON文档，平台解析各接口的名称、描述与参数结构供选择导入；
• 创建成功后，平台自动生成 MCP Server 网关端点。

详情、编辑、版本管理

在资源列表点击「查看详情」进入 MCP 详情页，包括：版本选择、标签、新建版本、编辑、版本状态启停、版本数据、基本信息、详细介绍、Tools、Resources、Prompts、版本历史。

1.编辑：MCP 名称与版本号不可修改，其余字段均可编辑；

2.新建版本：MCP 名称不可修改，版本号只能递增，其余可修改；

3.详情介绍即创建MCP时填写的介绍；

4.Tools、Resources、Prompts为创建MCP时拉取的工具；点击工具右侧的箭头可展开，查看工具名称、描述等信息

5.版本历史：展示所有版本的版本号、广场状态、版本提交说明、版本更新时间；

6.版本状态启停：控制该版本能否被外部调用。

上架广场

私有 MCP 创建完成后，可将某个版本上架到广场，供其他用户订阅使用：

1. 点击「上架广场」，平台列出当前资源所有未上架的版本（含名称、描述、标签、可上架版本数）；

1. 选中要上架的版本，填写开发者名称（不超过 30 字符）与上架描述（不超过 500 字符）；
2. 勾选同意相关协议，点击提交；

4.提交后提示「已经提交，请耐心等待审核，一般 3 个工作日内审核通过」，版本进入"待审核"状态，版本历史同步更新；

5.审核通过后，MCP 出现在公有 MCP 列表，全网用户可订阅；审核驳回则显示"未通过"，可查看驳回理由，整改后重新提交。

订阅与调用

**公有 MCP 订阅：**公有列表仅支持查看与订阅，订阅后方可调用。订阅支持两种方式：① 固定版本订阅——锁定该版本，资源发布新版本不会自动切换；② latest（跟随更新）——自动跟随最新已上架版本。订阅版本非最新时卡片会变色提醒；取消订阅后卡片恢复"未订阅"状态；已订阅版本被开发者下架不影响继续使用。

**调用方式：**在 MCP 使用说明页复制 MCP Server 配置 JSON（可一键复制），配合 API Key 填入鉴权配置后，即可在支持 MCP 的客户端中使用；使用说明页同时提供跳转 API Key 管理的入口。

下架与删除

**1.版本状态启停：**详情页开关，仅控制该版本能否被外部调用（此功能针对私有资源，对已上架到公有的版本无影响）；

1. **发起下架：**点击资源卡片「...」按钮发起，选择版本、填写下架原因后提交；审核通过前该版本仍正常提供服务，审核通过后上架状态变为"未上架"，未通过则维持"已上架"；

1. **删除资源：**仅当资源不存在已上架版本时才可删除（否则按钮置灰）；若资源无用户订阅，则直接删除，若资源有用户订阅，删除后资源保留 30 天对外服务（卡片显示倒计时），已订阅用户会收到高亮提醒"该资源已被开发者删除，服务将在 xx 天后不可用，请尽快移植服务"，30 天后正式删除。

Skills 中心

Skills 中心用于管理 Skills 技能包资源。Skill 是将特定领域知识、流程和最佳实践以 skill.md 结构化组织的能力单元，AI 应用可按需、稳定地调用skill来执行专业任务。

资源列表

Skills 中心列表分为「私有 Skills」与「公有 Skills」两类页签，支持按资源名称与能力描述搜索，按资产状态、广场状态、标签分类组合筛选；公有列表额外支持按"是否可下载""是否需要申请 API Key"筛选。资源卡片展示图标、名称、启用状态、上架状态、最新版本、已创建版本数、总下载量、最近变更时间。

创建 Skills

进入「Skills 中心」，点击右上角「新建 Skills」，通过上传压缩包创建：

1.准备压缩包：格式必须为 .zip，根目录必须包含 skill.md 文件，大小不超过 50MB；

2.上传并解析：平台自动解析 skill.md，技能名称、功能描述等信息自动填充，均可手动编辑；

3.填写基础信息（必填：skill 名称、配置版本号默认 1.0.0、分类默认"其它"、安全方案默认"无需鉴权"；选填：功能描述）；

4.选择安全方案：无需鉴权 / 需要鉴权但不需要平台托管 Key（使用者自行申请 Key）/ 需要鉴权并提供环境变量给平台（平台代托管 · 标准 Key）；

5.标签（选填，最多 20 个）；信息填写完毕后点击右上角「创建」，完成创建。

详情、编辑、版本管理

Skills 详情页包括：版本切换、标签、编辑、新建版本、版本状态启停、版本数据、基本信息、概述、文件浏览、版本历史。

1.概述：由 skill.md 格式化生成；

2.文件浏览：展示压缩包内全部文件，可查看 skill.md 源码及其他资源文件，提供打包下载；

3.编辑 / 新建版本：skill 名称不可修改、版本号只能递增，其余信息可通过重新上传压缩包解析填充。

上架广场

1.点击「上架广场」，选择要上架的版本，填写开发者名称（不超过 30 字符）与上架描述（不超过 500 字符）；

2.选择「是否允许资源下载」——该标识上架后显示在资源卡片上：允许下载的资源，订阅方可在详情页查看并下载全部文件；

3.勾选同意相关协议，点击提交，一般 1-3 个工作日内完成审核；

4.提交上架时，平台将自动对 Skill 进行安全评测，评测结果会展示在公有 Skills 详情页的安全审核区域，作为订阅参考。

订阅与调用

**公有 Skills 订阅：**订阅规则与 MCP 一致（固定版本 / latest 跟随更新）。特别地：上架时选择"允许下载"的资源，订阅后可在详情页查看并下载全部资源文件；选择"不可下载"的，订阅后无法查看资源文件；详情页同时展示安全审核结果。

**调用方式：**Skills 中心提供「XingSkill智能体广场指南 Skill」，可持久化安装到您的智能体本地，后续所有广场上 Skill 的调用、下载等操作都按它的规则执行——在使用说明页点击复制（内容为拉取平台指南文档并持久化到本地 skill 目录的指令）也可点击打开查看「XingSkill智能体广场指南 Skill」的内容，或到资源的详情页下载压缩包手动安装。

下架与删除

下架与删除规则与 MCP 中心一致：版本状态启停仅控制该私有版本能否被外部调用；发起下架需选择版本、填写原因，审核通过前版本正常提供服务；删除仅当资源不存在已上架版本时可用，删除后有 30 天缓冲期，已订阅用户会收到高亮提醒以便迁移。

A2A 中心

A2A 中心用于管理 A2A 智能体资源。A2A（Agent-to-Agent Protocol）是智能体之间派活与协作的开放标准，让您的智能体能够被其他 AI 应用发现、调度与协作。

资源列表

A2A 中心列表分为「私有 A2A」与「公有 A2A」两类页签，支持按智能体名称与能力描述搜索，按资产状态、广场状态、标签分类组合筛选；公有列表以"是否订阅"为筛选维度。资源卡片展示图标、名称、启用状态、上架状态、最新版本、已创建版本数、总调用量、最近变更时间。

创建 A2A

进入「A2A 中心」，点击右上角「新建 A2A」，核心是解析 AgentCard，分两步完成：基础配置 → 介绍（可选）。支持两种导入方式（本质相同）：

• **JSON 文件解析：**上传 AgentCard 的 JSON 文件；
• **AgentCard 地址：**填写 AgentCard URL，平台提取 JSON 并解析。

解析出的智能体名称、智能体版本、A2A 协议版本、AgentCard URL、智能体描述、能力配置、默认输入输出模式、技能表、分类自动填充；填充后仅分类可编辑，其余内容需修改原始 AgentCard 后重新导入。

项目	要求
必填字段	智能体名称、智能体版本、A2A 协议版本、AgentCard URL（https:// 前缀）、智能体描述、分类、能力配置、默认输入输出模式、技能表、安全方案
A2A协议版本	支持 0.3.0 / 1.0.0
多安全方案	配置了多种安全方案的 AgentCard 暂不支持导入，解析到时将提示并阻断

**安全方案（必填，默认"无需鉴权"）：**需要鉴权（标准 Key / 用户 OAuth 平台托管——须通过授权验证后才能进入下一步 / 用户 OAuth 开发者 H5）/ 无需鉴权。

详情、编辑、版本管理

A2A 详情页包括：版本选择 / 切换、编辑、查看 JSON 文件、新建版本、版本状态启停、版本数据、基本信息、详细介绍、版本历史。

上架广场

上架流程：选择未上架版本 → 填写开发者名称（不超过 30 字符）与上架描述（不超过 500 字符）→ 同意协议并提交 → 一般 3 个工作日内完成审核。审核通过后进入公有 A2A 列表。

订阅与调用

**公有 A2A 订阅：**订阅规则：固定版本 / latest 跟随更新，非最新版本卡片变色提醒。

**调用方式：**在 A2A 使用说明页复制调用网关端点（可一键复制），按 A2A 协议发起任务——支持任务创建、状态查询、结果推送等交互；页面同时提供跳转 API Key 管理的入口。

下架与删除

下架与删除规则与 MCP、Skills 中心一致：版本状态启停控制该私有版本能否被调用；发起下架审核通过前版本正常提供服务；删除需资源不存在已上架版本，删除后有 30 天缓冲期并提醒已订阅用户迁移。

API Key 管理

API Key 是调用XingSkill智能体广场资源的统一凭证。创建一个 Key，即可调用您全部的私有资源，以及所有已订阅的公有 A2A、MCP、Skill 资源，无需按资源分别申请。

新建 Key

• 进入「API Key 管理」页面，点击「新建」；
• 填写备注（即该 Key 的用途）；
• Key 的具体值由平台随机生成（不支持自定义），格式为 sk- 加小写字母和数字；
• 保存后 Key 可随时查看、复制。

查看、修改与删除

• 查看与复制：列表中可随时查看 Key 并复制；
• 修改：只能修改备注，Key 本身不支持修改；

• 删除：点击删除需确认风险提示；删除后使用该 Key 的调用将立即失效，请先确认没有业务依赖。

使用 Key 调用资源

资源类型	调用方式
MCP	在 MCP 使用说明页复制 Server 配置 JSON，将 Key 填入鉴权配置，在支持 MCP 的客户端中使用
A2A	复制调用网关端点，将key和资源id填充到端点中，即可对外提供服务
Skills	通过「XingSkill智能体广场指南 Skill」按规则安装与调用，或下载压缩包手动安装

**安全提示：**请妥善保管您的 API Key，不要在公开场合泄露；Key 删除后无法恢复，相关调用将立即失效。