diff --git a/workshop/04-github-actions-intro.md b/workshop/04-github-actions-intro.md index 929e89b0..da589e1a 100644 --- a/workshop/04-github-actions-intro.md +++ b/workshop/04-github-actions-intro.md @@ -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 diff --git a/workshop/05-agentic-workflows-intro.md b/workshop/05-agentic-workflows-intro.md index fdfc8faa..a10117f0 100644 --- a/workshop/05-agentic-workflows-intro.md +++ b/workshop/05-agentic-workflows-intro.md @@ -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) @@ -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: diff --git a/workshop/06-install-gh-aw.md b/workshop/06-install-gh-aw.md index dc76539b..a59a0b6d 100644 --- a/workshop/06-install-gh-aw.md +++ b/workshop/06-install-gh-aw.md @@ -3,7 +3,7 @@ # 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 diff --git a/workshop/06a-install-terminal.md b/workshop/06a-install-terminal.md index 5f701042..5f41a5e1 100644 --- a/workshop/06a-install-terminal.md +++ b/workshop/06a-install-terminal.md @@ -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 diff --git a/workshop/06b-install-local.md b/workshop/06b-install-local.md index f98000a1..569d6f94 100644 --- a/workshop/06b-install-local.md +++ b/workshop/06b-install-local.md @@ -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