Files changed (1) hide show
  1. app.py +200 -149
app.py CHANGED
@@ -1,196 +1,247 @@
1
  import os
 
 
 
 
2
  import gradio as gr
3
- import requests
4
- import inspect
5
  import pandas as pd
 
 
 
 
 
 
 
 
6
 
7
- # (Keep Constants as is)
8
- # --- Constants ---
9
  DEFAULT_API_URL = "https://agents-course-unit4-scoring.hf.space"
 
 
 
 
10
 
11
- # --- Basic Agent Definition ---
12
- # ----- THIS IS WERE YOU CAN BUILD WHAT YOU WANT ------
13
- class BasicAgent:
14
- def __init__(self):
15
- print("BasicAgent initialized.")
16
- def __call__(self, question: str) -> str:
17
- print(f"Agent received question (first 50 chars): {question[:50]}...")
18
- fixed_answer = "This is a default answer."
19
- print(f"Agent returning fixed answer: {fixed_answer}")
20
- return fixed_answer
21
-
22
- def run_and_submit_all( profile: gr.OAuthProfile | None):
23
  """
24
- Fetches all questions, runs the BasicAgent on them, submits all answers,
25
- and displays the results.
 
 
 
 
 
 
 
 
 
 
 
26
  """
27
- # --- Determine HF Space Runtime URL and Repo URL ---
28
- space_id = os.getenv("SPACE_ID") # Get the SPACE_ID for sending link to the code
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
29
 
30
- if profile:
31
- username= f"{profile.username}"
32
- print(f"User logged in: {username}")
33
- else:
34
- print("User not logged in.")
35
- return "Please Login to Hugging Face with the button.", None
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
36
 
37
  api_url = DEFAULT_API_URL
38
- questions_url = f"{api_url}/questions"
39
- submit_url = f"{api_url}/submit"
40
 
41
- # 1. Instantiate Agent ( modify this part to create your agent)
42
  try:
43
- agent = BasicAgent()
44
  except Exception as e:
45
- print(f"Error instantiating agent: {e}")
46
  return f"Error initializing agent: {e}", None
47
- # In the case of an app running as a hugging Face space, this link points toward your codebase ( usefull for others so please keep it public)
48
- agent_code = f"https://huggingface.co/spaces/{space_id}/tree/main"
49
- print(agent_code)
50
 
51
- # 2. Fetch Questions
52
- print(f"Fetching questions from: {questions_url}")
53
  try:
54
- response = requests.get(questions_url, timeout=15)
55
  response.raise_for_status()
56
- questions_data = response.json()
57
- if not questions_data:
58
- print("Fetched questions list is empty.")
59
- return "Fetched questions list is empty or invalid format.", None
60
- print(f"Fetched {len(questions_data)} questions.")
61
- except requests.exceptions.RequestException as e:
62
- print(f"Error fetching questions: {e}")
63
- return f"Error fetching questions: {e}", None
64
- except requests.exceptions.JSONDecodeError as e:
65
- print(f"Error decoding JSON response from questions endpoint: {e}")
66
- print(f"Response text: {response.text[:500]}")
67
- return f"Error decoding server response for questions: {e}", None
68
  except Exception as e:
69
- print(f"An unexpected error occurred fetching questions: {e}")
70
- return f"An unexpected error occurred fetching questions: {e}", None
71
 
72
- # 3. Run your Agent
73
  results_log = []
74
  answers_payload = []
75
- print(f"Running agent on {len(questions_data)} questions...")
76
- for item in questions_data:
77
  task_id = item.get("task_id")
78
  question_text = item.get("question")
 
79
  if not task_id or question_text is None:
80
- print(f"Skipping item with missing task_id or question: {item}")
81
  continue
 
82
  try:
83
- submitted_answer = agent(question_text)
84
- answers_payload.append({"task_id": task_id, "submitted_answer": submitted_answer})
85
- results_log.append({"Task ID": task_id, "Question": question_text, "Submitted Answer": submitted_answer})
86
  except Exception as e:
87
- print(f"Error running agent on task {task_id}: {e}")
88
- results_log.append({"Task ID": task_id, "Question": question_text, "Submitted Answer": f"AGENT ERROR: {e}"})
 
 
 
 
 
 
 
 
 
 
89
 
90
  if not answers_payload:
91
- print("Agent did not produce any answers to submit.")
92
- return "Agent did not produce any answers to submit.", pd.DataFrame(results_log)
93
-
94
- # 4. Prepare Submission
95
- submission_data = {"username": username.strip(), "agent_code": agent_code, "answers": answers_payload}
96
- status_update = f"Agent finished. Submitting {len(answers_payload)} answers for user '{username}'..."
97
- print(status_update)
98
 
99
- # 5. Submit
100
- print(f"Submitting {len(answers_payload)} answers to: {submit_url}")
 
 
 
101
  try:
102
- response = requests.post(submit_url, json=submission_data, timeout=60)
103
  response.raise_for_status()
104
- result_data = response.json()
105
- final_status = (
106
- f"Submission Successful!\n"
107
- f"User: {result_data.get('username')}\n"
108
- f"Overall Score: {result_data.get('score', 'N/A')}% "
109
- f"({result_data.get('correct_count', '?')}/{result_data.get('total_attempted', '?')} correct)\n"
110
- f"Message: {result_data.get('message', 'No message received.')}"
111
  )
112
- print("Submission successful.")
113
- results_df = pd.DataFrame(results_log)
114
- return final_status, results_df
115
- except requests.exceptions.HTTPError as e:
116
- error_detail = f"Server responded with status {e.response.status_code}."
117
- try:
118
- error_json = e.response.json()
119
- error_detail += f" Detail: {error_json.get('detail', e.response.text)}"
120
- except requests.exceptions.JSONDecodeError:
121
- error_detail += f" Response: {e.response.text[:500]}"
122
- status_message = f"Submission Failed: {error_detail}"
123
- print(status_message)
124
- results_df = pd.DataFrame(results_log)
125
- return status_message, results_df
126
- except requests.exceptions.Timeout:
127
- status_message = "Submission Failed: The request timed out."
128
- print(status_message)
129
- results_df = pd.DataFrame(results_log)
130
- return status_message, results_df
131
- except requests.exceptions.RequestException as e:
132
- status_message = f"Submission Failed: Network error - {e}"
133
- print(status_message)
134
- results_df = pd.DataFrame(results_log)
135
- return status_message, results_df
136
  except Exception as e:
137
- status_message = f"An unexpected error occurred during submission: {e}"
138
- print(status_message)
139
- results_df = pd.DataFrame(results_log)
140
- return status_message, results_df
141
 
142
 
143
- # --- Build Gradio Interface using Blocks ---
 
 
144
  with gr.Blocks() as demo:
145
- gr.Markdown("# Basic Agent Evaluation Runner")
146
  gr.Markdown(
147
- """
148
- **Instructions:**
149
-
150
- 1. Please clone this space, then modify the code to define your agent's logic, the tools, the necessary packages, etc ...
151
- 2. Log in to your Hugging Face account using the button below. This uses your HF username for submission.
152
- 3. Click 'Run Evaluation & Submit All Answers' to fetch questions, run your agent, submit answers, and see the score.
153
-
154
- ---
155
- **Disclaimers:**
156
- Once clicking on the "submit button, it can take quite some time ( this is the time for the agent to go through all the questions).
157
- This space provides a basic setup and is intentionally sub-optimal to encourage you to develop your own, more robust solution. For instance for the delay process of the submit button, a solution could be to cache the answers and submit in a seperate action or even to answer the questions in async.
158
- """
159
  )
160
-
161
  gr.LoginButton()
162
-
163
  run_button = gr.Button("Run Evaluation & Submit All Answers")
164
-
165
- status_output = gr.Textbox(label="Run Status / Submission Result", lines=5, interactive=False)
166
- # Removed max_rows=10 from DataFrame constructor
167
  results_table = gr.DataFrame(label="Questions and Agent Answers", wrap=True)
168
 
169
- run_button.click(
170
- fn=run_and_submit_all,
171
- outputs=[status_output, results_table]
172
- )
173
 
174
  if __name__ == "__main__":
175
- print("\n" + "-"*30 + " App Starting " + "-"*30)
176
- # Check for SPACE_HOST and SPACE_ID at startup for information
177
- space_host_startup = os.getenv("SPACE_HOST")
178
- space_id_startup = os.getenv("SPACE_ID") # Get SPACE_ID at startup
179
-
180
- if space_host_startup:
181
- print(f"✅ SPACE_HOST found: {space_host_startup}")
182
- print(f" Runtime URL should be: https://{space_host_startup}.hf.space")
183
- else:
184
- print("ℹ️ SPACE_HOST environment variable not found (running locally?).")
185
-
186
- if space_id_startup: # Print repo URLs if SPACE_ID is found
187
- print(f"✅ SPACE_ID found: {space_id_startup}")
188
- print(f" Repo URL: https://huggingface.co/spaces/{space_id_startup}")
189
- print(f" Repo Tree URL: https://huggingface.co/spaces/{space_id_startup}/tree/main")
190
- else:
191
- print("ℹ️ SPACE_ID environment variable not found (running locally?). Repo URL cannot be determined.")
192
-
193
- print("-"*(60 + len(" App Starting ")) + "\n")
194
-
195
- print("Launching Gradio Interface for Basic Agent Evaluation...")
196
  demo.launch(debug=True, share=False)
 
1
  import os
2
+ import re
3
+ import subprocess
4
+ import time
5
+
6
  import gradio as gr
 
 
7
  import pandas as pd
8
+ import requests
9
+ from smolagents import (
10
+ CodeAgent,
11
+ DuckDuckGoSearchTool,
12
+ LiteLLMModel,
13
+ VisitWebpageTool,
14
+ tool,
15
+ )
16
 
 
 
17
  DEFAULT_API_URL = "https://agents-course-unit4-scoring.hf.space"
18
+ MODEL_ID = os.getenv("MODEL_ID", "gemini/gemini-2.0-flash") # modele du LLM (changeable via les variables du Space)
19
+ PAUSE_BETWEEN_QUESTIONS = 8 # secondes, pour eviter les limites de requetes gratuites
20
+ FILES_DIR = "/tmp/task_files"
21
+ os.makedirs(FILES_DIR, exist_ok=True)
22
 
23
+
24
+ # ----------------------------------------------------------------------------
25
+ # Outils personnalises
26
+ # ----------------------------------------------------------------------------
27
+ @tool
28
+ def read_excel_file(path: str) -> str:
29
+ """Reads an Excel file (.xlsx) and returns all its sheets as text.
30
+
31
+ Args:
32
+ path: Local path of the Excel file.
 
 
33
  """
34
+ sheets = pd.read_excel(path, sheet_name=None)
35
+ out = []
36
+ for name, df in sheets.items():
37
+ out.append(f"--- Sheet: {name} ---\n{df.to_string()}")
38
+ return "\n\n".join(out)
39
+
40
+
41
+ @tool
42
+ def read_text_file(path: str) -> str:
43
+ """Reads a text or code file (.py, .txt, .csv...) and returns its content.
44
+
45
+ Args:
46
+ path: Local path of the file.
47
  """
48
+ with open(path, "r", encoding="utf-8", errors="ignore") as f:
49
+ return f.read()
50
+
51
+
52
+ @tool
53
+ def run_python_file(path: str) -> str:
54
+ """Runs a Python file and returns what it prints (stdout and stderr).
55
+
56
+ Args:
57
+ path: Local path of the Python file to run.
58
+ """
59
+ try:
60
+ result = subprocess.run(
61
+ ["python", path], capture_output=True, text=True, timeout=60
62
+ )
63
+ return (result.stdout + result.stderr).strip()
64
+ except Exception as e:
65
+ return f"Execution error: {e}"
66
+
67
+
68
+ @tool
69
+ def transcribe_audio(path: str) -> str:
70
+ """Transcribes an audio file (mp3, wav...) to text using Whisper on Groq.
71
+
72
+ Args:
73
+ path: Local path of the audio file.
74
+ """
75
+ api_key = os.getenv("GROQ_API_KEY")
76
+ if not api_key:
77
+ return "Error: GROQ_API_KEY is not set in the Space secrets."
78
+ with open(path, "rb") as f:
79
+ response = requests.post(
80
+ "https://api.groq.com/openai/v1/audio/transcriptions",
81
+ headers={"Authorization": f"Bearer {api_key}"},
82
+ files={"file": (os.path.basename(path), f)},
83
+ data={"model": "whisper-large-v3"},
84
+ timeout=120,
85
+ )
86
+ if response.status_code != 200:
87
+ return f"Transcription error {response.status_code}: {response.text[:300]}"
88
+ return response.json().get("text", "")
89
+
90
+
91
+ # ----------------------------------------------------------------------------
92
+ # Agent
93
+ # ----------------------------------------------------------------------------
94
+ SYSTEM_RULES = """You are answering questions from the GAIA benchmark. Be precise.
95
+ Rules for your final answer:
96
+ - Reply with ONLY the final answer. No explanation, no sentence, no 'FINAL ANSWER'.
97
+ - Numbers: write digits only, without units or thousands separators, unless the question asks otherwise.
98
+ - Lists: comma-separated, in the order requested (alphabetical or ascending if asked).
99
+ - Strings: no articles, no abbreviations unless the question asks for them.
100
+ - Use web search and visit_webpage to verify facts instead of guessing.
101
+ - If a file path is given, use the provided file tools to read it.
102
+ """
103
+
104
+
105
+ class GaiaAgent:
106
+ def __init__(self):
107
+ model = LiteLLMModel(
108
+ model_id=MODEL_ID,
109
+ api_key=os.getenv("GEMINI_API_KEY"),
110
+ )
111
+ self.agent = CodeAgent(
112
+ tools=[
113
+ DuckDuckGoSearchTool(),
114
+ VisitWebpageTool(),
115
+ read_excel_file,
116
+ read_text_file,
117
+ run_python_file,
118
+ transcribe_audio,
119
+ ],
120
+ model=model,
121
+ max_steps=12,
122
+ additional_authorized_imports=[
123
+ "pandas", "numpy", "re", "json", "math", "datetime",
124
+ "itertools", "collections", "statistics", "unicodedata",
125
+ "requests", "bs4",
126
+ ],
127
+ verbosity_level=0,
128
+ )
129
 
130
+ def __call__(self, question: str, file_path: str | None = None) -> str:
131
+ prompt = f"{SYSTEM_RULES}\nQuestion: {question}"
132
+ if file_path:
133
+ prompt += f"\n\nAn attached file is available locally at: {file_path}"
134
+ answer = str(self.agent.run(prompt)).strip()
135
+ answer = re.sub(r"^\s*final answer\s*:\s*", "", answer, flags=re.IGNORECASE)
136
+ return answer.strip().strip('"').strip()
137
+
138
+
139
+ def download_task_file(api_url: str, task_id: str, file_name: str) -> str | None:
140
+ """Telecharge le fichier associe a une question (si elle en a un)."""
141
+ if not file_name:
142
+ return None
143
+ try:
144
+ r = requests.get(f"{api_url}/files/{task_id}", timeout=60)
145
+ r.raise_for_status()
146
+ local_path = os.path.join(FILES_DIR, file_name)
147
+ with open(local_path, "wb") as f:
148
+ f.write(r.content)
149
+ return local_path
150
+ except Exception as e:
151
+ print(f"Could not download file for {task_id}: {e}")
152
+ return None
153
+
154
+
155
+ # ----------------------------------------------------------------------------
156
+ # Evaluation + soumission
157
+ # ----------------------------------------------------------------------------
158
+ def run_and_submit_all(profile: gr.OAuthProfile | None):
159
+ space_id = os.getenv("SPACE_ID")
160
+
161
+ if not profile:
162
+ return "Please log in to Hugging Face with the button.", None
163
+ username = profile.username
164
 
165
  api_url = DEFAULT_API_URL
166
+ agent_code = f"https://huggingface.co/spaces/{space_id}/tree/main"
 
167
 
 
168
  try:
169
+ agent = GaiaAgent()
170
  except Exception as e:
 
171
  return f"Error initializing agent: {e}", None
 
 
 
172
 
 
 
173
  try:
174
+ response = requests.get(f"{api_url}/questions", timeout=30)
175
  response.raise_for_status()
176
+ questions = response.json()
 
 
 
 
 
 
 
 
 
 
 
177
  except Exception as e:
178
+ return f"Error fetching questions: {e}", None
 
179
 
 
180
  results_log = []
181
  answers_payload = []
182
+ for i, item in enumerate(questions):
 
183
  task_id = item.get("task_id")
184
  question_text = item.get("question")
185
+ file_name = item.get("file_name", "")
186
  if not task_id or question_text is None:
 
187
  continue
188
+ file_path = download_task_file(api_url, task_id, file_name)
189
  try:
190
+ answer = agent(question_text, file_path)
 
 
191
  except Exception as e:
192
+ print(f"Error on task {task_id}: {e}")
193
+ answer = "AGENT ERROR"
194
+ answers_payload.append({"task_id": task_id, "submitted_answer": answer})
195
+ results_log.append(
196
+ {
197
+ "Task ID": task_id,
198
+ "Question": question_text[:150],
199
+ "Submitted Answer": answer,
200
+ }
201
+ )
202
+ print(f"[{i + 1}/{len(questions)}] {answer}")
203
+ time.sleep(PAUSE_BETWEEN_QUESTIONS)
204
 
205
  if not answers_payload:
206
+ return "Agent did not produce any answers.", pd.DataFrame(results_log)
 
 
 
 
 
 
207
 
208
+ submission = {
209
+ "username": username.strip(),
210
+ "agent_code": agent_code,
211
+ "answers": answers_payload,
212
+ }
213
  try:
214
+ response = requests.post(f"{api_url}/submit", json=submission, timeout=120)
215
  response.raise_for_status()
216
+ data = response.json()
217
+ status = (
218
+ "Submission successful!\n"
219
+ f"User: {data.get('username')}\n"
220
+ f"Score: {data.get('score')}% "
221
+ f"({data.get('correct_count')}/{data.get('total_attempted')} correct)\n"
222
+ f"Message: {data.get('message')}"
223
  )
224
+ return status, pd.DataFrame(results_log)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
225
  except Exception as e:
226
+ return f"Submission failed: {e}", pd.DataFrame(results_log)
 
 
 
227
 
228
 
229
+ # ----------------------------------------------------------------------------
230
+ # Interface Gradio
231
+ # ----------------------------------------------------------------------------
232
  with gr.Blocks() as demo:
233
+ gr.Markdown("# Agent Evaluation Runner")
234
  gr.Markdown(
235
+ "1. Log in with your Hugging Face account.\n"
236
+ "2. Click the button: the agent answers the 20 questions and submits them.\n"
237
+ "3. This can take 10 to 20 minutes. Keep the page open."
 
 
 
 
 
 
 
 
 
238
  )
 
239
  gr.LoginButton()
 
240
  run_button = gr.Button("Run Evaluation & Submit All Answers")
241
+ status_output = gr.Textbox(label="Run Status / Submission Result", lines=6, interactive=False)
 
 
242
  results_table = gr.DataFrame(label="Questions and Agent Answers", wrap=True)
243
 
244
+ run_button.click(fn=run_and_submit_all, outputs=[status_output, results_table])
 
 
 
245
 
246
  if __name__ == "__main__":
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
247
  demo.launch(debug=True, share=False)