Skip to content

Commit 4c1b479

Browse files
update agent skill exercise (#3)
1 parent 3a57a55 commit 4c1b479

4 files changed

Lines changed: 26 additions & 33 deletions

File tree

docs/docs/index.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,28 @@ In this hands-on workshop, you'll build **Travel Assistant**, an AI-powered agen
88

99
## What You'll Build
1010

11+
### Par 1: Foundation Labs
12+
1113
**Before You Start:** We highly recommend completing the foundation labs in the `labs/00-foundations` folder first. These labs cover the fundamental concepts of building agents with the Microsoft Agent Framework.
1214

15+
1. **[Lab 01: Basic Agent](../labs/00-foundations/lab01-basic-agent/README.md)** - Create your first AI-powered travel assistant with multi-turn conversations
16+
17+
2. **[Lab 02: Travel Assistant with Context](../labs/00-foundations/lab02-context/README.md)** - Enhance your agent by injecting additional context using `AIContextProvider`
18+
19+
3. **[Lab 03: Travel Assistant with RAG](../labs/00-foundations/lab03-rag/README.md)** - Implement Retrieval Augmented Generation (RAG) with semantic search over your own data
20+
21+
4. **[Lab 04: Long-Term Memory](../labs/00-foundations/lab04-longterm-memory/README.md)** - Add persistent user preferences across sessions with structured data extraction
22+
23+
5. **[Lab 05: Tools and Function Calling](../labs/00-foundations/lab05-tools/README.md)** - Add tools to your agent for dynamic information retrieval and actions
24+
25+
6. **[Lab 06: PII Filtering Middleware](../labs/00-foundations/lab06-middleware/README.md)** - Implement middleware to redact sensitive information from conversations
26+
27+
7. **[Lab 07: File-Based Agent Skills](../labs/00-foundations/lab07-skills/README.md)** - Use modular skill packages with progressive disclosure for scalable agent capabilities
28+
29+
8. **[Lab 08: Hosting Agents as Web Services](../labs/00-foundations/lab08-host/README.md)** - Host your agent as an ASP.NET Core web service with OpenAI-compatible endpoints
30+
31+
### Part 2: Hosted Agent with React UI
32+
1333
This workshop consists of five progressive labs, each building on the previous one:
1434

1535
1. [Lab 1: Remember Me - Personalization](./01-lab-personalization.md)

labs/00-foundations/lab07-skills/skills/destination-recommendation/SKILL.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Suggests travel destinations based on preferences, budget, season,
55

66
# Destination Recommendation Skill
77

8-
You have access to destination information and travel planning tools to help travelers discover and choose the perfect destination for their trip.
8+
You have access to destination information and travel planning tools to help travelers discover and choose the perfect destination for their trip. Consult the [destination profiles](references/DESTINATIONS.md) for comprehensive city and attraction information.
99

1010
## When to Use This Skill
1111

@@ -19,14 +19,6 @@ Use this skill when the traveler:
1919
- Needs information about best times to visit
2020
- Wants destination comparisons
2121

22-
## Available Resources
23-
24-
### Destination Database
25-
For detailed destination information and recommendations, refer to:
26-
- **references/DESTINATIONS.md**: Comprehensive destination profiles including popular cities, attractions, best times to visit, and traveler types
27-
28-
The agent framework will load destination resources automatically when recommendation questions are asked.
29-
3022
## Usage Guidelines
3123

3224
1. **Ask clarifying questions** to understand traveler preferences:

labs/00-foundations/lab07-skills/skills/visa-recommendation/SKILL.md

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Provides visa requirements, entry regulations, and travel document
55

66
# Visa Recommendation Skill
77

8-
You have access to visa requirement information and entry regulations to help travelers understand what documents they need for international travel.
8+
You have access to visa requirement information and entry regulations to help travelers understand what documents they need for international travel. Reference the [visa requirements documentation](references/VISA_REQUIREMENTS.md) for detailed country-specific information.
99

1010
## When to Use This Skill
1111

@@ -17,14 +17,6 @@ Use this skill when the traveler:
1717
- Needs information about electronic travel authorizations (eTA)
1818
- Is planning international travel and unsure about entry requirements
1919

20-
## Available Resources
21-
22-
### Visa Requirements Database
23-
For detailed visa requirements and entry regulations, refer to:
24-
- **references/VISA_REQUIREMENTS.md**: Comprehensive visa information for popular destinations including Japan, Canada, and general visa guidance
25-
26-
To access visa information, the agent framework will load the resource automatically when visa-related questions are asked.
27-
2820
## Usage Guidelines
2921

3022
1. **Ask for traveler's nationality** - visa requirements vary significantly by citizenship
@@ -43,9 +35,8 @@ To access visa information, the agent framework will load the resource automatic
4335
**User**: "Do I need a visa to visit Japan?"
4436
**Action**:
4537
1. Ask for their nationality
46-
2. Reference VISA_REQUIREMENTS.md for Japan
47-
3. Explain visa-free entry eligibility or visa requirements
48-
4. Mention passport validity requirements
38+
2. Explain visa-free entry eligibility or visa requirements
39+
3. Mention passport validity requirements
4940

5041
**User**: "I'm from Australia going to Canada for 2 weeks"
5142
**Action**:

labs/00-foundations/lab08-host/README.md

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -57,21 +57,11 @@ HOST STARTED - Agent is now available at the following endpoints:
5757
Press Ctrl+C to shut down
5858
```
5959

60-
### Step 3: Test the Agent via the Browser UI
61-
62-
Open your browser to: http://localhost:5000/agent/travel
63-
64-
You will see an interactive chat interface. Try asking:
65-
- "Find me flights from Melbourne to Tokyo for next Friday"
66-
- "What is today's date?"
67-
68-
Observe how the agent uses tools in real-time to answer your questions.
69-
70-
### Step 4: Test the Agent via the HTTP File
60+
### Step 3: Test the Agent via the HTTP File
7161

7262
Open `TravelAssistant.http` in VS Code and click **Send Request** next to any of the pre-built requests to call the OpenAI-compatible endpoint directly.
7363

74-
### Step 5: Stop the Service
64+
### Step 4: Stop the Service
7565

7666
Press `Ctrl+C` in the terminal to shut down the web service.
7767

0 commit comments

Comments
 (0)