本文介绍从购买PolarDB Agent Squad到使用Squad下发首个Issue的完整流程，包括购买、配置Squad实例、初始化工作区、下发Issue和查看交付结果与自进化复盘。
若您对PolarDB Agent Squad功能有任何问题，可通过钉钉搜索群号入群咨询。您可以直接@群内专家，并附上您要咨询的问题。
钉钉群号：28000021116
步骤一：购买Squad
登录PolarDB控制台，在左侧导航栏选择，进入PolarDB Agent Squad管理页面。
单击新建 PolarDB Agent Squad，进入购买页面。
按业务需要完成参数选择，建议按付费类型→引擎→地域→生态→实例规格（组件集）→网络和可用区→安全组顺序配置。
购买完成后返回PolarDB控制台，在PolarDB Agent Squad页面即可查看已创建的Squad实例。
步骤二：配置Squad实例
新创建的Squad实例默认仅支持VPC内网访问，访问受白名单限制。您需要根据实际访问方式，开通公网访问、配置白名单，并登录Squad Console下发任务，最后通过Daemon把Runtime连接到Squad。
（可选）开通公网访问
如需从公网访问Squad Console，或使Agent通过Squad访问公网资源，请开启对应能力。
公网访问Squad Console:
在Squad详情页的基本信息页签中，找到连接管理区域。
单击申请，在确认对话框中单击确定申请公网地址。申请成功后，连接管理区域将显示公网IP地址和端口信息。
允许Squad访问公网资源：如需Squad内Agent访问公网，请在使用流程引导区域中开启全局SNAT开关。
配置网络白名单
新创建的Squad实例默认禁止所有外部IP访问。您需要将客户端所在网络的IP地址添加到白名单。
在Squad详情页，单击白名单页签。
单击新增IP白名单分组，或在已有白名单分组的配置入口中，将您的客户端公网IP添加到白名单。
您也可以在Squad详情页的使用流程引导区域中，直接单击自动添加本机IP按钮，自动识别并添加当前客户端的公网IP地址。
登录Squad Console
完成公网地址申请和白名单配置后，您可以按以下方式登录Squad Console下发任务。
在Squad详情页的基本信息页签中，找到连接管理区域，获取前端（frontend）的公网IP和端口。
在浏览器中输入
http://<公网IP>:<端口>打开Squad Console。在Squad Console中配置认证Token：进入设置 > API Token，输入您的自定义Token，保存后即可开始下发任务。
您也可以在Squad详情页的使用流程引导区域中，直接单击打开 PolarDB Agent Squad Console按钮快速访问。
配置Daemon
通过Daemon将您本地或云上的Agent运行环境连接到Squad。首先安装PAS CLI：
您也可以在Squad详情页的使用流程引导区域中，单击查看配置方式查看包含实际地址的配置命令。
若您需要由平台自动管理Daemon，则请忽略当前步骤，托管模式无需您手动配置。
curl -fsSL https://polar-squad-cli-hangzhou.oss-cn-hangzhou.aliyuncs.com/install.sh | bash安装完成后，根据网络环境选择以下方式之一连接Squad:
方式一：公网
适用于可访问公网的环境。在连接管理区域获取公网地址后执行：
pas setup self-host \ --server-url http://<公网IP>:<squad backend端口> \ --app-url http://<公网IP>:<frontend端口>方式二：VPC 私网
适用于VPC内网环境。在连接管理区域获取私网地址后执行：
pas login --server-url http://<私网地址> \ --token <您的Token> pas daemon start方式三：托管
由平台自动管理Daemon，您无需手动配置。
步骤三：初始化Squad工作区
登录Squad Console后，建议按以下顺序完成工作区初始化。该顺序有助于先打通执行链路，再逐步补齐流程、知识和自动化能力。
配置Skill。
支持手动导入Skill。
支持从运行时一键同步Skill。
支持配置外部SkillHub，一键批量查询、导入业务场景的Skill。
建议先导入团队常用的代码规范、发布流程、测试命令、故障诊断和代码评审规则。
配置Runtime。
Runtime可以是本机电脑，也可以是远端ECS。
在Squad Console中复制安装或启动命令，在目标机器上一键执行。
Runtime连通后，平台会识别可用的编码工具，并作为Agent的执行环境。
配置代码仓库。
添加所有需要由Agent参与开发的项目仓库。
建议同时明确默认分支、目标分支和仓库说明，便于Agent获取正确代码上下文。
配置Project。
创建项目，并关联对应代码仓库。
项目用于承载一组相关Issue，例如一个产品线、版本计划或专项治理任务。
配置Agent与Squad。
可以通过对话一键生成智能体，也可以在智能体页面创建各类智能体角色，例如Director、PM、PD、RD、QA、Reviewer。
为每个Agent配置运行时、模型、职责说明和可用Skill。
将多个Agent组成小队，由小队承接后续Issue。
配置Automation。
创建需要周期执行或事件触发的自动化任务。
为自动化任务指定执行Agent、运行规则、输入范围和输出要求。
常见任务包括外部事项同步、日志缺陷发现、稳定性巡检和交付后复盘。
配置Playbook。
可以通过对话一键生成剧本，也可在剧本页新建剧本、克隆已有剧本，或直接修改系统预置剧本。
剧本的核心配置包括完成标准、指派角色和执行阶段提示词。
Director会根据完成标准判断当前步骤是否通过、是否需要重试、是否需要回退或是否需要人工确认。
剧本的每个步骤可设置最大重试次数，用于处理外部环境异常、网络波动、测试不稳定等临时失败。
配置Knowledge。
如需让Agent在编码阶段使用企业知识，请先购买PolarDB知识库产品。
购买后可在Squad中一键接入知识库。
知识库可为编码阶段补充接口说明、架构设计、领域术语、故障手册和历史方案等上下文。
步骤四：使用Squad下发任务
Squad提供Squad Console和PAS CLI两种下发任务方式。Squad Console适合人工创建和观察Issue，PAS CLI适合外部系统集成和自动化下发。
（推荐）通过对话新建Issue
进入Squad Console。
单击对话。
与Squad Assistant对话描述您的需求，由助手协助您一键生成Issue。
通过Squad Console新建Issue
进入Squad Console。
单击新建Issue。
填写需求标题、需求描述、验收标准和必要附件。
选择对应的小队。
选择对应的项目。
选择剧本。如果希望系统先判断任务类型，可选择自动评估。
单击下发，Issue会进入小队执行流程。
在Issue页面查看执行时间线、Playbook阶段、Agent输出、人工评论、测试结果和交付证据。
若某个阶段失败，按剧本配置进入重试、回退或人工确认流程。
通过PAS CLI新建Issue
确认外部系统与Squad实例处于可访问的网络环境中。
在外部系统或自动化机器上安装并登录PAS CLI。
使用PAS CLI查询可用的工作区、项目、小队和剧本。
通过PAS CLI创建Issue，并携带需求标题、描述、项目、小队、剧本和外部系统链接等信息。
创建成功后，记录返回的Issue标识，用于外部系统回写和后续查询。
可通过PAS CLI查询Issue状态、运行记录和执行结果。
常用命令可通过以下方式查看：
pas --help
pas issue --help
pas issue create --help
pas issue list --help步骤五：查看交付结果与自进化复盘
在Issue页面查看需求完成状态、执行证据、测试结果和评审结论。
对需要复盘的需求，触发自进化复盘。
复盘任务会根据运行过程，给出可人工确认的优化建议。
优化建议可覆盖剧本阶段、完成标准、Agent提示词、Skill内容、自动化触发规则和证据链要求。
经人工确认后，将有效建议沉淀回Playbook、Skill、Rules或Knowledge，形成下一次交付的改进输入。
Squad管理页面说明
您可在PolarDB控制台的页面完成Squad的全生命周期管理。
Squad列表
在PolarDB Agent Squad页面，您可以查看当前地域下所有Squad的列表信息，包括Squad ID、状态、创建时间等。单击新建 PolarDB Agent Squad可跳转到购买页创建新的Squad。
Squad详情
单击Squad ID进入详情页，详情页包含以下功能模块：
页签 | 说明 |
基本信息 | 查看Squad的基本属性、使用流程引导、连接管理和Agent关系/拓扑信息。 |
配置 | 查看和修改Squad的应用参数，包括IM通道密钥（如钉钉、企业微信、飞书的Secret和Client ID）、后端服务配置（认证开关、自动登录等）和应用ID等。 |
白名单 | 配置IP白名单和安全组规则，控制对Squad的访问权限。 |
Agent 关系/拓扑
在基本信息页签的Agent 关系/拓扑区域，您可以查看和管理Squad中的Agent。Agent按类型分组展示，每个Agent包含以下信息：
列名 | 说明 |
Agent 名称 | Agent的名称标识。 |
Agent 类型/来源 | Agent的来源类型，例如PolarDB Agent Express或自定义Agent。 |
绑定状态 | Agent与Squad的绑定状态，包括：
|
绑定Agent
在Agent 关系/拓扑区域，找到状态为未绑定的Agent，单击操作列的绑定。在弹出的对话框中输入Agent的Token，单击确定完成绑定。
解绑Agent
对于状态为已绑定的Agent，单击操作列的解绑，在确认对话框中单击确定即可解除绑定。