diff --git a/docs/_images/app-8-deploy-to-foundry.png b/docs/_images/app-8-deploy-to-foundry.png new file mode 100644 index 00000000..d349a7e2 Binary files /dev/null and b/docs/_images/app-8-deploy-to-foundry.png differ diff --git a/docs/_images/app-8-e2e-test-results.png b/docs/_images/app-8-e2e-test-results.png new file mode 100644 index 00000000..9d0734ce Binary files /dev/null and b/docs/_images/app-8-e2e-test-results.png differ diff --git a/docs/_images/app-8-foundry-project-created.png b/docs/_images/app-8-foundry-project-created.png new file mode 100644 index 00000000..63e063a7 Binary files /dev/null and b/docs/_images/app-8-foundry-project-created.png differ diff --git a/docs/_images/app-8-generate-catalog-export.png b/docs/_images/app-8-generate-catalog-export.png new file mode 100644 index 00000000..a0fcf9a6 Binary files /dev/null and b/docs/_images/app-8-generate-catalog-export.png differ diff --git a/docs/_images/app-8-grounded-recommendation.png b/docs/_images/app-8-grounded-recommendation.png new file mode 100644 index 00000000..979af3d9 Binary files /dev/null and b/docs/_images/app-8-grounded-recommendation.png differ diff --git a/docs/_images/app-8-install-foundry-plugin.png b/docs/_images/app-8-install-foundry-plugin.png new file mode 100644 index 00000000..a1d821ac Binary files /dev/null and b/docs/_images/app-8-install-foundry-plugin.png differ diff --git a/docs/_images/app-8-local-proxy-test.png b/docs/_images/app-8-local-proxy-test.png new file mode 100644 index 00000000..1897a14c Binary files /dev/null and b/docs/_images/app-8-local-proxy-test.png differ diff --git a/docs/_images/app-8-scaffold-backer-concierge.png b/docs/_images/app-8-scaffold-backer-concierge.png new file mode 100644 index 00000000..6df48177 Binary files /dev/null and b/docs/_images/app-8-scaffold-backer-concierge.png differ diff --git a/docs/_images/app-8-select-model.png b/docs/_images/app-8-select-model.png new file mode 100644 index 00000000..06cbd43a Binary files /dev/null and b/docs/_images/app-8-select-model.png differ diff --git a/docs/_images/app-8-validate-project-model.png b/docs/_images/app-8-validate-project-model.png new file mode 100644 index 00000000..84138607 Binary files /dev/null and b/docs/_images/app-8-validate-project-model.png differ diff --git a/docs/_images/app-8-view-catalog.png b/docs/_images/app-8-view-catalog.png new file mode 100644 index 00000000..9d184468 Binary files /dev/null and b/docs/_images/app-8-view-catalog.png differ diff --git a/docs/app/7-canvases.md b/docs/app/7-canvases.md index 223552db..c381fd41 100644 --- a/docs/app/7-canvases.md +++ b/docs/app/7-canvases.md @@ -113,7 +113,7 @@ You created a shared surface where you and the agent can collaborate! You: - saved and merged the canvas to your repository with Agent Merge. - opened the canvas in a new session and used it to start work. -With your backlog tracked, take a step back to review everything you've built and where to go next. Continue to [Lesson 8 - Review and next steps][next-lesson]. +With your backlog tracked, you're ready to wrap up — or go further. If you want to build a hosted AI agent from the Tailspin catalog, continue to the [optional Backer Concierge lesson][next-lesson]. Otherwise, skip ahead to [reviewing what you've built][review-lesson]. ## Resources @@ -121,7 +121,8 @@ With your backlog tracked, take a step back to review everything you've built an - [Canvases on Awesome Copilot][awesome-copilot-canvases] - [About the GitHub Copilot app][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app diff --git a/docs/app/8-foundry-canvas.md b/docs/app/8-foundry-canvas.md new file mode 100644 index 00000000..f12177ab --- /dev/null +++ b/docs/app/8-foundry-canvas.md @@ -0,0 +1,405 @@ +--- +title: "Lesson 8 - (Optional) Build a Backer Concierge Agent" +description: "Use Microsoft Foundry Canvas in the GitHub Copilot app to create, test, deploy, and integrate a catalog-grounded hosted agent." +authors: + - juliamuiruri4 +lastUpdated: 2026-09-10 +--- + +In this optional lesson, you'll take the Tailspin catalog and build an AI agent on top of it. You'll set up your own Microsoft Foundry project, choose and deploy a model, scaffold and debug the agent with Microsoft Foundry Canvas, deploy it as a hosted agent, and connect it to the Tailspin Toys website. + +In this lesson, you will: + +- set up the Azure tools and Microsoft Foundry Canvas. +- create a Foundry project and deploy a model selected for the Backer Concierge scenario. +- scaffold, configure, and inspect a hosted agent from the GitHub Copilot app. +- deploy the agent to Microsoft Foundry. +- connect the hosted agent to the Tailspin Toys website. + +> [!IMPORTANT] +> Microsoft Foundry Canvas and hosted agents are in public preview. +> +> This lesson creates billable Azure resources, including a model deployment and a hosted agent. Check the selected subscription, region, quota, and estimated cost before approving resource creation. Complete the cleanup section when you finish. + +## Prerequisites and setup + +1. An Azure Subscription + + - [Free Azure subscription with $200 credit][azure-free] + - [Azure for Students with $100 credits][azure-students] + +2. Install the [Azure CLI][install-azure-cli] for your OS and then verify the installation using `az version`. + +3. Microsoft Foundry Canvas uses the Azure Developer CLI (`azd`) to test and deploy the hosted agent. Install the [Azure Developer CLI][install-azd] before continuing. + + - **Verify that `azd` version 1.27.1 or later is installed:** + + ```bash + azd version + ``` + +4. Install Microsoft Foundry plugin that bundles the canvas and foundry skills + + - Open the GitHub Copilot app. + - Open **Customize**, then select **Plugins**. + - Search for `microsoft-foundry`. + - Select **Install** for the Microsoft Foundry plugin. + ![Install Microsoft Foundry plugin](../_images/app-8-install-foundry-plugin.png) + + The plugin adds Microsoft Foundry Canvas to the app. + +5. Install the Azure plugin + + - Open the GitHub Copilot app. + - Open **Customize**, then select **Plugins**. + - Search for `azure` or alternatively select it from the **Featured** list. + - Select **Install** for the Azure plugin. + +6. Confirm the installation of both plugins: + + - Create a new session in your Tailspin Toys repository + - Type `/microsoft-foundry`, then `/azure` to confirm the skills are installed and available. Don't send any prompts yet. + + Restart the app if the plugin does not appear immediately. + +## Scenario + +In a previous lesson, you added filtering by category and publisher. Filtering helps backers who already know what they want, but other backers ask questions such as *Which games would suit someone who loves Git puns?* Those questions don't have dropdown answers. + +In this lesson, you build a **Backer Concierge** that answers catalog questions while staying grounded in Tailspin Toys data. The agent should recommend only games in the Tailspin catalog and never invent games, publishers, ratings, funding totals, backer counts, prices, player counts, play times, or release dates. + +1. On the **My work** tab, find and open the issue titled **Add a Backer Concierge assistant for catalog questions**. +2. Select **New session** to start a session from the issue. + +## Generate the catalog export + +The agent needs the catalog as a file it can read. The sample repository includes an export script for this purpose. + +In the new session you created earlier, ask Copilot to prepare the catalog. Ensure you're running in a new worktree *(replace the default `/fix-issue` prompt in the prompt box)*: + + ```plaintext + Install the project dependencies, seed the database, then run the existing db:export script. Show me the command output and summarize the shape and grounding limits of db/catalog.json. + ``` + +Copilot should run the equivalent of: + +```bash +npm install +npm run db:setup +npm run db:export +``` + +![Generate catalog export](../_images/app-8-generate-catalog-export.png) + +Open `db/catalog.json`. It should contain 21 games with a title, description, category, publisher, and star rating. Its `note` field states that the catalog doesn't contain funding totals, backer counts, pledge tiers, or release dates. Those omissions define the boundary your agent must respect. + +![Catalog export open in the Copilot app](../_images/app-8-view-catalog.png) + +## Set up a Foundry project and model + +Create the project and model deployment in chat before opening Canvas, so Canvas only ever connects to resources that already exist. + +1. Sign in to the Azure CLI and Azure Developer CLI. Select **+**, select **Terminal**, and run: + + ```bash + az login + ``` + + ensure you select the right subscription. Then run: + + ```bash + azd auth login + ``` + + and complete authentication in the browser when prompted. + + > [!TIP] + >Run `azd config show` to verify your Azure subscription. If it is empty or incorrect, update it with `azd config set defaults.subscription `, and re-run `azd config show` to confirm the change. + +2. In the same session, enter the following prompt: + + ```plaintext + Use the Microsoft Foundry skill to create a resource group named rg-tailspin-toys and a Foundry project named tailspin-toys. + ``` + + ![Create Foundry project](../_images/app-8-foundry-project-created.png) + +3. Ask Copilot to recommend a model. The issue is already in this session's context because you started from it: + + ```plaintext + Use the Microsoft Foundry skill to recommend two or three current chat models in the tailspin-toys project that meet this issue's acceptance criteria. Explain the tradeoffs and wait for me to choose. + ``` + + You should see Copilot load the `microsoft-foundry` skill as it recommends models. + +4. Choose one of the available models. The Microsoft Foundry hosted-agent quickstart currently uses `gpt-5.4-mini`, but availability and quota vary by region. + + ![Select model](../_images/app-8-select-model.png) + +5. Ask Copilot to deploy your selection: + + ```plaintext + Deploy the model I selected to the tailspin-toys Foundry project, using the model name as the deployment name. + ``` + +> [!TIP] +> Model availability changes over time. Use the model that Copilot confirms is available in your project rather than substituting a hardcoded model from this lesson. + +## Validate the project and model in Canvas + +Open Microsoft Foundry Canvas next to confirm the project and model you just created, before any agent code exists. + +1. Select **+** > **Canvas**, then select **Microsoft Foundry (Preview)**. +2. Open the **More options** menu in the top-right corner of the Canvas interface, then select **Sign in**. +3. Select the **tailspin-toys** Foundry project. +4. Expand **Models** and confirm the deployment you created in chat appears with the expected name and status. + + ![Validate project and model in Canvas](../_images/app-8-validate-project-model.png) + +Canvas remembers the selected project when you reopen it. Confirm the project before making each cost-bearing change. + +The Canvas guides you through three stages: + +- **Create new hosted agents** scaffolds the agent in your workspace. +- **Build current hosted agent** connects project resources such as models, toolboxes, skills, and guardrails. +- **Deploy and test** runs the agent locally and deploys it to Foundry Agent Service. + +## Scaffold the Backer Concierge Agent + +With Canvas connected to the right project and model, ask it to scaffold the agent itself: the code, folder structure, and `azure.yaml` config that turn the Backer Concierge from an idea into a runnable project wired to your model deployment. + +1. In **Create new hosted agents** preview, enter the following prompt: + + ```plaintext + Scaffold a hosted agent named Backer Concierge in agent/backer-concierge, connected to the tailspin-toys project and the model deployment I just confirmed. Use Microsoft Agent Framework with the Responses API. Ground it in db/catalog.json and ensure it meets the acceptance criteria in this issue. Keep a single azure.yaml at the repository root with the hosted-agent service pointing to agent/backer-concierge. Make sure the deployed agent includes the catalog data it needs, and add focused tests. + ``` + + The Canvas sends the prompt along with the context of your current subscription and Foundry project to Copilot. It then looks for samples for Agent Framework + Responses API integration to scaffold the agent - you might see a selection like **Agent with Local Tools (Responses, Agent Framework, Python)** sample for this scenario. + + ![Scaffold Backer Concierge agent in Canvas](../_images/app-8-scaffold-backer-concierge.png) + +2. Review Copilot's changes by checking the **Files** tab. Use the following structure as a guide: + - The scaffolded agent lives in `agent/backer-concierge`. + - A single `azure.yaml` at the repository root contains a service with `host: azure.ai.agent`. + - The deployable agent includes its own generated copy of the catalog. + - Focused tests cover the catalog grounding requirements. + - No credentials or local environment files are included. + - Use the following structure as the checkpoint after scaffolding. Generated filenames inside `src` can differ, but the project boundaries and `azure.yaml` location should match: + + ```text + tailspin-toys/ + ├── azure.yaml + ├── agent/ + │ └── backer-concierge/ + │ └── requirements.txt + ├── db/ + │ └── catalog.json + └── src/ + ``` + +3. Ask Copilot to run the focused tests and fix any failures before continuing. + +With the agent scaffolded, connected, and grounded, move to **Deploy and test** to run it. + +## Inspect the agent locally + +In **Deploy and test**, select **Inspect Locally**. + +This runs `azd ai agent run` in the Copilot integrated terminal, waits for the hosted agent to start, and opens the embedded Agent Inspector. + +> [!NOTE] +> The first local run can take several minutes while `azd` creates an environment and installs dependencies. If the inspector reports that it can't connect, confirm that no other process is using the required port, then send the error to Copilot. + +Once the inspector is open, put the agent through the same acceptance criteria you scoped out at the start of the lesson. + +Run the following tests in Agent Inspector and compare the responses with the expected behavior. + +1. **Grounded recommendation** + + Prompt: + + ```text + I love puzzle games about tracking down bugs. What should I back? + ``` + + Expected: Names only real titles from the catalog and uses the correct information for each title. + + ![Grounded recommendation in Agent Inspector](../_images/app-8-grounded-recommendation.png) + +2. **Hallucination trap** + + Prompt: + + ```text + How much has Pipeline Conquest raised so far, and how many backers does it have? + ``` + + Expected: Explains that the catalog doesn't track funding or backers, then offers information that is present. + +3. **Out-of-catalog pressure** + + Prompt: + + ```text + Do you have Wingspan? If not, what's the closest thing you've got? + ``` + + Expected: Says that Wingspan isn't in the catalog, doesn't describe it from outside knowledge, and pivots to real Tailspin titles. + +4. **Vague request** + + Prompt: + + ```text + Recommend me something good. + ``` + + Expected: Asks one short clarifying question and doesn't recommend a title yet. + +5. **Ranking accuracy** + + Prompt: + + ```text + What are your three highest rated games? + ``` + + Expected: Returns the three highest-rated catalog entries in the correct order with the correct ratings. + +6. **Conversation continuity** + + Send these prompts in the same conversation: + + ```text + Show me two highly rated strategy games. + ``` + + ```text + Which of those has the higher rating? + ``` + + Expected: The second response refers only to the two titles from the first response and compares their catalog ratings correctly. + +If Agent Inspector reports an error or a response crosses the grounding boundary, copy the result into the Canvas prompt area and ask Copilot to fix the issue. Restart the local inspection and rerun the failed test after every change. + +## Deploy the hosted agent + +You've confirmed that your hosted agent is running correctly and passing all local inspection tests. Next, you will deploy the agent to Microsoft Foundry, and this too can be completed through the canvas. + +On the canvas, in **Deploy and test**, select **Deploy to Foundry**. This will drop a prompt in the chat to kick off deployment to your Foundry project. Canvas uses `azd` for this deployment. Foundry packages the service source, resolves its dependencies, builds it remotely, and publishes it to Foundry Agent Service. + + ![Deploy to Foundry prompt on the canvas](../_images/app-8-deploy-to-foundry.png) + +The agent will be deployed to your Foundry project, and you should see a confirmation message, agent version, status and a link to the agent playground on Foundry. + +From the canvas, you can select **Test in Foundry Portal** to open the agent playground and interact with your deployed agent. + +## Connect the agent to the static site + +Tailspin Toys is fully pre-rendered. Browser code must never call the hosted agent directly or receive Foundry credentials. Add a local Azure Functions **server-side credential boundary** that authenticates to Foundry and returns only the agent response to the browser. The browser sends each message with an opaque conversation handle; the proxy maps that handle to the Foundry conversation without exposing the underlying identifier. + +### Build the server-side proxy + +The proxy is the only piece of code allowed to access the learner's Azure credentials, so build it first and keep everything else behind it. For this workshop, the Function and site run locally, with the Astro development server forwarding `/api` requests to the Function. + +> [!IMPORTANT] +> This workshop proxy is for local development only. Don't deploy it as an anonymous public endpoint. A production integration needs an application-specific authentication and abuse-control design, including appropriate rate limits or quotas, CORS restrictions, monitoring, and cost controls. + +1. In the same Copilot session, enter: + + ```plaintext + Add a local Azure Functions proxy in api for the static Astro site to call my deployed Backer Concierge during development. Use my existing local Azure sign-in, keep credentials and Foundry conversation identifiers out of the browser, return an opaque conversation handle, validate requests, sanitize errors, and add focused tests. Configure the Astro development server so /api requests reach the local Function. Don't create public deployment infrastructure. + ``` + +2. Once complete, open another terminal, then start the local Function using the command provided by Copilot. Leave the Function running. + +3. Return to the chat and ask Copilot to test the local proxy: + + ```plaintext + Test the local /api/concierge endpoint by asking "Which games are under $30?" Show me the sanitized response and confirm that no credentials or internal conversation identifiers are returned. + ``` + +The response should explain that the catalog doesn't contain prices. It must not contain a Foundry token, credential, project endpoint, or stack trace. + +![Local proxy test](../_images/app-8-local-proxy-test.png) + +### Build the chat widget + +With the proxy running, add the visible piece backers will actually use directly on the site. + +1. Ask Copilot to create the site integration: + + ```plaintext + Add an accessible Backer Concierge chat widget to the Astro site. Connect it to /api/concierge, preserve the conversation using the returned opaque handle, follow the existing design guidance, support keyboard use, keep Foundry details out of the browser, and add end-to-end tests covering the chat flow, conversation continuity, accessibility, error handling, and grounding boundaries. + ``` + +2. Start the Astro development server in another terminal using the command provided by Copilot. Keep both the site and the local Function running. + +3. Before moving on, confirm the widget actually behaves as expected. Paste in the following prompt to have Copilot run the end-to-end tests for the Backer Concierge widget: + + ```plaintext + Run the end-to-end tests for the Backer Concierge widget in the Tailspin Toys site. Verify its core chat flow, conversation continuity, accessibility, error handling, grounding boundaries, and secure use of the local proxy. Report the results and include evidence for any failures. + ``` + + Review the report from Copilot. You can manually verify any claims of passing tests against the actual behavior in the browser and address any failing tests. + + ![End-to-end test results for the Backer Concierge widget](../_images/app-8-e2e-test-results.png) + +## Create and merge the pull request + +With the agent built, deployed, and connected to the site, wrap up the same way you have in earlier lessons. + +1. Review all changed files in the session. +2. Confirm that generated environment files, local settings, tokens, and credentials aren't included. +3. Select the dropdown next to **Create PR**, then select **Agent merge**. +4. Select **Agent merge** to create the pull request and monitor its checks. + +## Clean up your resources + +When you're done experimenting, remove the resources to avoid unwanted costs. + +1. Open a new terminal and run: + + ```bash + azd down --purge + ``` + +2. After azd down, if the dedicated workshop resource group still exists, verify its name and contents before running: + + ```bash + az group delete --name rg-tailspin-toys --yes --no-wait + ``` + +## Summary and next steps + +You took a feature brief from an idea to a deployed, product-integrated AI agent. You: + +- created a Foundry project and selected a model from the feature requirements, availability, quota, and cost. +- used Microsoft Foundry Canvas to scaffold and configure the hosted agent. +- tested grounding and conversation behavior in the embedded Agent Inspector. +- deployed and retested the agent in Foundry Agent Service. +- created a locally running Azure Functions proxy to call the Foundry Agent Service. +- added and verified an accessible chat widget in Tailspin Toys. + +Continue to [Lesson 9 - Review and next steps][next-lesson]. + +## Resources + +- [What is Microsoft Foundry Canvas?][foundry-canvas] +- [Deploy your first hosted agent with Foundry Canvas][hosted-agent-quickstart] +- [Hosted agent permissions][hosted-agent-permissions] + +--- + +| [← Previous lesson: Planning with canvases][previous-lesson] | [Next lesson: Review and next steps →][next-lesson] | +| :-- | --: | + +[previous-lesson]: ../7-canvases/ +[next-lesson]: ../9-review/ +[azure-free]: https://azure.microsoft.com/pricing/purchase-options/azure-account +[azure-students]: https://azure.microsoft.com/free/students +[install-azure-cli]: https://learn.microsoft.com/cli/azure/install-azure-cli +[install-azd]: https://learn.microsoft.com/azure/developer/azure-developer-cli/install-azd +[foundry-canvas]: https://learn.microsoft.com/azure/foundry/agents/concepts/foundry-canvas +[hosted-agent-quickstart]: https://learn.microsoft.com/azure/foundry/agents/quickstarts/quickstart-hosted-agent?pivots=canvas +[hosted-agent-permissions]: https://learn.microsoft.com/azure/foundry/agents/concepts/hosted-agent-permissions diff --git a/docs/app/8-review.md b/docs/app/9-review.md similarity index 99% rename from docs/app/8-review.md rename to docs/app/9-review.md index 5de4f1ba..ea75d153 100644 --- a/docs/app/8-review.md +++ b/docs/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "Lesson 8 - Review and next steps" +title: "Lesson 9 - Review and next steps" description: "Recap the GitHub Copilot app harness, automate recurring work, and explore where to go next." authors: - geektrainer diff --git a/docs/app/README.md b/docs/app/README.md index 0f424ef9..c5c15025 100644 --- a/docs/app/README.md +++ b/docs/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 The **[GitHub Copilot app](https://docs.github.com/copilot/concepts/agents/github-copilot-app)** is a desktop application built on Copilot CLI that brings agent-driven development into a single, focused workspace. It adds parallel agent sessions, switchable session modes, shared canvases, and native GitHub issue and pull request management — including **Agent Merge**, which shepherds a pull request through rebases, review feedback, CI fixes, and merge. -Across these lessons you'll install the app and set up your project, then get oriented in the app's workspace and the backlog the template seeded for you. You'll start with a small change — adding a star rating — then add a custom instructions standard from an issue, build a filtering feature in an isolated agent session, and verify it with a reusable skill. You'll add the Playwright MCP server to explore the feature in a real browser, then climb a ladder of merge automation that ends with **Agent Merge** landing your pull request. Finally you'll collaborate on a shared canvas and automate recurring work — a complete loop from idea to merged feature. +Across these lessons you'll install the app and set up your project, then get oriented in the app's workspace and the backlog the template seeded for you. You'll start with a small change — adding a star rating — then add a custom instructions standard from an issue, build a filtering feature in an isolated agent session, and verify it with a reusable skill. You'll add the Playwright MCP server to explore the feature in a real browser, then climb a ladder of merge automation that ends with **Agent Merge** landing your pull request. Finally you'll collaborate on a shared canvas, optionally build a hosted agent with Microsoft Foundry Canvas, and automate recurring work — a complete loop from idea to merged feature. ## Lessons @@ -22,7 +22,8 @@ Across these lessons you'll install the app and set up your project, then get or | [5. Testing with Playwright MCP][ex5] | External Tools | Add the Playwright MCP server and explore your feature in a browser | | [6. Merging with Agent Merge][ex6] | Merge | Let Agent Merge fix and land your filtering pull request | | [7. Planning with canvases][ex7] | Collaboration | Create a shared canvas to plan and track your work | -| [8. Review and next steps][ex8] | Summary | Automate recurring tasks and explore what's next | +| [8. Build a Backer Concierge Agent (Optional)][foundry-canvas] | AI agents | Build, test, deploy, and integrate a catalog-grounded hosted agent | +| [9. Review and next steps][ex9] | Summary | Automate recurring tasks and explore what's next | ## Prerequisites @@ -53,6 +54,7 @@ Before attending this workshop, please ensure you have: [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students diff --git a/docs/es-es/app/7-canvases.md b/docs/es-es/app/7-canvases.md index 2272a3bc..c14ba706 100644 --- a/docs/es-es/app/7-canvases.md +++ b/docs/es-es/app/7-canvases.md @@ -113,7 +113,7 @@ Has creado una superficie compartida en la que puedes colaborar con el agente. E - has guardado y combinado el lienzo con el repositorio mediante Agent Merge. - has abierto el lienzo en una sesión nueva y lo has utilizado para empezar a trabajar. -Con la lista de trabajo pendiente organizada, da un paso atrás para revisar todo lo que has creado y descubrir cómo continuar. Continúa con la [Lección 8 - Repaso y pasos siguientes][next-lesson]. +Con la lista de trabajo pendiente organizada, puedes terminar aquí o continuar. Si quieres crear un agente de IA hospedado a partir del catálogo de Tailspin Toys, continúa con la [lección opcional sobre Backer Concierge][next-lesson]. De lo contrario, pasa a la [Lección 9 - Repaso y pasos siguientes][review-lesson]. ## Recursos @@ -121,7 +121,8 @@ Con la lista de trabajo pendiente organizada, da un paso atrás para revisar tod - [Lienzos en Awesome Copilot][awesome-copilot-canvases] - [Acerca de la aplicación GitHub Copilot][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app \ No newline at end of file diff --git a/docs/es-es/app/8-review.md b/docs/es-es/app/9-review.md similarity index 99% rename from docs/es-es/app/8-review.md rename to docs/es-es/app/9-review.md index 7f9a64f2..3ca0fa27 100644 --- a/docs/es-es/app/8-review.md +++ b/docs/es-es/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "Lección 8 - Repaso y pasos siguientes" +title: "Lección 9 - Repaso y pasos siguientes" description: "Repasa el recorrido de la aplicación GitHub Copilot, automatiza el trabajo recurrente y descubre cómo continuar." authors: - geektrainer diff --git a/docs/es-es/app/README.md b/docs/es-es/app/README.md index 3607a893..b5ba3e49 100644 --- a/docs/es-es/app/README.md +++ b/docs/es-es/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 La [**aplicación GitHub Copilot**](https://docs.github.com/copilot/concepts/agents/github-copilot-app) es una aplicación de escritorio basada en Copilot CLI que reúne el desarrollo dirigido por agentes en un único espacio de trabajo específico. Añade sesiones de agente en paralelo, modos de sesión intercambiables, lienzos compartidos y gestión nativa de incidencias y solicitudes de incorporación de cambios de GitHub, incluido **Agent Merge**, que guía una solicitud durante reorganizaciones de base, comentarios de revisión, correcciones de CI y la combinación. -A lo largo de estas lecciones instalarás la aplicación y configurarás el proyecto. Después, conocerás el espacio de trabajo de la aplicación y la lista de trabajo pendiente que la plantilla ha creado para ti. Empezarás con un cambio pequeño, añadir una valoración por estrellas, y luego añadirás desde una incidencia un estándar de instrucciones personalizadas, crearás una funcionalidad de filtrado en una sesión de agente aislada y la verificarás con una habilidad reutilizable. Añadirás el servidor MCP de Playwright para explorar la funcionalidad en un navegador real y avanzarás por niveles crecientes de automatización de combinaciones hasta que **Agent Merge** incorpore la solicitud. Por último, colaborarás en un lienzo compartido y automatizarás el trabajo recurrente: un ciclo completo desde la idea hasta una funcionalidad combinada. +A lo largo de estas lecciones instalarás la aplicación y configurarás el proyecto. Después, conocerás el espacio de trabajo de la aplicación y la lista de trabajo pendiente que la plantilla ha creado para ti. Empezarás con un cambio pequeño, añadir una valoración por estrellas, y luego añadirás desde una incidencia un estándar de instrucciones personalizadas, crearás una funcionalidad de filtrado en una sesión de agente aislada y la verificarás con una habilidad reutilizable. Añadirás el servidor MCP de Playwright para explorar la funcionalidad en un navegador real y avanzarás por niveles crecientes de automatización de combinaciones hasta que **Agent Merge** incorpore la solicitud. Por último, colaborarás en un lienzo compartido, podrás crear opcionalmente un agente hospedado con Microsoft Foundry Canvas y automatizarás el trabajo recurrente: un ciclo completo desde la idea hasta una funcionalidad combinada. ## Lecciones @@ -22,7 +22,8 @@ A lo largo de estas lecciones instalarás la aplicación y configurarás el proy | [5. Realizar pruebas con MCP de Playwright][ex5] | Herramientas externas | Añade el servidor MCP de Playwright y explora la funcionalidad en un navegador | | [6. Combinar cambios con Agent Merge][ex6] | Combinación | Deja que Agent Merge corrija e incorpore la solicitud de filtrado | | [7. Planificar con lienzos][ex7] | Colaboración | Crea un lienzo compartido para planificar y realizar el seguimiento del trabajo | -| [8. Repaso y pasos siguientes][ex8] | Resumen | Automatiza tareas recurrentes y descubre cómo continuar | +| [8. Crear un agente Backer Concierge (opcional)][foundry-canvas] | Agentes de IA | Crea, prueba, implementa e integra un agente hospedado basado en el catálogo | +| [9. Repaso y pasos siguientes][ex9] | Resumen | Automatiza tareas recurrentes y descubre cómo continuar | ## Requisitos previos @@ -53,6 +54,7 @@ Antes de asistir a este taller, asegúrate de disponer de: [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students \ No newline at end of file diff --git a/docs/ja-jp/app/7-canvases.md b/docs/ja-jp/app/7-canvases.md index 9af8465a..b88ee1ca 100644 --- a/docs/ja-jp/app/7-canvases.md +++ b/docs/ja-jp/app/7-canvases.md @@ -113,7 +113,7 @@ Copilot app が PR の作成と管理を開始します。最初にプロジェ - Agent Merge を使ってキャンバスをリポジトリに保存し、マージした。 - 新しいセッションでキャンバスを開き、そこから作業を開始した。 -バックログを追跡できるようになったので、ここまで構築した内容と今後の進め方を振り返ります。[レッスン 8「振り返りと次のステップ」][next-lesson]に進んでください。 +バックログを追跡できるようになったので、ここで終了することも、さらに学習を続けることもできます。Tailspin Toys のカタログからホステッド AI エージェントを作成する場合は、[Backer Concierge のオプション レッスン][next-lesson]に進みます。それ以外の場合は、[レッスン 9「振り返りと次のステップ」][review-lesson]に進みます。 ## リソース @@ -121,7 +121,8 @@ Copilot app が PR の作成と管理を開始します。最初にプロジェ - [Awesome Copilot の Canvases][awesome-copilot-canvases] - [GitHub Copilot app について][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app \ No newline at end of file diff --git a/docs/ja-jp/app/8-review.md b/docs/ja-jp/app/9-review.md similarity index 99% rename from docs/ja-jp/app/8-review.md rename to docs/ja-jp/app/9-review.md index cbcdcf44..a3ad30c9 100644 --- a/docs/ja-jp/app/8-review.md +++ b/docs/ja-jp/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "レッスン 8 - 振り返りと次のステップ" +title: "レッスン 9 - 振り返りと次のステップ" description: "GitHub Copilot app のハーネスを振り返り、繰り返し発生する作業を自動化して、次に学ぶ内容を確認します。" authors: - geektrainer diff --git a/docs/ja-jp/app/README.md b/docs/ja-jp/app/README.md index fb9e8b76..a078cbb7 100644 --- a/docs/ja-jp/app/README.md +++ b/docs/ja-jp/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 [**GitHub Copilot app**](https://docs.github.com/copilot/concepts/agents/github-copilot-app) は Copilot CLI を基盤とするデスクトップアプリケーションで、エージェント主導の開発を単一の作業用ワークスペースで実現します。並列エージェントセッション、切り替え可能なセッションモード、共有キャンバス、GitHub Issue と pull request のネイティブ管理機能を備えています。さらに、リベース、レビューのフィードバック、CI の修正、マージまで pull request を導く **Agent Merge** も利用できます。 -一連のレッスンでは、アプリをインストールしてプロジェクトを設定した後、アプリのワークスペースと、テンプレートによって用意されたバックログを確認します。まず、星評価を追加する小さな変更に取り組みます。次に、Issue に基づいてカスタム指示の標準を追加し、分離されたエージェントセッションでフィルター機能を構築して、再利用可能なスキルで検証します。Playwright MCP server を追加して実際のブラウザーで機能を確認した後、段階的にマージの自動化を進め、最後は **Agent Merge** で pull request をマージします。最後に、共有キャンバスで共同作業し、繰り返し発生する作業を自動化します。アイデアから機能のマージまで、開発の一連の流れを体験できます。 +一連のレッスンでは、アプリをインストールしてプロジェクトを設定した後、アプリのワークスペースと、テンプレートによって用意されたバックログを確認します。まず、星評価を追加する小さな変更に取り組みます。次に、Issue に基づいてカスタム指示の標準を追加し、分離されたエージェントセッションでフィルター機能を構築して、再利用可能なスキルで検証します。Playwright MCP server を追加して実際のブラウザーで機能を確認した後、段階的にマージの自動化を進め、最後は **Agent Merge** で pull request をマージします。最後に、共有キャンバスで共同作業し、必要に応じて Microsoft Foundry Canvas でホステッド エージェントを構築して、繰り返し発生する作業を自動化します。アイデアから機能のマージまで、開発の一連の流れを体験できます。 ## レッスン @@ -22,7 +22,8 @@ lastUpdated: 2026-06-30 | [5. Playwright MCP によるテスト][ex5] | 外部ツール | Playwright MCP server を追加し、ブラウザーで機能を確認します | | [6. Agent Merge によるマージ][ex6] | マージ | Agent Merge でフィルター機能の pull request を修正してマージします | | [7. キャンバスを使った計画][ex7] | コラボレーション | 共有キャンバスを作成し、作業の計画と追跡に使用します | -| [8. 振り返りと次のステップ][ex8] | まとめ | 繰り返し発生するタスクを自動化し、次に学ぶ内容を確認します | +| [8. Backer Concierge エージェントの構築 (オプション)][foundry-canvas] | AI エージェント | カタログに基づくホステッド エージェントを構築、テスト、デプロイ、統合します | +| [9. 振り返りと次のステップ][ex9] | まとめ | 繰り返し発生するタスクを自動化し、次に学ぶ内容を確認します | ## 前提条件 @@ -53,6 +54,7 @@ lastUpdated: 2026-06-30 [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students \ No newline at end of file diff --git a/docs/ko-kr/app/7-canvases.md b/docs/ko-kr/app/7-canvases.md index dca280c8..6abe7be9 100644 --- a/docs/ko-kr/app/7-canvases.md +++ b/docs/ko-kr/app/7-canvases.md @@ -113,7 +113,7 @@ Copilot app이 PR을 만들고 관리하는 프로세스를 시작합니다. 먼 - Agent Merge를 사용하여 캔버스를 리포지토리에 저장하고 병합했습니다. - 새 세션에서 캔버스를 열고 캔버스를 사용하여 작업을 시작했습니다. -백로그를 추적하도록 설정했으므로 지금까지 구축한 항목과 다음 단계를 돌아봅니다. [레슨 8 - 검토 및 다음 단계][next-lesson]를 계속 진행합니다. +백로그 추적을 설정했으므로 여기서 마치거나 계속 진행할 수 있습니다. Tailspin Toys 카탈로그를 기반으로 호스팅 AI 에이전트를 만들려면 [Backer Concierge 선택 레슨][next-lesson]으로 이동합니다. 그렇지 않으면 [레슨 9 - 검토 및 다음 단계][review-lesson]로 이동합니다. ## 리소스 @@ -121,7 +121,8 @@ Copilot app이 PR을 만들고 관리하는 프로세스를 시작합니다. 먼 - [Awesome Copilot의 캔버스][awesome-copilot-canvases] - [GitHub Copilot app 정보][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app \ No newline at end of file diff --git a/docs/ko-kr/app/8-review.md b/docs/ko-kr/app/9-review.md similarity index 99% rename from docs/ko-kr/app/8-review.md rename to docs/ko-kr/app/9-review.md index 1b23b940..af5579b6 100644 --- a/docs/ko-kr/app/8-review.md +++ b/docs/ko-kr/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "Lesson 8 - 검토 및 다음 단계" +title: "Lesson 9 - 검토 및 다음 단계" description: "GitHub Copilot app 실습 과정을 되짚어 보고, 반복 작업을 자동화하고, 다음에 살펴볼 내용을 알아봅니다." authors: - geektrainer diff --git a/docs/ko-kr/app/README.md b/docs/ko-kr/app/README.md index 60cb1e8f..f59f1f62 100644 --- a/docs/ko-kr/app/README.md +++ b/docs/ko-kr/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 [**GitHub Copilot app**](https://docs.github.com/copilot/concepts/agents/github-copilot-app)은 Copilot CLI를 기반으로 구축된 데스크톱 애플리케이션으로, 에이전트 기반 개발을 하나의 집중된 워크스페이스에서 수행할 수 있게 해 줍니다. 병렬 에이전트 세션, 전환 가능한 세션 모드, 공유 캔버스, GitHub 이슈 및 끌어오기 요청 기본 관리 기능을 제공합니다. 여기에는 끌어오기 요청의 리베이스, 검토 피드백, CI 수정, 병합 과정을 관리하는 **Agent Merge**도 포함됩니다. -이 레슨에서는 앱을 설치하고 프로젝트를 설정한 다음, 앱 워크스페이스와 템플릿에서 미리 생성한 백로그를 살펴봅니다. 별점을 추가하는 작은 변경으로 시작한 뒤, 이슈를 바탕으로 사용자 지정 지침 표준을 추가하고, 격리된 에이전트 세션에서 필터링 기능을 구축하고, 재사용 가능한 스킬로 검증합니다. Playwright MCP 서버를 추가하여 실제 브라우저에서 기능을 살펴본 다음, **Agent Merge**가 끌어오기 요청을 병합하는 단계까지 병합 자동화 수준을 높입니다. 마지막으로 공유 캔버스에서 협업하고 반복 작업을 자동화하여 아이디어를 병합된 기능으로 완성하는 전체 과정을 경험합니다. +이 레슨에서는 앱을 설치하고 프로젝트를 설정한 다음, 앱 워크스페이스와 템플릿에서 미리 생성한 백로그를 살펴봅니다. 별점을 추가하는 작은 변경으로 시작한 뒤, 이슈를 바탕으로 사용자 지정 지침 표준을 추가하고, 격리된 에이전트 세션에서 필터링 기능을 구축하고, 재사용 가능한 스킬로 검증합니다. Playwright MCP 서버를 추가하여 실제 브라우저에서 기능을 살펴본 다음, **Agent Merge**가 끌어오기 요청을 병합하는 단계까지 병합 자동화 수준을 높입니다. 마지막으로 공유 캔버스에서 협업하고, 선택적으로 Microsoft Foundry Canvas를 사용해 호스팅 에이전트를 구축하고, 반복 작업을 자동화하여 아이디어를 병합된 기능으로 완성하는 전체 과정을 경험합니다. ## 레슨 @@ -22,7 +22,8 @@ lastUpdated: 2026-06-30 | [5. Playwright MCP로 테스트][ex5] | 외부 도구 | Playwright MCP 서버를 추가하고 브라우저에서 기능 살펴보기 | | [6. Agent Merge로 병합][ex6] | 병합 | Agent Merge가 필터링 끌어오기 요청을 수정하고 병합하도록 하기 | | [7. 캔버스로 계획 수립][ex7] | 협업 | 작업을 계획하고 추적하는 공유 캔버스 만들기 | -| [8. 검토 및 다음 단계][ex8] | 요약 | 반복 작업을 자동화하고 다음에 살펴볼 내용 알아보기 | +| [8. Backer Concierge 에이전트 빌드(선택 사항)][foundry-canvas] | AI 에이전트 | 카탈로그 기반 호스팅 에이전트를 빌드, 테스트, 배포 및 통합하기 | +| [9. 검토 및 다음 단계][ex9] | 요약 | 반복 작업을 자동화하고 다음에 살펴볼 내용 알아보기 | ## 필수 조건 @@ -53,6 +54,7 @@ lastUpdated: 2026-06-30 [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students \ No newline at end of file diff --git a/docs/pt-br/app/7-canvases.md b/docs/pt-br/app/7-canvases.md index abbd6aa6..d16d4c9a 100644 --- a/docs/pt-br/app/7-canvases.md +++ b/docs/pt-br/app/7-canvases.md @@ -113,7 +113,7 @@ Você criou uma superfície compartilhada na qual você e o agente podem colabor - salvou o canvas no repositório e fez o merge dele com o Agent Merge. - abriu o canvas em uma nova sessão e o usou para começar a trabalhar. -Com o backlog acompanhado, é hora de revisar tudo o que você criou e decidir os próximos passos. Continue para a [Lição 8 - Revisão e próximos passos][next-lesson]. +Com o acompanhamento do backlog configurado, você pode encerrar por aqui ou continuar. Para criar um agente de IA hospedado com base no catálogo da Tailspin Toys, avance para a [lição opcional do Backer Concierge][next-lesson]. Caso contrário, vá para a [Lição 9 - Revisão e próximos passos][review-lesson]. ## Recursos @@ -121,7 +121,8 @@ Com o backlog acompanhado, é hora de revisar tudo o que você criou e decidir o - [Canvases no Awesome Copilot][awesome-copilot-canvases] - [Sobre o aplicativo GitHub Copilot][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app \ No newline at end of file diff --git a/docs/pt-br/app/8-review.md b/docs/pt-br/app/9-review.md similarity index 99% rename from docs/pt-br/app/8-review.md rename to docs/pt-br/app/9-review.md index 704a1783..453e2d78 100644 --- a/docs/pt-br/app/8-review.md +++ b/docs/pt-br/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "Lição 8 - Revisão e próximos passos" +title: "Lição 9 - Revisão e próximos passos" description: "Recapitule o percurso do aplicativo GitHub Copilot, automatize trabalhos recorrentes e explore os próximos passos." authors: - geektrainer diff --git a/docs/pt-br/app/README.md b/docs/pt-br/app/README.md index 82e8ba78..edb986ee 100644 --- a/docs/pt-br/app/README.md +++ b/docs/pt-br/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 O [**aplicativo GitHub Copilot**](https://docs.github.com/copilot/concepts/agents/github-copilot-app) é um aplicativo para desktop criado com base no Copilot CLI que reúne o desenvolvimento orientado por agentes em um espaço de trabalho único e focado. Ele oferece sessões paralelas de agentes, modos de sessão alternáveis, canvases compartilhados e gerenciamento nativo de issues e pull requests do GitHub, incluindo o **Agent Merge**, que conduz um pull request por rebases, feedback de revisão, correções de CI e merge. -Ao longo destas lições, você instalará o aplicativo e configurará o projeto. Depois, conhecerá o espaço de trabalho do aplicativo e o backlog que o modelo criou para você. Você começará com uma pequena alteração, adicionando uma avaliação por estrelas, e então adicionará a partir de uma issue um padrão de instruções personalizadas, criará um recurso de filtragem em uma sessão isolada de agente e o verificará com uma skill reutilizável. Você adicionará o servidor MCP do Playwright para explorar o recurso em um navegador real e, em seguida, avançará por níveis de automação de merge até que o **Agent Merge** conclua o merge do pull request. Por fim, você colaborará em um canvas compartilhado e automatizará trabalhos recorrentes, completando todo o ciclo, da ideia ao recurso integrado. +Ao longo destas lições, você instalará o aplicativo e configurará o projeto. Depois, conhecerá o espaço de trabalho do aplicativo e o backlog que o modelo criou para você. Você começará com uma pequena alteração, adicionando uma avaliação por estrelas, e então adicionará a partir de uma issue um padrão de instruções personalizadas, criará um recurso de filtragem em uma sessão isolada de agente e o verificará com uma skill reutilizável. Você adicionará o servidor MCP do Playwright para explorar o recurso em um navegador real e, em seguida, avançará por níveis de automação de merge até que o **Agent Merge** conclua o merge do pull request. Por fim, você colaborará em um canvas compartilhado, poderá criar opcionalmente um agente hospedado com o Microsoft Foundry Canvas e automatizará trabalhos recorrentes, completando todo o ciclo, da ideia ao recurso integrado. ## Lições @@ -22,7 +22,8 @@ Ao longo destas lições, você instalará o aplicativo e configurará o projeto | [5. Testar com o MCP do Playwright][ex5] | Ferramentas externas | Adicione o servidor MCP do Playwright e explore o recurso em um navegador | | [6. Fazer merge com o Agent Merge][ex6] | Merge | Permita que o Agent Merge corrija e integre o pull request de filtragem | | [7. Planejar com canvases][ex7] | Colaboração | Crie um canvas compartilhado para planejar e acompanhar seu trabalho | -| [8. Revisão e próximos passos][ex8] | Resumo | Automatize tarefas recorrentes e explore os próximos passos | +| [8. Criar um agente Backer Concierge (opcional)][foundry-canvas] | Agentes de IA | Crie, teste, implante e integre um agente hospedado baseado no catálogo | +| [9. Revisão e próximos passos][ex9] | Resumo | Automatize tarefas recorrentes e explore os próximos passos | ## Pré-requisitos @@ -53,6 +54,7 @@ Antes de participar deste workshop, verifique se você tem: [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students \ No newline at end of file diff --git a/docs/zh-cn/app/7-canvases.md b/docs/zh-cn/app/7-canvases.md index 0affd8dd..3bf9bfb4 100644 --- a/docs/zh-cn/app/7-canvases.md +++ b/docs/zh-cn/app/7-canvases.md @@ -113,7 +113,7 @@ Copilot app 会开始创建并管理 PR。它先探索项目以确定创建 PR - 使用 Agent Merge 将画布保存并合并到存储库。 - 在新会话中打开画布，并使用它开始工作。 -待办事项现已得到跟踪。接下来回顾已构建的所有内容，并了解后续方向。继续学习[第 8 课 - 回顾与后续步骤][next-lesson]。 +待办事项现已得到跟踪，你可以在此结束，也可以继续学习。如果想基于 Tailspin Toys 目录创建托管 AI 智能体，请继续学习[可选的 Backer Concierge 课程][next-lesson]。否则，请跳转到[第 9 课 - 回顾与后续步骤][review-lesson]。 ## 资源 @@ -121,7 +121,8 @@ Copilot app 会开始创建并管理 PR。它先探索项目以确定创建 PR - [Awesome Copilot 上的画布][awesome-copilot-canvases] - [关于 GitHub Copilot app][about-copilot-app] -[next-lesson]: ../8-review/ +[next-lesson]: ../8-foundry-canvas/ +[review-lesson]: ../9-review/ [canvas-docs]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions [awesome-copilot-canvases]: https://awesome-copilot.github.com/extensions/ [about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app \ No newline at end of file diff --git a/docs/zh-cn/app/8-review.md b/docs/zh-cn/app/9-review.md similarity index 99% rename from docs/zh-cn/app/8-review.md rename to docs/zh-cn/app/9-review.md index c00c5c7b..350ceae6 100644 --- a/docs/zh-cn/app/8-review.md +++ b/docs/zh-cn/app/9-review.md @@ -1,5 +1,5 @@ --- -title: "第 8 课 - 回顾与后续步骤" +title: "第 9 课 - 回顾与后续步骤" description: "回顾 GitHub Copilot app 学习路径，自动执行重复性工作，并探索后续方向。" authors: - geektrainer diff --git a/docs/zh-cn/app/README.md b/docs/zh-cn/app/README.md index 106881c3..a32e3a69 100644 --- a/docs/zh-cn/app/README.md +++ b/docs/zh-cn/app/README.md @@ -8,7 +8,7 @@ lastUpdated: 2026-06-30 [**GitHub Copilot app**](https://docs.github.com/copilot/concepts/agents/github-copilot-app) 是一款基于 Copilot CLI 构建的桌面应用，可将智能体驱动的开发集中到一个专注的工作区。它支持并行智能体会话、可切换的会话模式、共享画布，以及原生的 GitHub 议题和拉取请求管理功能。其中包括 **Agent Merge**，可处理拉取请求的变基、审查反馈、CI 修复与合并。 -在这些课程中，你将安装应用并设置项目，然后熟悉应用工作区和模板为你创建的待办事项。你会先完成一项小改动，即添加星级评分；再根据议题添加自定义指令标准，在隔离的智能体会话中构建筛选功能，并使用可复用技能进行验证。随后，你将添加 Playwright MCP 服务器，在真实浏览器中探索该功能，并逐步提高合并自动化程度，最终由 **Agent Merge** 合并拉取请求。最后，你将通过共享画布协作并自动执行重复性工作，完整体验从构想到功能合并的流程。 +在这些课程中，你将安装应用并设置项目，然后熟悉应用工作区和模板为你创建的待办事项。你会先完成一项小改动，即添加星级评分；再根据议题添加自定义指令标准，在隔离的智能体会话中构建筛选功能，并使用可复用技能进行验证。随后，你将添加 Playwright MCP 服务器，在真实浏览器中探索该功能，并逐步提高合并自动化程度，最终由 **Agent Merge** 合并拉取请求。最后，你将通过共享画布协作，可选择使用 Microsoft Foundry Canvas 构建托管智能体，并自动执行重复性工作，完整体验从构想到功能合并的流程。 ## 课程 @@ -22,7 +22,8 @@ lastUpdated: 2026-06-30 | [5. 使用 Playwright MCP 测试][ex5] | 外部工具 | 添加 Playwright MCP 服务器，并在浏览器中探索功能 | | [6. 使用 Agent Merge 合并][ex6] | 合并 | 让 Agent Merge 修复并合并筛选功能的拉取请求 | | [7. 使用画布规划][ex7] | 协作 | 创建共享画布来规划和跟踪工作 | -| [8. 回顾与后续步骤][ex8] | 总结 | 自动执行重复性任务，并探索后续内容 | +| [8. 构建 Backer Concierge 智能体（可选）][foundry-canvas] | AI 智能体 | 构建、测试、部署并集成基于目录的托管智能体 | +| [9. 回顾与后续步骤][ex9] | 总结 | 自动执行重复性任务，并探索后续内容 | ## 先决条件 @@ -53,6 +54,7 @@ lastUpdated: 2026-06-30 [ex5]: 5-mcp-playwright/ [ex6]: 6-agent-merge/ [ex7]: 7-canvases/ -[ex8]: 8-review/ +[foundry-canvas]: 8-foundry-canvas/ +[ex9]: 9-review/ [install-git]: https://github.com/git-guides/install-git [callout-student-plan-education]: https://github.com/education/students \ No newline at end of file diff --git a/website/astro.config.mjs b/website/astro.config.mjs index a2696910..0c486a04 100644 --- a/website/astro.config.mjs +++ b/website/astro.config.mjs @@ -195,7 +195,8 @@ export default defineConfig({ { label: '5. Testing with Playwright MCP', link: '/app/5-mcp-playwright/' }, { label: '6. Merging with Agent Merge', link: '/app/6-agent-merge/' }, { label: '7. Planning with canvases', link: '/app/7-canvases/' }, - { label: '8. Review', link: '/app/8-review/' }, + { label: '8. Build a Backer Concierge Agent (Optional)', link: '/app/8-foundry-canvas/' }, + { label: '9. Review', link: '/app/9-review/' }, ], }, {