Files changed (1) hide show
  1. app.py +189 -126
app.py CHANGED
@@ -1,103 +1,221 @@
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()
@@ -107,90 +225,35 @@ def run_and_submit_all( profile: gr.OAuthProfile | None):
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 inspect
3
+ import requests
4
  import pandas as pd
5
+ import gradio as gr
6
+
7
+ from smolagents import CodeAgent, LiteLLMModel, DuckDuckGoSearchTool, VisitWebpageTool, tool
8
 
 
9
  # --- Constants ---
10
  DEFAULT_API_URL = "https://agents-course-unit4-scoring.hf.space"
11
 
12
+
13
+ # ---------------------------------------------------------------------------
14
+ # Custom tools for file-based question types (audio, images, python files)
15
+ # ---------------------------------------------------------------------------
16
+
17
+ @tool
18
+ def transcribe_audio(file_path: str) -> str:
19
+ """
20
+ Transcribes an audio file (mp3/wav) to text using OpenAI Whisper.
21
+
22
+ Args:
23
+ file_path: Local path to the audio file to transcribe.
24
+
25
+ Returns:
26
+ The transcribed text.
27
+ """
28
+ from openai import OpenAI
29
+ client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
30
+ with open(file_path, "rb") as f:
31
+ transcript = client.audio.transcriptions.create(
32
+ model="whisper-1",
33
+ file=f
34
+ )
35
+ return transcript.text
36
+
37
+
38
+ @tool
39
+ def analyze_image(file_path: str, question: str) -> str:
40
+ """
41
+ Analyzes an image (e.g. a chess position) using a vision-capable LLM
42
+ and answers a question about it.
43
+
44
+ Args:
45
+ file_path: Local path to the image file.
46
+ question: The question to answer about the image.
47
+
48
+ Returns:
49
+ The model's answer about the image.
50
+ """
51
+ import base64
52
+ from openai import OpenAI
53
+ client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
54
+
55
+ with open(file_path, "rb") as f:
56
+ b64_image = base64.b64encode(f.read()).decode("utf-8")
57
+
58
+ response = client.chat.completions.create(
59
+ model="gpt-4o",
60
+ messages=[{
61
+ "role": "user",
62
+ "content": [
63
+ {"type": "text", "text": question},
64
+ {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{b64_image}"}}
65
+ ]
66
+ }]
67
+ )
68
+ return response.choices[0].message.content
69
+
70
+
71
+ @tool
72
+ def run_python_file(file_path: str) -> str:
73
+ """
74
+ Reads and returns the contents of a Python (.py) file so the agent
75
+ can analyze or trace through the code to determine its output.
76
+
77
+ Args:
78
+ file_path: Local path to the python file.
79
+
80
+ Returns:
81
+ The raw source code as text.
82
+ """
83
+ with open(file_path, "r") as f:
84
+ return f.read()
85
+
86
+
87
+ @tool
88
+ def read_excel_file(file_path: str) -> str:
89
+ """
90
+ Reads an Excel (.xlsx) file and returns its contents as a string table.
91
+
92
+ Args:
93
+ file_path: Local path to the Excel file.
94
+
95
+ Returns:
96
+ A string representation of the spreadsheet data.
97
+ """
98
+ df = pd.read_excel(file_path)
99
+ return df.to_string()
100
+
101
+
102
+ # ---------------------------------------------------------------------------
103
+ # The Agent
104
+ # ---------------------------------------------------------------------------
105
+
106
  class BasicAgent:
107
  def __init__(self):
108
  print("BasicAgent initialized.")
 
 
 
 
 
109
 
110
+ # LiteLLM lets you swap providers by just changing model_id, e.g.:
111
+ # "gpt-4o-mini", "claude-3-5-sonnet-20241022", "huggingface/Qwen/Qwen2.5-72B-Instruct"
112
+ self.model = LiteLLMModel(
113
+ model_id="gpt-4o-mini",
114
+ api_key=os.environ.get("OPENAI_API_KEY"),
115
+ )
116
+
117
+ self.agent = CodeAgent(
118
+ model=self.model,
119
+ tools=[
120
+ DuckDuckGoSearchTool(),
121
+ VisitWebpageTool(),
122
+ transcribe_audio,
123
+ analyze_image,
124
+ run_python_file,
125
+ read_excel_file,
126
+ ],
127
+ max_steps=8,
128
+ )
129
+
130
+ def __call__(self, question: str, file_path: str = None) -> str:
131
+ print(f"Agent received question (first 80 chars): {question[:80]}...")
132
+
133
+ prompt = question
134
+ if file_path:
135
+ prompt += f"\n\nA file has been downloaded for this question at local path: {file_path}. Use the appropriate tool to read it before answering."
136
+
137
+ prompt += "\n\nIMPORTANT: Respond with ONLY the final answer. No explanation, no 'FINAL ANSWER:' prefix, just the answer itself, formatted exactly as requested in the question."
138
+
139
+ try:
140
+ answer = self.agent.run(prompt)
141
+ except Exception as e:
142
+ print(f"Agent error: {e}")
143
+ answer = "ERROR"
144
+
145
+ answer = str(answer).strip()
146
+ print(f"Agent returning answer: {answer}")
147
+ return answer
148
+
149
+
150
+ # ---------------------------------------------------------------------------
151
+ # Evaluation + submission logic
152
+ # ---------------------------------------------------------------------------
153
+
154
+ def run_and_submit_all(profile: gr.OAuthProfile | None):
155
+ space_id = os.getenv("SPACE_ID")
156
 
157
  if profile:
158
+ username = profile.username
159
  print(f"User logged in: {username}")
160
  else:
161
+ return "Please log in to Hugging Face first.", None
 
162
 
163
  api_url = DEFAULT_API_URL
164
  questions_url = f"{api_url}/questions"
165
+ files_url = f"{api_url}/files"
166
  submit_url = f"{api_url}/submit"
167
 
168
+ agent = BasicAgent()
 
 
 
 
 
 
169
  agent_code = f"https://huggingface.co/spaces/{space_id}/tree/main"
 
170
 
171
+ # 1. Fetch questions
 
172
  try:
173
  response = requests.get(questions_url, timeout=15)
174
  response.raise_for_status()
175
  questions_data = response.json()
 
 
 
 
 
 
 
 
 
 
 
176
  except Exception as e:
177
+ return f"Error fetching questions: {e}", None
 
178
 
 
179
  results_log = []
180
  answers_payload = []
181
+
182
  for item in questions_data:
183
  task_id = item.get("task_id")
184
  question_text = item.get("question")
185
+ file_name = item.get("file_name", "")
186
+
187
  if not task_id or question_text is None:
 
188
  continue
189
+
190
+ file_path = None
191
+ if file_name:
192
+ try:
193
+ file_resp = requests.get(f"{files_url}/{task_id}", timeout=30)
194
+ file_resp.raise_for_status()
195
+ file_path = f"/tmp/{file_name}"
196
+ with open(file_path, "wb") as f:
197
+ f.write(file_resp.content)
198
+ except Exception as e:
199
+ print(f"Could not download file for {task_id}: {e}")
200
+
201
  try:
202
+ submitted_answer = agent(question_text, file_path)
 
 
203
  except Exception as e:
204
+ submitted_answer = f"AGENT ERROR: {e}"
205
+
206
+ answers_payload.append({"task_id": task_id, "submitted_answer": submitted_answer})
207
+ results_log.append({"Task ID": task_id, "Question": question_text, "Submitted Answer": submitted_answer})
208
 
209
  if not answers_payload:
210
+ return "No answers were generated.", pd.DataFrame(results_log)
 
211
 
212
+ # 2. Submit
213
+ submission_data = {
214
+ "username": username.strip(),
215
+ "agent_code": agent_code,
216
+ "answers": answers_payload
217
+ }
218
 
 
 
219
  try:
220
  response = requests.post(submit_url, json=submission_data, timeout=60)
221
  response.raise_for_status()
 
225
  f"User: {result_data.get('username')}\n"
226
  f"Overall Score: {result_data.get('score', 'N/A')}% "
227
  f"({result_data.get('correct_count', '?')}/{result_data.get('total_attempted', '?')} correct)\n"
228
+ f"Message: {result_data.get('message', '')}"
229
  )
230
+ return final_status, pd.DataFrame(results_log)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
231
  except Exception as e:
232
+ return f"Submission failed: {e}", pd.DataFrame(results_log)
233
+
 
 
234
 
235
+ # ---------------------------------------------------------------------------
236
+ # Gradio UI
237
+ # ---------------------------------------------------------------------------
238
 
 
239
  with gr.Blocks() as demo:
240
  gr.Markdown("# Basic Agent Evaluation Runner")
241
  gr.Markdown(
242
  """
243
  **Instructions:**
244
+ 1. This Space defines your agent's logic, tools, and required packages.
245
+ 2. Log in to your Hugging Face account using the button below.
246
+ 3. Click 'Run Evaluation & Submit All Answers' to fetch questions, run your agent, submit answers, and see the score.
 
 
 
 
 
 
247
  """
248
  )
249
 
250
  gr.LoginButton()
 
251
  run_button = gr.Button("Run Evaluation & Submit All Answers")
 
252
  status_output = gr.Textbox(label="Run Status / Submission Result", lines=5, interactive=False)
 
253
  results_table = gr.DataFrame(label="Questions and Agent Answers", wrap=True)
254
 
255
+ run_button.click(fn=run_and_submit_all, outputs=[status_output, results_table])
 
 
 
256
 
 
 
 
 
 
 
 
 
 
 
 
257
 
258
+ if __name__ == "__main__":
 
 
 
 
 
 
 
 
 
259
  demo.launch(debug=True, share=False)