Skip to content

Commit 4be7ab2

Browse files
docs: add parameters step to workflow creation prompt (#491)
1 parent 5a99824 commit 4be7ab2

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

prompts/create-ado-agentic-workflow.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -443,6 +443,38 @@ network:
443443

444444
The built-in allowlist includes: Azure DevOps, GitHub, Microsoft identity, Azure services, Application Insights, and MCP-specific endpoints for each enabled server.
445445

446+
### Step 15 — Parameters (optional)
447+
448+
ADO runtime parameters are surfaced in the pipeline queue UI when a user manually runs the pipeline. Use them to expose configuration knobs (e.g., target region, log verbosity, feature flags) without hardcoding values.
449+
450+
```yaml
451+
parameters:
452+
- name: targetRegion
453+
displayName: "Target region"
454+
type: string
455+
default: "us-east"
456+
values:
457+
- us-east
458+
- eu-west
459+
- ap-south
460+
- name: verbose
461+
displayName: "Verbose output"
462+
type: boolean
463+
default: false
464+
```
465+
466+
| Field | Required | Description |
467+
|-------|----------|-------------|
468+
| `name` | Yes | Parameter identifier (referenced as `${{ parameters.name }}` in steps) |
469+
| `displayName` | No | Human-readable label in the ADO queue UI |
470+
| `type` | No | ADO parameter type: `boolean`, `string`, `number`, `object` |
471+
| `default` | No | Default value when not specified at queue time |
472+
| `values` | No | Allowed values for `string`/`number` parameters (shows a dropdown in the UI) |
473+
474+
> **Auto-injected `clearMemory` parameter**: When `tools.cache-memory` is configured, the compiler automatically injects a `clearMemory: boolean` parameter (default: `false`) at the start of the parameters list. It lets users clear the agent's persisted memory from the ADO UI without editing the source. Defining your own `clearMemory` parameter suppresses the auto-injected one.
475+
476+
Omit `parameters:` if no runtime configuration knobs are needed.
477+
446478
---
447479

448480
## Agent Instruction Body

0 commit comments

Comments
 (0)