前言¶
在使用大模型代理（Agent）开发需要调用天翼账号相关接口的业务时，通常会面临认证流程复杂、扫码登录需要手动处理、会话状态难以复用等问题。已有做法通常是手动实现 OAuth 流程或依赖其他 Skill，代码量较大且容易出错。下面介绍一个直接面向 AST 认证的 Skill，能将登录、扫码、会话验证和 idToken 获取等步骤封装起来。
这是什么¶
天翼账号 AST 认证 Skill（坐标 @user_990a4550/tianyi-ast-direct-auth-v7-1）是 SkillHub 社区发布的一个 Skill，版本为 1.0.2，分类为 dev-programming。它为合作方业务提供按 appId 调起登录认证的能力，自动完成扫码登录、会话复用与验证，并返回可用于业务接口的 idToken。
核心功能¶
- 支持扫码登录：自动处理天翼账号的二维码登录流程。
- 会话复用：在认证成功后保持会话状态，避免重复扫码。
- 登录状态检查：可检查当前的 AST 登录状态。
- 401 重认证：当认证失效时自动触发重新认证。
- idToken 获取：返回可用于业务接口的 idToken。
- 支持本地 agent_session 状态管理。
安装与启用¶
SkillHub 安装命令：
skillhub install @user_990a4550/tianyi-ast-direct-auth-v7-1
安装后，在需要使用天翼账号认证的对话或任务中，可以直接调用该 Skill 提供的功能。
典型用法¶
在需要调用天翼账号相关业务接口时，可以通过该 Skill 完成认证流程：
- 调用 Skill 提供的扫码登录功能，获取二维码或处理登录流程。
- Skill 会自动完成扫码、会话复用与验证。
- 认证成功后，从 Skill 返回的 idToken 可用于后续业务接口调用。
适用场景与注意¶
- 适合需要接入天翼账号认证的合作方业务。
- 适合需要自动处理登录状态、会话复用和 idToken 获取的场景。
- 需要确保在调用前已正确配置 appId 等业务参数。
- Skill 依赖天翼账号的 AST 认证接口，需确保网络环境可访问相关接口。
结尾¶
天翼账号 AST 认证 Skill 将扫码登录、会话复用与 idToken 获取等流程封装为一个统一的 Skill，减少了重复造轮子的工作，适合需要接入天翼账号认证的合作方业务使用。
官方地址：https://www.skillhub.cn/skills/user_990a4550/tianyi-ast-direct-auth-v7-1
