Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion workshop/04-github-actions-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ If you already know Actions, here's the key shift at a glance:
|-----------|-----------------|-------------------|
| **Task description** | You write YAML `steps` | You write a plain-English brief |
| **Execution model** | Deterministic — same inputs, same path | AI agent reasons and adapts at runtime |
| **Tool selection** | Fixed — you specify every `uses` and `run` | Agent selects and chains tools from declared toolsets |
| **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 |
| **File format** | `.github/workflows/*.yml` | `.github/workflows/*.md` (compiled to `.lock.yml`) |

## Quick Refresher
Expand Down
6 changes: 3 additions & 3 deletions workshop/05-agentic-workflows-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ If both apply, [Skip to Install gh-aw](06-install-gh-aw.md).

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

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.
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.

![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)

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

Confirm each:
Expand Down
2 changes: 1 addition & 1 deletion workshop/06-install-gh-aw.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<!-- learning: false -->
# Install the gh-aw CLI Extension

`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.
`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).

## 📋 Before You Start

Expand Down
2 changes: 1 addition & 1 deletion workshop/06a-install-terminal.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

## 🎯 What You'll Do

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.
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.

## 📋 Before You Start

Expand Down
2 changes: 1 addition & 1 deletion workshop/06b-install-local.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

## 🎯 What You'll Do

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.
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.

## 📋 Before You Start

Expand Down
Loading