Files changed (1) hide show
  1. app.py +289 -121
app.py CHANGED
@@ -1,169 +1,341 @@
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(
@@ -172,25 +344,21 @@ with gr.Blocks() as demo:
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 json
4
+ import tempfile
5
+ from pathlib import Path
6
+
7
  import gradio as gr
8
  import requests
 
9
  import pandas as pd
10
 
11
+ from smolagents import CodeAgent, DuckDuckGoSearchTool, VisitWebpageTool, tool
12
+ from smolagents.models import InferenceClientModel
13
+
14
+
15
+ # ============================================================
16
+ # Constants
17
+ # ============================================================
18
  DEFAULT_API_URL = "https://agents-course-unit4-scoring.hf.space"
19
 
20
+
21
+ # ============================================================
22
+ # Helper tools
23
+ # ============================================================
24
+
25
+ @tool
26
+ def download_task_file(task_id: str) -> str:
27
+ """
28
+ Download the file attached to a GAIA task and return the local file path.
29
+ Use this when the question references an attached file/document/image/data file.
30
+ Args:
31
+ task_id: The task id of the GAIA question.
32
+ Returns:
33
+ Local file path of the downloaded file, or a message if no file is available.
34
+ """
35
+ api_url = os.getenv("SCORING_API_URL", DEFAULT_API_URL)
36
+ file_url = f"{api_url}/files/{task_id}"
37
+
38
+ try:
39
+ response = requests.get(file_url, timeout=60)
40
+ if response.status_code != 200:
41
+ return f"No downloadable file found for task {task_id}. HTTP {response.status_code}"
42
+
43
+ content_type = response.headers.get("content-type", "").lower()
44
+
45
+ # Try to infer extension
46
+ ext = ""
47
+ if "pdf" in content_type:
48
+ ext = ".pdf"
49
+ elif "json" in content_type:
50
+ ext = ".json"
51
+ elif "csv" in content_type:
52
+ ext = ".csv"
53
+ elif "text" in content_type:
54
+ ext = ".txt"
55
+ elif "html" in content_type:
56
+ ext = ".html"
57
+ elif "png" in content_type:
58
+ ext = ".png"
59
+ elif "jpeg" in content_type or "jpg" in content_type:
60
+ ext = ".jpg"
61
+ elif "excel" in content_type or "spreadsheet" in content_type:
62
+ ext = ".xlsx"
63
+
64
+ tmp_dir = tempfile.mkdtemp(prefix="gaia_task_")
65
+ file_path = os.path.join(tmp_dir, f"{task_id}{ext}")
66
+
67
+ with open(file_path, "wb") as f:
68
+ f.write(response.content)
69
+
70
+ return file_path
71
+ except Exception as e:
72
+ return f"Error downloading file for task {task_id}: {e}"
73
+
74
+
75
+ @tool
76
+ def read_local_text_file(file_path: str) -> str:
77
+ """
78
+ Read a local text-like file and return its contents.
79
+ Use this only for local TXT/JSON/CSV/HTML-like files after downloading them.
80
+ Args:
81
+ file_path: Path to a local file.
82
+ Returns:
83
+ File contents as text.
84
+ """
85
+ try:
86
+ path = Path(file_path)
87
+ if not path.exists():
88
+ return f"File not found: {file_path}"
89
+
90
+ # Try UTF-8 first, then fallback
91
+ try:
92
+ return path.read_text(encoding="utf-8")
93
+ except Exception:
94
+ return path.read_text(errors="ignore")
95
+ except Exception as e:
96
+ return f"Error reading file {file_path}: {e}"
97
+
98
+
99
+ # ============================================================
100
+ # Agent
101
+ # ============================================================
102
+
103
+ SYSTEM_PROMPT = """
104
+ You are solving a GAIA benchmark question.
105
+
106
+ Rules:
107
+ 1. Think carefully and use tools when needed.
108
+ 2. If the question mentions an attached file, download it using the download_task_file tool.
109
+ 3. If a downloaded file is text/csv/json/html-like, inspect it with read_local_text_file.
110
+ 4. If web information is needed, use the search/browser tools.
111
+ 5. Return ONLY the final answer.
112
+ 6. Do NOT return explanations.
113
+ 7. Do NOT return the words "FINAL ANSWER".
114
+ 8. Do NOT add markdown, bullet points, or surrounding quotes unless the answer itself requires quotes.
115
+ 9. Keep the answer as short and exact as possible.
116
+ """
117
+
118
  class BasicAgent:
119
  def __init__(self):
120
+ # You can change the model if needed, but this works well on HF Spaces
121
+ # and avoids the old HfApiModel import issue.
122
+ model_id = os.getenv("MODEL_ID", "Qwen/Qwen2.5-72B-Instruct")
123
+
124
+ self.model = InferenceClientModel(
125
+ model_id=model_id,
126
+ token=os.getenv("HF_TOKEN") or os.getenv("HUGGINGFACEHUB_API_TOKEN"),
127
+ )
128
+
129
+ self.agent = CodeAgent(
130
+ tools=[
131
+ DuckDuckGoSearchTool(),
132
+ VisitWebpageTool(),
133
+ download_task_file,
134
+ read_local_text_file,
135
+ ],
136
+ model=self.model,
137
+ additional_authorized_imports=[
138
+ "json",
139
+ "re",
140
+ "math",
141
+ "statistics",
142
+ "csv",
143
+ "pandas",
144
+ "pathlib",
145
+ ],
146
+ max_steps=12,
147
+ verbosity_level=1,
148
+ )
149
+
150
+ print(f"BasicAgent initialized with model: {model_id}")
151
+
152
+ def clean_final_answer(self, answer: str) -> str:
153
+ """
154
+ Clean the model output for exact-match scoring.
155
+ """
156
+ if answer is None:
157
+ return ""
158
+
159
+ answer = str(answer).strip()
160
+
161
+ # Remove common prefixes the model may add
162
+ answer = re.sub(r"^\s*FINAL ANSWER\s*[:\-]?\s*", "", answer, flags=re.IGNORECASE)
163
+ answer = re.sub(r"^\s*Answer\s*[:\-]?\s*", "", answer, flags=re.IGNORECASE)
164
+ answer = re.sub(r"^\s*The answer is\s*", "", answer, flags=re.IGNORECASE)
165
+
166
+ # Remove enclosing markdown/code fences if any
167
+ answer = answer.strip().strip("`").strip()
168
+
169
+ # If it returns quoted answer like "Paris", remove only outer quotes
170
+ if len(answer) >= 2 and (
171
+ (answer.startswith('"') and answer.endswith('"')) or
172
+ (answer.startswith("'") and answer.endswith("'"))
173
+ ):
174
+ answer = answer[1:-1].strip()
175
+
176
+ return answer.strip()
177
+
178
+ def __call__(self, question: str, task_id: str | None = None) -> str:
179
+ """
180
+ Run the agent on a question and return a clean final answer.
181
+ """
182
+ prompt = f"{SYSTEM_PROMPT}\n\nTask ID: {task_id}\nQuestion:\n{question}\n"
183
+ print(f"Running agent for task_id={task_id}")
184
+
185
+ try:
186
+ result = self.agent.run(prompt)
187
+ cleaned = self.clean_final_answer(result)
188
+ print(f"Agent raw result: {result}")
189
+ print(f"Agent cleaned result: {cleaned}")
190
+ return cleaned
191
+ except Exception as e:
192
+ print(f"Agent failed on task {task_id}: {e}")
193
+ return f"ERROR: {e}"
194
+
195
+
196
+ # ============================================================
197
+ # Main runner
198
+ # ============================================================
199
+
200
+ def run_and_submit_all(profile: gr.OAuthProfile | None):
201
  """
202
+ Fetch all questions, run the agent, submit answers, and display results.
 
203
  """
204
+ space_id = os.getenv("SPACE_ID")
205
+ api_url = os.getenv("SCORING_API_URL", DEFAULT_API_URL)
206
 
207
  if profile:
208
+ username = profile.username.strip()
209
  print(f"User logged in: {username}")
210
  else:
211
+ return "Please login to Hugging Face first.", None
212
+
213
+ if not space_id:
214
+ # Fallback so submission still works locally if needed
215
+ agent_code = "LOCAL_RUN_NO_SPACE_ID"
216
+ print("SPACE_ID not found. Using LOCAL_RUN_NO_SPACE_ID")
217
+ else:
218
+ agent_code = f"https://huggingface.co/spaces/{space_id}/tree/main"
219
 
 
220
  questions_url = f"{api_url}/questions"
221
  submit_url = f"{api_url}/submit"
222
 
223
+ # 1) Build agent
224
  try:
225
  agent = BasicAgent()
226
  except Exception as e:
 
227
  return f"Error initializing agent: {e}", None
 
 
 
228
 
229
+ # 2) Fetch questions
230
+ print(f"Fetching questions from {questions_url}")
231
  try:
232
+ response = requests.get(questions_url, timeout=60)
233
  response.raise_for_status()
234
  questions_data = response.json()
235
+
236
+ if not isinstance(questions_data, list) or len(questions_data) == 0:
237
+ return "Questions endpoint returned empty/invalid data.", None
238
+
239
  print(f"Fetched {len(questions_data)} questions.")
 
 
 
 
 
 
 
240
  except Exception as e:
241
+ return f"Error fetching questions: {e}", None
 
242
 
243
+ # 3) Solve questions
 
244
  answers_payload = []
245
+ results_log = []
246
+
247
  for item in questions_data:
248
  task_id = item.get("task_id")
249
+ question_text = item.get("question", "")
250
+
251
+ if not task_id or not question_text:
252
+ results_log.append({
253
+ "Task ID": item.get("task_id", "UNKNOWN"),
254
+ "Question": item.get("question", ""),
255
+ "Submitted Answer": "SKIPPED: Missing task_id or question"
256
+ })
257
  continue
258
+
259
  try:
260
+ submitted_answer = agent(question_text, task_id=task_id)
 
 
261
  except Exception as e:
262
+ submitted_answer = f"ERROR: {e}"
263
+
264
+ answers_payload.append({
265
+ "task_id": task_id,
266
+ "submitted_answer": str(submitted_answer).strip()
267
+ })
268
+
269
+ results_log.append({
270
+ "Task ID": task_id,
271
+ "Question": question_text,
272
+ "Submitted Answer": submitted_answer
273
+ })
274
 
275
  if not answers_payload:
276
+ return "No answers were generated.", pd.DataFrame(results_log)
277
+
278
+ # 4) Submit
279
+ submission_data = {
280
+ "username": username,
281
+ "agent_code": agent_code,
282
+ "answers": answers_payload
283
+ }
284
 
285
+ print("Submitting payload...")
286
+ print(json.dumps({
287
+ "username": username,
288
+ "agent_code": agent_code,
289
+ "answers_count": len(answers_payload)
290
+ }, indent=2))
291
 
 
 
292
  try:
293
+ response = requests.post(submit_url, json=submission_data, timeout=180)
294
  response.raise_for_status()
295
  result_data = response.json()
296
+
297
  final_status = (
298
  f"Submission Successful!\n"
299
+ f"User: {result_data.get('username', username)}\n"
300
  f"Overall Score: {result_data.get('score', 'N/A')}% "
301
  f"({result_data.get('correct_count', '?')}/{result_data.get('total_attempted', '?')} correct)\n"
302
  f"Message: {result_data.get('message', 'No message received.')}"
303
  )
304
+
305
+ return final_status, pd.DataFrame(results_log)
306
+
307
  except requests.exceptions.HTTPError as e:
308
+ detail = f"HTTP {e.response.status_code}"
309
  try:
310
+ detail_json = e.response.json()
311
+ detail += f" | {detail_json}"
312
+ except Exception:
313
+ detail += f" | {e.response.text[:1000]}"
314
+ return f"Submission failed: {detail}", pd.DataFrame(results_log)
315
+
 
 
 
 
 
 
 
 
 
 
 
 
316
  except Exception as e:
317
+ return f"Submission failed: {e}", pd.DataFrame(results_log)
318
+
 
 
319
 
320
+ # ============================================================
321
+ # Gradio UI
322
+ # ============================================================
323
 
 
324
  with gr.Blocks() as demo:
325
+ gr.Markdown("# GAIA Unit 4 Agent Evaluation Runner")
326
  gr.Markdown(
327
  """
328
+ **Instructions**
329
+ 1. Login with your Hugging Face account.
330
+ 2. Click **Run Evaluation & Submit All Answers**.
331
+ 3. The app will fetch questions, run the agent, and submit the answers.
 
 
 
 
 
 
332
  """
333
  )
334
 
335
  gr.LoginButton()
 
336
  run_button = gr.Button("Run Evaluation & Submit All Answers")
337
 
338
+ status_output = gr.Textbox(label="Run Status / Submission Result", lines=6, interactive=False)
 
339
  results_table = gr.DataFrame(label="Questions and Agent Answers", wrap=True)
340
 
341
  run_button.click(
 
344
  )
345
 
346
  if __name__ == "__main__":
347
+ print("\n" + "-" * 30 + " App Starting " + "-" * 30)
 
 
 
 
 
 
 
 
 
348
 
349
+ space_host = os.getenv("SPACE_HOST")
350
+ space_id = os.getenv("SPACE_ID")
351
+
352
+ if space_host:
353
+ print(f"SPACE_HOST: {space_host}")
354
  else:
355
+ print("SPACE_HOST not found.")
356
 
357
+ if space_id:
358
+ print(f"SPACE_ID: {space_id}")
359
+ print(f"Repo Tree URL: https://huggingface.co/spaces/{space_id}/tree/main")
360
+ else:
361
+ print("SPACE_ID not found.")
362
 
363
+ print("Launching app...")
364
+ demo.launch(debug=True)