feat: add basic API utilities

utilities/compare_questions.py

@@ -0,0 +1,22 @@
+import json
+
+with open("gaia_questions.json") as f:
+    initial_questions = json.load(f)
+
+with open("new_gaia_questions.json") as f:
+    new_questions = json.load(f)
+
+# Compare question IDs
+initial_ids = {q["task_id"] for q in initial_questions}
+new_ids = {q["task_id"] for q in new_questions}
+
+added_questions = new_ids - initial_ids
+removed_questions = initial_ids - new_ids
+
+print(f"Added Questions: {added_questions}")
+print(f"Removed Questions: {removed_questions}")
+
+if not added_questions and not removed_questions:
+    print("✅ The question set has remained the same.")
+else:
+    print("⚠️ The question set has changed.")

utilities/fetch_all_questions.py

@@ -0,0 +1,24 @@
+import requests
+import os
+import json
+from dotenv import load_dotenv
+
+load_dotenv()
+
+BASE_URL = os.getenv("BASE_URL")
+
+def get_all_questions():
+    response = requests.get(f"{BASE_URL}/questions")
+    if response.status_code == 200:
+        return response.json()
+    else:
+        raise Exception(f"API request failed with status code {response.status_code}")
+
+questions = get_all_questions()
+
+print(f"Total questions retrieved: {len(questions)}")
+
+with open("new_gaia_questions.json", "w") as file:
+    json.dump(questions, file, indent=4)
+
+print("Questions successfully saved to new_gaia_questions.json")

utilities/random_question.py

@@ -0,0 +1,15 @@
+import requests
+
+BASE_URL = "https://agents-course-unit4-scoring.hf.space"
+
+def get_random_question():
+    response = requests.get(f"{BASE_URL}/random-question")
+    return response.json()
+
+def get_all_questions():
+    response = requests.get(f"{BASE_URL}/questions")
+    return response.json()
+
+# Fetch one random question to test quickly
+question = get_random_question()
+print(question)

utilities/random_question_answer.py

@@ -0,0 +1,32 @@
+import os
+import requests
+from dotenv import load_dotenv
+
+load_dotenv()
+
+USERNAME = os.getenv("USERNAME")
+AGENT_CODE_URL = os.getenv("AGENT_CODE_URL")
+BASE_URL = os.getenv("BASE_URL")
+
+def get_random_question():
+    response = requests.get(f"{BASE_URL}/random-question")
+    return response.json()
+
+def submit_answer(task_id, agent_answer):
+    payload = {
+        "username": USERNAME,
+        "agent_code": AGENT_CODE_URL,
+        "answers": [{"task_id": task_id, "submitted_answer": agent_answer}]
+    }
+    response = requests.post(f"{BASE_URL}/submit", json=payload)
+    return response.json()
+
+# Example usage
+question = get_random_question()
+print(question)
+
+# Replace the following line with your agent's actual answer generation
+agent_answer = "your_agent_generated_answer"
+
+submission_result = submit_answer(question["task_id"], agent_answer)
+print(submission_result)