refactor: update tutorial README files for consistency and clarity

- Changed section headers to use more descriptive icons for better visual guidance.
- Improved tutorial structure and overview sections for enhanced readability.
- Updated callback examples to include clearer print statements for better understanding of agent interactions.
This commit is contained in:
Shubhamsaboo 2025-08-03 20:26:35 -05:00
parent 54ecde998c
commit 3de66d37b5
2 changed files with 9 additions and 11 deletions

View file

@ -125,12 +125,10 @@ A **Session** is like a conversation thread that keeps track of all interactions
└─────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────┘
``` ```
## 🎯 Tutorial Structure ## 📚 Tutorial Structure
This tutorial is divided into three progressive levels: This tutorial is divided into three progressive levels:
### 📚 **Tutorials**
1. **[5_1_in_memory_conversation](./5_1_in_memory_conversation/README.md)** - Basic session management 1. **[5_1_in_memory_conversation](./5_1_in_memory_conversation/README.md)** - Basic session management
- InMemorySessionService for temporary conversations - InMemorySessionService for temporary conversations
- Simple state management - Simple state management

View file

@ -1,11 +1,11 @@
# 🎯 Tutorial 6: Callbacks # 📋 Tutorial 6: Callbacks
## 🎯 What You'll Learn ## 🎯 What You'll Learn
- **Agent Lifecycle Callbacks**: Monitor agent creation, initialization, and cleanup - **Agent Lifecycle Callbacks**: Monitor agent creation, initialization, and cleanup
- **LLM Interaction Callbacks**: Track model requests, responses, and token usage - **LLM Interaction Callbacks**: Track model requests, responses, and token usage
- **Tool Execution Callbacks**: Monitor tool calls, parameters, and results - **Tool Execution Callbacks**: Monitor tool calls, parameters, and results
## 🧠 Core Concept: Callbacks ## 💡 Core Concept: Callbacks
Callbacks are functions that get executed at specific points during agent execution, allowing you to monitor, log, and control the agent's behavior without modifying the core logic. Callbacks are functions that get executed at specific points during agent execution, allowing you to monitor, log, and control the agent's behavior without modifying the core logic.
@ -30,7 +30,7 @@ Callbacks are functions that get executed at specific points during agent execut
- **Integration**: Connect agents to external systems - **Integration**: Connect agents to external systems
- **Debugging**: Understand what's happening inside the agent - **Debugging**: Understand what's happening inside the agent
## 🚀 Tutorial Overview ## 📖 Tutorial Overview
This tutorial covers three essential callback patterns in Google ADK: This tutorial covers three essential callback patterns in Google ADK:
@ -100,12 +100,12 @@ cd ../6_3_tool_execution_callbacks
streamlit run app.py streamlit run app.py
``` ```
## 🔧 Callback Patterns ## ⚙️ Callback Patterns
### **1. Agent Lifecycle Callbacks** ### **1. Agent Lifecycle Callbacks**
```python ```python
def on_agent_start(agent_name: str): def on_agent_start(agent_name: str):
print(f"🚀 Agent {agent_name} started") print(f"▶️ Agent {agent_name} started")
def on_agent_end(agent_name: str, result: str): def on_agent_end(agent_name: str, result: str):
print(f"✅ Agent {agent_name} completed: {result}") print(f"✅ Agent {agent_name} completed: {result}")
@ -122,10 +122,10 @@ agent = LlmAgent(
### **2. LLM Interaction Callbacks** ### **2. LLM Interaction Callbacks**
```python ```python
def on_llm_request(model: str, prompt: str): def on_llm_request(model: str, prompt: str):
print(f"🤖 LLM Request to {model}: {prompt[:50]}...") print(f"📤 LLM Request to {model}: {prompt[:50]}...")
def on_llm_response(model: str, response: str, tokens: int): def on_llm_response(model: str, response: str, tokens: int):
print(f"📝 LLM Response from {model}: {tokens} tokens") print(f"📥 LLM Response from {model}: {tokens} tokens")
# Register callbacks # Register callbacks
agent = LlmAgent( agent = LlmAgent(
@ -154,7 +154,7 @@ agent = LlmAgent(
) )
``` ```
## 🎯 Use Cases ## 📊 Use Cases
### **Monitoring & Analytics** ### **Monitoring & Analytics**
- Track agent performance metrics - Track agent performance metrics