Azure DevOps自托管代理授权异常：无法找到v1Agent池

针对你遇到的「找不到名为v1Agent的代理池」报错，按以下步骤排查修复：

1. 区分代理名称与代理池名称 #

你可能混淆了代理名称和代理池名称：

• 自托管代理（v1Agent）是隶属于某个代理池的实例，而非池本身。
• 登录Azure DevOps，进入「组织设置」→「代理池」，找到你的v1Agent代理，查看它所属的代理池名称（比如默认的Default池，或是你自定义的池名）。

2. 修正YAML中的池配置 #

将流水线YAML里的pool: v1Agent替换为代理实际所属的池名称，示例：

trigger:
- main

# 替换为代理所属的池名称，比如Default
pool: Default

variables:
solution: '**/*.sln'
buildPlatform: 'Any CPU'
buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package 
                  /p:PackageAsSingleFile=true 
                  /p:SkipInvalidConfigurations=true 
                  /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

3. 验证项目对代理池的访问权限 #

如果使用自定义代理池，需确保流水线所在项目拥有该池的使用权限：

• 进入「组织设置」→「代理池」，选中目标池→点击「安全」标签。
• 确认你的项目名称（或项目级别的用户/组）已被添加，且拥有「使用」权限。

内容的提问来源于stack exchange，提问作者Stier Máté