diff --git a/Instructions/Consolidated/A-build-and-extend-ai-agents.md b/Instructions/Consolidated/A-build-and-extend-ai-agents.md index 0604997d8..bb4c6b827 100644 --- a/Instructions/Consolidated/A-build-and-extend-ai-agents.md +++ b/Instructions/Consolidated/A-build-and-extend-ai-agents.md @@ -42,6 +42,7 @@ Complete the two core tasks for a working agent, then choose optional tasks base you want to practice. + | Section | Task | Level | Time | | --- | --- | --- | --- | | **Core** | [Task 1 – Create and ground an agent](A1-create-and-ground-an-agent.md) | ▰▰▱▱▱ L200 | ~15 min | @@ -52,6 +53,7 @@ you want to practice. | *Optional* | [Task 6 – Promote your assistant to a hosted agent](A6-promote-your-assistant-to-a-hosted-agent.md) | ▰▰▰▱▱ L300 | ~30 min | **Core tasks:** about **35 minutes**. **Full lab**, including every optional task: about **2 hours 25 minutes**. + > **Note**: Some of the technologies used in this exercise are in preview or in active diff --git a/Instructions/Consolidated/B-integrate-agents-with-enterprise-knowledge-and-m365.md b/Instructions/Consolidated/B-integrate-agents-with-enterprise-knowledge-and-m365.md index 92921e7ab..e12018a92 100644 --- a/Instructions/Consolidated/B-integrate-agents-with-enterprise-knowledge-and-m365.md +++ b/Instructions/Consolidated/B-integrate-agents-with-enterprise-knowledge-and-m365.md @@ -115,6 +115,7 @@ Complete the **Core** task first — it ends with a working, grounded enterprise you can call from code. Then expand any **Optional** tasks that interest you. + | Section | Task | Level | Time | | --- | --- | --- | --- | | **Core** | [Task 1 – Create a Foundry IQ knowledge agent and connect from code](B1-create-a-foundry-iq-knowledge-agent.md) | ▰▰▰▱▱ L300 | ~35 min | @@ -127,6 +128,7 @@ you can call from code. Then expand any **Optional** tasks that interest you. > 🔒 Tasks marked with a lock need access your account may not have. Each one opens > with a quick check and tells you what to do if you don't have it — nothing else in > this lab depends on them. + **Choosing your path** — pick the tasks that fit the time you have: diff --git a/Instructions/Consolidated/B2-publish-to-microsoft-teams.md b/Instructions/Consolidated/B2-publish-to-microsoft-teams.md index 2b807539e..b82d03e98 100644 --- a/Instructions/Consolidated/B2-publish-to-microsoft-teams.md +++ b/Instructions/Consolidated/B2-publish-to-microsoft-teams.md @@ -22,6 +22,7 @@ lab: *Part of the **Integrate agents with enterprise knowledge and Microsoft 365** lab. New here? Start with [Getting started](B0-getting-started.md).* + > ### Check your access before you start > > **This task needs:** A Microsoft 365 account with Teams access, and permission to publish agents to Teams in your tenant. @@ -29,6 +30,7 @@ lab: > In the Foundry portal, open your agent and select **Publish**. If Teams is greyed out or returns a consent error, you don't have the rights this task needs. > > **Don't have it?** Skip this task. Nothing else in this lab depends on it, and you can still read through the steps to see how it works. + > **Set up (start here):** This task publishes the grounded `caldova-knowledge-agent` from diff --git a/Instructions/Consolidated/B3-publish-to-microsoft-365-copilot.md b/Instructions/Consolidated/B3-publish-to-microsoft-365-copilot.md index 8d5b740ec..2ab87ec76 100644 --- a/Instructions/Consolidated/B3-publish-to-microsoft-365-copilot.md +++ b/Instructions/Consolidated/B3-publish-to-microsoft-365-copilot.md @@ -22,6 +22,7 @@ lab: *Part of the **Integrate agents with enterprise knowledge and Microsoft 365** lab. New here? Start with [Getting started](B0-getting-started.md).* + > ### Check your access before you start > > **This task needs:** A Microsoft 365 Copilot licence, and permission to publish agents to Copilot in your tenant. @@ -29,6 +30,7 @@ lab: > In the Foundry portal, open your agent and select **Publish**. If Microsoft 365 Copilot is greyed out or returns a consent error, you don't have the rights this task needs. > > **Don't have it?** Skip this task. Nothing else in this lab depends on it, and you can still read through the steps to see how it works. + > **Set up (start here):** This task publishes the grounded `caldova-knowledge-agent` from diff --git a/Instructions/Consolidated/B4-work-iq-workplace-intelligence.md b/Instructions/Consolidated/B4-work-iq-workplace-intelligence.md index 32e966238..5f4e447a8 100644 --- a/Instructions/Consolidated/B4-work-iq-workplace-intelligence.md +++ b/Instructions/Consolidated/B4-work-iq-workplace-intelligence.md @@ -23,6 +23,7 @@ lab: *Part of the **Integrate agents with enterprise knowledge and Microsoft 365** lab. New here? Start with [Getting started](B0-getting-started.md).* + > ### Check your access before you start > > **This task needs:** A Microsoft 365 Copilot licence, IT admin consent for Work IQ, and Node.js 18 or later. @@ -34,6 +35,7 @@ npm install -g @microsoft/workiq && workiq accept-eula && workiq ask -q "What me ``` > **Don't have it?** Skip this task. Nothing else in this lab depends on it, and you can still read through the steps to see how it works. + > **Set up (start here):** This task needs a Foundry project (with a deployed model) and the diff --git a/Instructions/Consolidated/C-build-multi-agent-solutions-with-agent-framework.md b/Instructions/Consolidated/C-build-multi-agent-solutions-with-agent-framework.md index 3a9c83f4f..0adc2522b 100644 --- a/Instructions/Consolidated/C-build-multi-agent-solutions-with-agent-framework.md +++ b/Instructions/Consolidated/C-build-multi-agent-solutions-with-agent-framework.md @@ -116,6 +116,7 @@ Complete the **Core** task first — it ends with a working, tool-using agent. T **Optional** tasks that interest you. + | Section | Task | Level | Time | | --- | --- | --- | --- | | **Core** | [Task 1 – Build an agent with a tool](C1-create-an-agent-with-a-tool.md) | ▰▰▰▱▱ L300 | ~30 min | @@ -124,6 +125,7 @@ Complete the **Core** task first — it ends with a working, tool-using agent. T | *Optional* | [Task 4 – Classify and route a support ticket](C4-classify-and-route-a-ticket.md) | ▰▰▰▱▱ L300 | ~30 min | **Core tasks:** about **30 minutes**. **Full lab**, including every optional task: about **2 hours**. + **Choosing your path** — pick the tasks that fit the time you have: diff --git a/Instructions/Consolidated/D-observe-evaluate-and-secure-agents.md b/Instructions/Consolidated/D-observe-evaluate-and-secure-agents.md index ed4a06963..5307a9f01 100644 --- a/Instructions/Consolidated/D-observe-evaluate-and-secure-agents.md +++ b/Instructions/Consolidated/D-observe-evaluate-and-secure-agents.md @@ -127,6 +127,7 @@ inside and a scorecard for its answers. Then add the **Optional** task if you wa how it stands up to attack. + | Section | Task | Level | Time | | --- | --- | --- | --- | | **Core** | [Task 1 – Trace your agent](D1-trace-your-agent.md) | ▰▰▰▱▱ L300 | ~25 min | @@ -134,6 +135,7 @@ how it stands up to attack. | *Optional* | [Task 3 – Red team your agent](D3-red-team-your-agent.md) | ▰▰▰▰▱ L400 | ~35 min | **Core tasks:** about **60 minutes**. **Full lab**, including every optional task: about **1 hour 35 minutes**. + **Choosing your path** — pick the tasks that fit the time you have: diff --git a/tools/generate_lab_blocks.py b/tools/generate_lab_blocks.py index 3078bed0d..6328fccd0 100644 --- a/tools/generate_lab_blocks.py +++ b/tools/generate_lab_blocks.py @@ -151,7 +151,7 @@ def replace_block(text: str, name: str, content: str, path: Path) -> str: + re.escape(name) + r" -->", re.S, ) - replacement = f"{begin}\n{content}\n{end}" + replacement = f"{begin}\n\n{content}\n\n{end}" if not pattern.search(text): raise SystemExit( f"{path.name}: expected a '{name}' block. Add the markers where it belongs:\n"