make the agent answers more readable

app.py

@@ -3,15 +3,14 @@ import datetime
 import requests
 import pytz
 import yaml
-from tools.final_answer import FinalAnswerTool
-
 import gradio as gr
+from tools.final_answer import FinalAnswerTool
 
 # Below is an example of a tool that does nothing. Amaze us with your creativity !
 @tool
 def my_custom_tool(arg1: str, arg2: int) -> str:  # it's important to specify the return type
     # Keep this format for the description / args / args description but feel free to modify the tool
-    """Fetch top headlines from popular news sources for today.
+    """Fetch and nicely format top headlines from popular news sources for today.
 
     Args:
         arg1: Comma-separated list of sources to include (options: "bbc", "nyt", "guardian", "hn", "all").
@@ -19,7 +18,8 @@ def my_custom_tool(arg1: str, arg2: int) -> str:  # it's important to specify th
         arg2: Maximum number of headlines per source (must be > 0).
 
     This tool scrapes public RSS feeds (no API key needed) and returns a
-    human-readable summary grouped by source, with each headline on its own line.
+    markdown-formatted string grouped by source, with each headline on its own line
+    and linked to the original article when available.
     """
     import xml.etree.ElementTree as ET
 
@@ -65,30 +65,38 @@ def my_custom_tool(arg1: str, arg2: int) -> str:  # it's important to specify th
         url = meta["url"]
 
         try:
-            resp = requests.get(url, timeout=5)
+            resp = requests.get(url, timeout=8)
             resp.raise_for_status()
             root = ET.fromstring(resp.content)
 
-            # RSS structure: channel/item/title
+            # RSS structure: channel/item/title/link
             items = []
             for item in root.findall(".//item"):
                 title_el = item.find("title")
+                link_el = item.find("link")
                 if title_el is not None and title_el.text:
                     title = title_el.text.strip()
+                    link = link_el.text.strip() if link_el is not None and link_el.text else ""
                     if title:
-                        items.append(title)
+                        items.append((title, link))
                 if len(items) >= arg2:
                     break
 
             if not items:
-                output_sections.append(f"{name}:\n  (no headlines found)")
+                output_sections.append(f"### {name}\n\n_(no headlines found)_")
             else:
-                joined = "\n".join(f"  - {t}" for t in items)
-                output_sections.append(f"{name} (top {len(items)}):\n{joined}")
+                lines = []
+                for idx, (title, link) in enumerate(items, start=1):
+                    if link:
+                        lines.append(f"{idx}. [{title}]({link})")
+                    else:
+                        lines.append(f"{idx}. {title}")
+                joined = "\n".join(lines)
+                output_sections.append(f"### {name} (top {len(items)})\n\n{joined}")
         except Exception as e:
-            output_sections.append(f"{name}:\n  Error fetching headlines: {e}")
+            output_sections.append(f"### {name}\n\n_Error fetching headlines: {e}_")
 
-    header = "Top headlines from popular news sources (via public RSS feeds):"
+    header = "## Top headlines from popular news sources\n"
     return header + "\n\n" + "\n\n".join(output_sections)
 
 @tool
@@ -149,11 +157,23 @@ def chat_fn(message, history):
             "returned an error like 502). Please try again or with a simpler request."
         )
     result_str = str(result)
-    history = history + [(message, result_str)]
-    # ChatInterface expects (assistant_message)
+    # For gr.ChatInterface, we only return the assistant message;
+    # ChatInterface manages the history itself.
     return result_str
 
 
-demo = gr.ChatInterface(fn=chat_fn, title="SmolAgents News & Tools Agent")
+demo = gr.ChatInterface(
+    fn=chat_fn,
+    title="Daily Headlines Assistant",
+    description=(
+        "Ask for today's top headlines from BBC, The New York Times, The Guardian, "
+        "and Hacker News. Results include clickable links and are grouped by source."
+    ),
+    examples=[
+        "Show me today’s top 3 headlines from BBC, NYT and Hacker News.",
+        "Give me the top 5 headlines from BBC only.",
+        "Fetch today’s main stories from The Guardian and Hacker News.",
+    ],
+)
 
 demo.launch()