提交.NET构建后显示“等待可用代理”，如何查看作业所需能力？

别担心，我帮你梳理几个直接的方法，能快速找出你的.NET构建作业到底需要哪些代理能力，以及新服务器缺了啥：

1. 直接查看构建管道的明确代理需求 #

打开你的构建管道，进入编辑模式：

• 切换到「选项」标签页，往下滚动找到「代理需求」板块
• 这里会列出作业明确要求的所有capabilities，比如特定版本的DotNetFramework、Agent.OS（Windows/Linux/macOS）、甚至自定义的能力标识
• 如果是多阶段管道，记得每个阶段的代理需求可能不一样，要逐个检查

2. 从等待的构建作业中查看不匹配详情 #

这是最直观的方式：

• 回到卡在「Waiting for an available agent」的构建运行页面，点击那个处于等待状态的作业
• 页面会展开显示未找到匹配代理的具体原因，里面会完整列出作业需要的所有capabilities，同时对比当前队列里的代理，告诉你哪几项不匹配——直接就能定位问题

3. 检查构建任务隐含的需求 #

有些任务（比如.NET构建任务）会自动添加隐含的capabilities需求，不需要手动配置：

• 编辑构建管道，点击对应的.NET构建任务
• 查看任务的「高级」或者「需求」设置（不同任务位置可能略有不同），这里会显示任务自动注入的需求，比如特定版本的MSBuild、DotNetCore运行时等

4. 对比新代理的已注册Capabilities #

确认了作业需求后，再核对新服务器代理的实际能力：

• 进入项目设置 → 代理池 → 找到你的目标队列 → 点击新添加的代理
• 在代理详情页切换到「Capabilities」标签，这里会列出代理上自动检测到的所有组件（比如已安装的.NET版本、操作系统版本、MSBuild路径等），以及手动添加的自定义能力
• 把这个列表和前面找到的作业需求逐一对比，就能快速找出缺少的组件

小提示 #

如果你的作业用到了自定义的capabilities（比如手动添加的环境变量作为能力标识），记得在新代理上手动配置对应的capabilities，或者确保代理上的环境变量、组件版本符合要求。

内容的提问来源于stack exchange，提问作者Pat Delaney