Smoke Test Voice

1# Smoke-test a deployed Microsoft Foundry Voice Agent.
2#
3# Usage:
4#   .\foundry-agent\create\scripts\smoke-test-voice.ps1 `
5#     -Endpoint <project-endpoint> `
6#     -AgentName <voice-agent-name> `
7#     [-Text <prompt-text>] `
8#     [-ExpectedMarker <substring>] `
9#     [-Timeout <seconds>] `
10#     [-OutputAudio <file-path>] `
11#     [-DryRun] `
12#     [-Help]
13#
14# Exit Codes:
15#   0  Smoke test passed (or -Help / -DryRun succeeded)
16#   1  Python, dependency, authentication, WebSocket, or response failure
17#   2  Usage or argument validation error
18
19param(
20    [string]$Endpoint = "",
21    [string]$AgentName = "",
22    [string]$Text = "In one short sentence, introduce yourself.",
23    [string]$ExpectedMarker = "",
24    [string]$Timeout = "180",
25    [string]$OutputAudio = "",
26    [switch]$DryRun,
27    [switch]$Help,
28    [Parameter(ValueFromRemainingArguments = $true)]
29    [string[]]$RemainingArgs
30)
31
32function Show-Usage {
33    $lines = Get-Content -LiteralPath $PSCommandPath | Select-Object -First 18
34    foreach ($line in $lines) {
35        if ($line -match '^#\s?(.*)$') {
36            Write-Output $Matches[1]
37        }
38    }
39}
40
41if ($Help) {
42    Show-Usage
43    exit 0
44}
45
46if ($null -ne $RemainingArgs -and $RemainingArgs.Count -gt 0) {
47    Write-Error "ERROR: Unknown argument(s): $($RemainingArgs -join ' ')"
48    Show-Usage
49    exit 2
50}
51
52if ([string]::IsNullOrWhiteSpace($Endpoint)) {
53    Write-Error "ERROR: -Endpoint is required."
54    Show-Usage
55    exit 2
56}
57
58if ([string]::IsNullOrWhiteSpace($AgentName)) {
59    Write-Error "ERROR: -AgentName is required."
60    Show-Usage
61    exit 2
62}
63
64if ([string]::IsNullOrWhiteSpace($Text)) {
65    Write-Error "ERROR: -Text must not be empty."
66    Show-Usage
67    exit 2
68}
69
70if ($Timeout -notmatch '^[1-9][0-9]*$') {
71    Write-Error "ERROR: -Timeout must be a positive integer (got '$Timeout')."
72    exit 2
73}
74
75$pythonCmd = $null
76if (Get-Command python3 -ErrorAction SilentlyContinue) {
77    $pythonCmd = "python3"
78} elseif (Get-Command python -ErrorAction SilentlyContinue) {
79    $pythonCmd = "python"
80} else {
81    Write-Error "ERROR: Python 3 is required to run the Voice WebSocket smoke test."
82    exit 1
83}
84
85$pythonScript = Join-Path $PSScriptRoot "smoke_test_voice.py"
86$arguments = @(
87    $pythonScript,
88    "--endpoint", $Endpoint,
89    "--agent-name", $AgentName,
90    "--text", $Text,
91    "--timeout", $Timeout
92)
93
94if (-not [string]::IsNullOrWhiteSpace($ExpectedMarker)) {
95    $arguments += @("--expected-marker", $ExpectedMarker)
96}
97if (-not [string]::IsNullOrWhiteSpace($OutputAudio)) {
98    $arguments += @("--output-audio", $OutputAudio)
99}
100if ($DryRun) {
101    $arguments += "--dry-run"
102}
103
104& $pythonCmd @arguments
105if ($LASTEXITCODE -ne 0) {
106    exit $LASTEXITCODE
107}
108exit 0