desplega-ai/Run Argus Session
Run an Argus agent session against a target URL and post the report as a PR comment.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| scenario | Scenario identifier. Used for sticky-comment marker and to look up a scenario file under .github/argus-scenarios/<scenario>.md. Optional — defaults to "argus". When no scenario file, prompt_template, or prompt_template_file is provided, the built-in DEFAULT_PROMPT is used. | no | argus |
| prompt_template | Inline prompt body. When set, overrides prompt_template_file and scenario file lookup. Supports ${VAR} substitution. | no | "" |
| prompt_template_file | Path (relative to the workspace) to a prompt template file. Used when prompt_template is empty. | no | "" |
| base_url | Target URL the agent will exercise. Substituted as ${BASE_URL} in the prompt. | yes | — |
| argus_base_url | Argus backend base URL. | no | https://api.desplega.ai |
| ui_base_url | UI base URL used for session links in the PR comment. | no | https://app.desplega.ai |
| extra_vars | JSON object of additional ${VAR} values merged over the built-ins. | no | {} |
| wait_mode | poll (stream + poll outcome) or no (fire-and-forget). | no | poll |
| timeout_s | Local wall-clock budget (seconds) for stream tail + outcome poll fallback when agent_end is not observed. | no | 900 |
| fail_on | failed (default) fails the job on non-pass outcome; never keeps the job green. | no | failed |
| comment_on_pr | When true, upserts a sticky PR comment with the agent report. | no | true |
| comment_key | Optional discriminator appended to the sticky-comment marker. Use when the same scenario runs against multiple base_urls on one PR. | no | "" |
| github_token | Token used to post the PR comment. Requires pull-requests: write. | no | ${{ github.token }} |
Outputs
| name | description |
|---|---|
| session_id | Argus session id. |
| instance_id | Argus instance id. |
| poll_url | Full URL for polling the session outcome. |
| outcome_status | Terminal outcome status (completed | aborted | failed | error | timed_out), or empty for wait_mode=no. |
| comment_url | URL of the upserted PR comment, or empty when no comment was posted. |