Update app.py

app.py

@@ -141,6 +141,73 @@ with gr.Blocks(title="Tavily Search API", theme=gr.themes.Soft()) as app:
     gr.Markdown("# 🔍 Tavily Search API Interface")
     gr.Markdown("Search the web using Tavily's powerful search API with customizable parameters.")
     
+    # Add documentation accordion
+    with gr.Accordion("📖 API Documentation & Parameter Options", open=False):
+        gr.Markdown("""
+        ## Available Options
+
+        ### **topic**: The category of the search
+        - **news**: Useful for retrieving real-time updates, particularly about politics, sports, and major current events covered by mainstream media sources
+        - **general**: For broader, more general-purpose searches that may include a wide range of sources
+        
+        **Available options**: `general`, `news`
+
+        ### **search_depth**: The depth of the search
+        - **advanced**: Tailored to retrieve the most relevant sources and content snippets for your query (costs 2 API Credits)
+        - **basic**: Provides generic content snippets from each source (costs 1 API Credit)
+        
+        **Available options**: `basic`, `advanced`
+
+        ### **chunks_per_source**: Content snippets control
+        Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use this to define the maximum number of relevant chunks returned per source and to control the content length. Chunks will appear in the content field as: `<chunk 1> [...] <chunk 2> [...] <chunk 3>`. 
+        
+        **Note**: Available only when `search_depth` is `advanced`
+        
+        **Required range**: 1 ≤ x ≤ 3
+
+        ### **max_results**: Maximum number of search results
+        The maximum number of search results to return.
+        
+        **Required range**: 0 ≤ x ≤ 20
+
+        ### **time_range**: Time filtering
+        The time range back from the current date to filter results. Useful when looking for sources that have published data.
+        
+        **Available options**: `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`
+
+        ### **days**: Days back for news searches
+        Number of days back from the current date to include. Available only if topic is `news`.
+        
+        **Required range**: x ≥ 1
+
+        ### **include_answer**: LLM-generated answer
+        Include an LLM-generated answer to the provided query.
+        - `basic` or `true`: Returns a quick answer
+        - `advanced`: Returns a more detailed answer
+
+        ### **include_raw_content**: Raw HTML content
+        Include the cleaned and parsed HTML content of each search result.
+        - `markdown` or `true`: Returns search result content in markdown format
+        - `text`: Returns the plain text from the results (may increase latency)
+
+        ### **include_images**: Image search
+        Also perform an image search and include the results in the response.
+
+        ### **include_image_descriptions**: Image descriptions
+        When `include_images` is true, also add a descriptive text for each image.
+
+        ### **include_domains**: Domain inclusion
+        A list of domains to specifically include in the search results.
+
+        ### **exclude_domains**: Domain exclusion
+        A list of domains to specifically exclude from the search results.
+
+        ### **country**: Country-specific boosting
+        Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is `general`.
+        
+        **Available countries**: afghanistan, albania, algeria, andorra, angola, argentina, armenia, australia, austria, azerbaijan, bahamas, bahrain, bangladesh, barbados, belarus, belgium, belize, benin, bhutan, bolivia, bosnia and herzegovina, botswana, brazil, brunei, bulgaria, burkina faso, burundi, cambodia, cameroon, canada, cape verde, central african republic, chad, chile, china, colombia, comoros, congo, costa rica, croatia, cuba, cyprus, czech republic, denmark, djibouti, dominican republic, ecuador, egypt, el salvador, equatorial guinea, eritrea, estonia, ethiopia, fiji, finland, france, gabon, gambia, georgia, germany, ghana, greece, guatemala, guinea, haiti, honduras, hungary, iceland, india, indonesia, iran, iraq, ireland, israel, italy, jamaica, japan, jordan, kazakhstan, kenya, kuwait, kyrgyzstan, latvia, lebanon, lesotho, liberia, libya, liechtenstein, lithuania, luxembourg, madagascar, malawi, malaysia, maldives, mali, malta, mauritania, mauritius, mexico, moldova, monaco, mongolia, montenegro, morocco, mozambique, myanmar, namibia, nepal, netherlands, new zealand, nicaragua, niger, nigeria, north korea, north macedonia, norway, oman, pakistan, panama, papua new guinea, paraguay, peru, philippines, poland, portugal, qatar, romania, russia, rwanda, saudi arabia, senegal, serbia, singapore, slovakia, slovenia, somalia, south africa, south korea, south sudan, spain, sri lanka, sudan, sweden, switzerland, syria, taiwan, tajikistan, tanzania, thailand, togo, trinidad and tobago, tunisia, turkey, turkmenistan, uganda, ukraine, united arab emirates, united kingdom, united states, uruguay, uzbekistan, venezuela, vietnam, yemen, zambia, zimbabwe
+        """)
+    
     with gr.Row():
         with gr.Column(scale=1):
             # API Configuration
@@ -273,16 +340,186 @@ with gr.Blocks(title="Tavily Search API", theme=gr.themes.Soft()) as app:
             )
     
     # Examples
-    gr.Markdown("## 💡 Examples")
+    gr.Markdown("## 💡 Comprehensive Test Examples")
     gr.Examples(
         [
-            ["Who is Leo Messi?", "general", "basic", 5, True],
-            ["Latest news about artificial intelligence", "news", "advanced", 3, True],
-            ["Python programming tutorials", "general", "basic", 10, True],
-            ["Climate change recent developments", "news", "basic", 5, True],
+            # Basic general search
+            [
+                "Who is Leo Messi?",  # query
+                "general",  # topic
+                "basic",  # search_depth
+                3,  # chunks_per_source
+                5,  # max_results
+                "None",  # time_range
+                7,  # days
+                True,  # include_answer
+                "false",  # include_raw_content
+                False,  # include_images
+                False,  # include_image_descriptions
+                "",  # include_domains
+                "",  # exclude_domains
+                "None"  # country
+            ],
+            # Advanced news search with time filter
+            [
+                "Latest artificial intelligence breakthroughs",
+                "news",
+                "advanced",
+                3,
+                3,
+                "week",
+                3,
+                True,
+                "markdown",
+                False,
+                False,
+                "",
+                "",
+                "None"
+            ],
+            # Python tutorials with domain inclusion
+            [
+                "Python machine learning tutorials",
+                "general",
+                "advanced",
+                2,
+                8,
+                "None",
+                7,
+                True,
+                "text",
+                False,
+                False,
+                "github.com, stackoverflow.com, medium.com",
+                "",
+                "None"
+            ],
+            # Climate change news with exclusions
+            [
+                "Climate change policy updates",
+                "news",
+                "basic",
+                3,
+                4,
+                "month",
+                14,
+                True,
+                "false",
+                False,
+                False,
+                "",
+                "facebook.com, twitter.com, reddit.com",
+                "None"
+            ],
+            # Country-specific search
+            [
+                "Best restaurants and food culture",
+                "general",
+                "basic",
+                3,
+                6,
+                "None",
+                7,
+                True,
+                "false",
+                True,
+                True,
+                "",
+                "",
+                "france"
+            ],
+            # Technology news with images
+            [
+                "iPhone 15 features and specs",
+                "general",
+                "advanced",
+                3,
+                5,
+                "None",
+                7,
+                True,
+                "markdown",
+                True,
+                True,
+                "apple.com, techcrunch.com, theverge.com",
+                "",
+                "united states"
+            ],
+            # Sports news recent
+            [
+                "FIFA World Cup 2024 results",
+                "news",
+                "advanced",
+                3,
+                7,
+                "day",
+                1,
+                True,
+                "text",
+                False,
+                False,
+                "fifa.com, espn.com, bbc.com",
+                "",
+                "None"
+            ],
+            # Academic research
+            [
+                "quantum computing research papers 2024",
+                "general",
+                "advanced",
+                3,
+                10,
+                "year",
+                7,
+                True,
+                "markdown",
+                False,
+                False,
+                "arxiv.org, nature.com, science.org",
+                "wikipedia.org",
+                "None"
+            ],
+            # Stock market news
+            [
+                "Tesla stock price analysis",
+                "news",
+                "basic",
+                3,
+                5,
+                "week",
+                7,
+                True,
+                "false",
+                False,
+                False,
+                "yahoo.com, bloomberg.com, marketwatch.com",
+                "",
+                "None"
+            ],
+            # Health and medical
+            [
+                "COVID-19 vaccine effectiveness studies",
+                "general",
+                "advanced",
+                3,
+                8,
+                "month",
+                7,
+                True,
+                "text",
+                False,
+                False,
+                "who.int, cdc.gov, pubmed.ncbi.nlm.nih.gov",
+                "facebook.com, instagram.com",
+                "None"
+            ]
+        ],
+        inputs=[
+            query, topic, search_depth, chunks_per_source, max_results,
+            time_range, days, include_answer, include_raw_content, include_images,
+            include_image_descriptions, include_domains, exclude_domains, country
         ],
-        inputs=[query, topic, search_depth, max_results, include_answer],
-        label="Click on an example to load it"
+        label="🚀 Click on any example to load complete test configurations"
     )
     
     # Connect the search button