Skip to content

Commit bd2134b

Browse files
github-actions[bot]Copilotpelikhan
authored
workshop docs: add gh-aw doc links (batch 2) (#1728)
- 05-agentic-workflows-intro.md: link tools, frontmatter, triggers, permissions, Lock file, Engine - 06-install-gh-aw.md: link agentic workflow, lock file - 06a-install-terminal.md: link agentic workflow - 06b-install-local.md: link agentic workflow - 04-github-actions-intro.md: link tools Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Peli de Halleux <pelikhan@users.noreply.github.com>
1 parent f929a02 commit bd2134b

5 files changed

Lines changed: 7 additions & 7 deletions

File tree

β€Žworkshop/04-github-actions-intro.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ If you already know Actions, here's the key shift at a glance:
2727
|-----------|-----------------|-------------------|
2828
| **Task description** | You write YAML `steps` | You write a plain-English brief |
2929
| **Execution model** | Deterministic β€” same inputs, same path | AI agent reasons and adapts at runtime |
30-
| **Tool selection** | Fixed β€” you specify every `uses` and `run` | Agent selects and chains tools from declared toolsets |
30+
| **Tool selection** | Fixed β€” you specify every `uses` and `run` | Agent selects and chains [tools](https://github.github.com/gh-aw/reference/tools/) from declared toolsets |
3131
| **File format** | `.github/workflows/*.yml` | `.github/workflows/*.md` (compiled to `.lock.yml`) |
3232

3333
## Quick Refresher

β€Žworkshop/05-agentic-workflows-intro.mdβ€Ž

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ If both apply, [Skip to Install gh-aw](06-install-gh-aw.md).
1515

1616
- You've read [What Are GitHub Actions?](04-github-actions-intro.md)
1717

18-
An [**Agentic Workflow**](https://github.github.com/gh-aw/introduction/overview/) is a plain-English task brief that an AI agent executes inside GitHub Actions. You write what you want β€” "summarize open issues and post a daily digest" β€” and the agent reads your repo, calls tools, reasons about the results, and posts the output automatically. The frontmatter is fully Actions-compatible β€” triggers, permissions, and runners all apply.
18+
An [**Agentic Workflow**](https://github.github.com/gh-aw/introduction/overview/) is a plain-English task brief that an AI agent executes inside GitHub Actions. You write what you want β€” "summarize open issues and post a daily digest" β€” and the agent reads your repo, calls [tools](https://github.github.com/gh-aw/reference/tools/), reasons about the results, and posts the output automatically. The [frontmatter](https://github.github.com/gh-aw/reference/frontmatter/) is fully Actions-compatible β€” [triggers](https://github.github.com/gh-aw/reference/triggers/), [permissions](https://github.github.com/gh-aw/reference/permissions/), and runners all apply.
1919

2020
![Animated GitHub Actions run showing four security jobs: activation validates the agent is authorized to run, agent runs with sandbox, firewall, and integrity filter enabled, detection scans for malicious code, and safe-outputs applies changes within guardrails](images/05-agent-run-log.svg)
2121

@@ -139,8 +139,8 @@ Before you reveal the answers below, write a one-sentence definition for each te
139139
| Term | Plain-language meaning |
140140
|---|---|
141141
| Agentic workflow | A GitHub Actions workflow that uses an AI model to reason and act |
142-
| Lock file | The compiled YAML that GitHub Actions actually runs |
143-
| Engine | The AI model provider (for example, GitHub Copilot) used by the workflow |
142+
| [Lock file](https://github.github.com/gh-aw/reference/glossary/#workflow-lock-file-lockyml) | The compiled YAML that GitHub Actions actually runs |
143+
| [Engine](https://github.github.com/gh-aw/reference/engines/) | The AI model provider (for example, GitHub Copilot) used by the workflow |
144144
| `workflow_dispatch` | A manual trigger β€” you start the run by clicking a button in the Actions tab |
145145

146146
Confirm each:

β€Žworkshop/06-install-gh-aw.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<!-- learning: false -->
44
# Install the gh-aw CLI Extension
55

6-
`gh-aw` is the CLI extension that compiles your agentic workflow Markdown files and triggers runs from your terminal. If you're on the GitHub UI path, no local installation is needed: an agent compiles the workflow, and GitHub Actions executes the committed lock file.
6+
`gh-aw` is the CLI extension that compiles your [agentic workflow](https://github.github.com/gh-aw/introduction/overview/) Markdown files and triggers runs from your terminal. If you're on the GitHub UI path, no local installation is needed: an agent compiles the workflow, and GitHub Actions executes the committed [lock file](https://github.github.com/gh-aw/reference/glossary/#workflow-lock-file-lockyml).
77

88
## πŸ“‹ Before You Start
99

β€Žworkshop/06a-install-terminal.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
88
## 🎯 What You'll Do
99

10-
You'll verify the `gh` CLI is authenticated, install the `gh-aw` extension, and run one quick diagnostic to confirm your Codespace terminal is ready for agentic workflow setup.
10+
You'll verify the `gh` CLI is authenticated, install the `gh-aw` extension, and run one quick diagnostic to confirm your Codespace terminal is ready for [agentic workflow](https://github.github.com/gh-aw/introduction/overview/) setup.
1111

1212
## πŸ“‹ Before You Start
1313

β€Žworkshop/06b-install-local.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
88
## 🎯 What You'll Do
99

10-
You'll verify the `gh` CLI is authenticated, install the `gh-aw` extension, and run one quick diagnostic to confirm your local terminal is ready for agentic workflow setup.
10+
You'll verify the `gh` CLI is authenticated, install the `gh-aw` extension, and run one quick diagnostic to confirm your local terminal is ready for [agentic workflow](https://github.github.com/gh-aw/introduction/overview/) setup.
1111

1212
## πŸ“‹ Before You Start
1313

0 commit comments

Comments
Β (0)