AGT Server
Overview
System Overview
High-Level Architecture
Core Components
Student Clients
AGT Server
Game Engine
Game Layer
Stage Layer
Key Interfaces
Agent Interface
Game Interface
Stage Interface
How Everything Works Together
The Game Loop
Example: Rock Paper Scissors
Data Flow
1. Game Session Flow
2. Agent Interaction Flow
3. Tournament Flow
Lab-Specific Patterns
Lab 01: Matrix Games (RPS, BOS, Chicken)
Lab 02: Finite State Machines
Lab 03: Q-Learning
Lab 04: Spatial Games (Lemonade Stand)
Lab 06: Auctions
Key Concepts for Understanding
1. Observation Structure
2. Action Formats
3. Learning Patterns
Component Interactions
Error Handling
Next Steps
For Students
Getting Started for Students
Quick Setup
Install Dependencies
How Labs Work
Common Functions Across All Labs
The Three Required Methods
get_action(observation)
update(reward,
info)
reset()
Common State Management
Running Labs Locally
Test Your Agent
Debug Your Agent
Connecting to Server
1. Start Server
2. Connect Your Agent
Next Steps
Lab 01: Matrix Games
Game Overview
Games
Rock Paper Scissors (RPS)
Chicken Game
Prisoner’s Dilemma (PD)
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Performance Analysis
Next Steps
Lab 02: Finite State Machines
Game Overview
Games
Battle of the Sexes (BOS) Finite State
Battle of the Sexes II (BOSII)
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Key Concepts
State Machines
State-Dependent Strategies
Coordination
Testing
Local Testing
State Analysis
Expected Outcomes
Against Random Opponent
Against Coordinating Opponent
Next Steps
Lab 03: Q-Learning
Game Overview
Games
Chicken Game with Q-Learning
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Q-Table Analysis
Next Steps
Lab 04: The Lemonade Stand Game
Game Overview
Games
Lemonade Stand Game
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Location Analysis
Next Steps
Lab 06: Auctions
Game Overview
Games
Auction Game
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Bidding Analysis
Next Steps
Lab 07: Advanced Auctions
Game Overview
Games
Advanced Auction Game
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Budget Analysis
Next Steps
Lab 08: AdX One Day
Game Overview
Games
AdX One Day Game
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Campaign Analysis
Next Steps
Lab 09: AdX Two Day
Game Overview
Games
AdX Two Day Game
State Space
Observations
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Multi-day Analysis
Next Steps
For Administrators
Server Setup for Administrators
System Overview
Prerequisites
System Requirements
Dependencies
Installation
1. Clone Repository
2. Install Dependencies
3. Configure Server
Starting the Server
Basic Start
With Configuration
Production Deployment
Configuration Options
Network Settings
Game Settings
Tournament Settings
Monitoring
Log Files
Server Status
Performance Monitoring
Managing Tournaments
Start Tournament
Tournament Configuration
Results Collection
Troubleshooting
Common Issues
Server Won’t Start
Client Connection Issues
Game Execution Errors
Debug Mode
Security Considerations
Network Security
Access Control
Backup and Recovery
Data Backup
Recovery Procedures
Performance Optimization
Server Tuning
Scaling Considerations
Next Steps
Creating New Labs
Lab Creation Overview
Step 1: Design Your Game
Game Concept
Example: Coin Flip Game
Step 2: Implement the Game
2.1 Create Game Class
2.2 Understanding MatrixGame Pattern
2.3 Alternative: Custom Game Implementation
Step 3: Create Agent Examples
3.1 Random Agent
3.2 Example Solution
Step 4: Update Server Configuration
4.1 Add Game to Server
4.2 Import the Game
4.3 Create Configuration File
Step 5: Create Student Stencil
5.1 Stencil Structure
5.2 Student Agent Template
5.3 Example Solution
5.4 Test Script
Step 6: Create Documentation
6.1 Student Documentation
Actions
Rewards
Game Structure
Stage Type
Learning Opportunities
Testing
Local Testing
Next Steps
Step 8: Integration Checklist
8.1 Pre-Deployment Checklist
8.2 Testing Procedures
8.3 Validation Steps
Best Practices
Game Design
Implementation
Deployment
Common Pitfalls
Game Implementation
Agent Implementation
Server Integration
Next Steps
AGT Server
Index
Index