Maxlamenace1/Agent_Certification

🤖 Comprehensive Smol Agent

Built for the Hugging Face AI Agents Course Certificate Program

This Space demonstrates a production-ready AI agent built with the smolagents framework, showcasing all key concepts required for the Hugging Face AI Agents Course certificate.

🎯 Certificate Ready

This agent is designed to meet both certificate requirements:

• —✅ Fundamentals Certificate: Custom tools, agent framework, evaluation formatting
• —✅ Completion Certificate: GAIA evaluation support, API-ready responses

🚀 Features

Core Capabilities

• —9 Custom Tools: Time, math, notes, event search, web search, submissions
• —Safe Execution: AST-based math evaluation prevents code injection
• —Web Search: Real-time information retrieval via DuckDuckGo
• —Event Discovery: Smart event search with date parsing and location awareness
• —Note Management: Persistent note storage and retrieval
• —Evaluation Mode: Proper "FINAL ANSWER:" formatting for certificate submissions

Technical Excellence

• —Security: Safe code execution with restricted imports and AST evaluation
• —Robustness: Error handling and graceful degradation
• —Production Ready: Permission handling, logging, comprehensive testing
• —Compliance: JSON-line submission format for GAIA evaluation

🛠️ Available Tools

1. 1.get_current_time - Get current date and time
2. 2.calculate_basic_math - Safe mathematical calculations using AST
3. 3.save_note - Save text notes to files
4. 4.read_note - Read previously saved notes
5. 5.list_saved_notes - List all saved notes
6. 6.get_week_range - Get current week date range
7. 7.enhanced_event_search - Smart event discovery with date parsing
8. 8.save_submission - Save evaluation submissions in JSON-line format
9. 9.DuckDuckGoSearchTool - Web search capabilities

💬 Usage

Chat Mode

Use the Chat with Agent tab for general interaction:

• —Ask questions: "What's the current time?"
• —Perform calculations: "Calculate 25 * 17 + 3"
• —Search the web: "Find latest AI agent news"
• —Manage notes: "Save a note: Meeting at 3pm tomorrow"
• —Discover events: "What bachata events are happening this week in Brussels?"

GAIA Evaluation Mode

Use the GAIA Evaluation Mode tab for certificate evaluation:

• —Enter evaluation questions
• —Get properly formatted responses with "FINAL ANSWER:"
• —View clean answers ready for API submission

🏆 Certificate Demonstration

This agent demonstrates mastery of:

1. 1.Tool Creation - Custom tools using @tool decorator with proper metadata
2. 2.Agent Framework - Using smolagents and CodeAgent effectively
3. 3.Web Integration - Real-time data retrieval and processing
4. 4.Code Execution - Safe Python code generation and execution
5. 5.Evaluation Compliance - Proper formatting for certificate systems
6. 6.Production Quality - Security, error handling, and robustness

🔧 Technical Implementation

• —Framework: smolagents with CodeAgent
• —Model: Qwen/Qwen2.5-Coder-32B-Instruct
• —Interface: Gradio web UI with multiple interaction modes
• —Security: AST-based evaluation, restricted imports, permission handling
• —Deployment: Docker-based HuggingFace Space

📤 GAIA Evaluation Ready

This agent supports the GAIA evaluation process:

• —Properly formatted responses with "FINAL ANSWER:" prefix
• —Clean answer extraction for API submission
• —Task ID support for evaluation tracking
• —Automatic submission file generation in JSON-line format

🎓 Course Information

Course: Hugging Face AI Agents Course Certificate Requirements: Unit 1 + Use Case + Final Challenge Deadline: July 1st, 2025

This agent demonstrates production-ready AI agent development using modern best practices for security, robustness, and compliance with evaluation standards.