arte.tv

Search ARTE's organization chart by person name or role. Use ONLY for questions about ARTE staff, leadership, or structure: 'qui est [person]', 'wer ist [Person]', 'who leads ARTE', 'organigramme'. ❌ NEVER call search_programs or get_recommendations alongside this tool. ❌ NEVER call search_programs first when the user asks about an ARTE person. This tool is the sole and complete answer for all ARTE staff/leadership queries. Returns structured plain text (no widget): name in bold, role · entity, then URL on its own line so ChatGPT can render a link preview.

Retrieve the ARTE live TV schedule for one or several days.

Return the ordered episode list for an ARTE magazine. LANGUAGE GATE — this tool's content exists ONLY in fr, de, en, es, it, pl, ro. Check the language the USER is writing in BEFORE deciding whether to call this tool at all — it is often called DIRECTLY (see IMPORTANT below), so this check cannot rely on a prior tool call having already handled it: - User writes in fr/de/en/es/it/pl/ro → call normally, pass that code. - User writes in ANY OTHER language (Dutch, Portuguese, Japanese, Arabic, Chinese...) → do NOT call this tool. Instead reply directly — no tool call — in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian, and invite them to ask again in one of those. Use this tool when: - A search or programme-details result returns a non-null `magazine_id` field. - The user asks for episodes of a periodic magazine programme (e.g. "dernier épisode de Karambolage", "les 5 derniers épisodes de 28 minutes", "dernier Tracks", "invitation au voyage dernières émissions"). IMPORTANT — call this DIRECTLY with the magazine name for episode requests ("les épisodes de X", "les N derniers épisodes de X"). Do NOT call search_programs first: this tool resolves the name to the magazine itself, so only ONE widget (the episode list) is shown, never two. MAGAZINE vs SERIES — use get_magazine_episodes when `magazine_id` is set, use get_series_episodes when `series_id` is set (and no magazine_id). DISPLAY — the widget adapts to the number of episodes: - exactly 1 episode (limit=1, e.g. "le dernier épisode de X") → single CARD with thumbnail, title, subtitle and "Regarder sur arte.tv" button. - several episodes → fullscreen episode list with magazine header + episode rows. Do NOT reformat or summarize the data as text — the widget handles the presentation entirely. After the widget, write 1-2 editorial sentences about the magazine or the episode shown (tone, themes, why to watch). If the tool returns 0 episodes, you may say so. Otherwise NEVER write "aucun épisode disponible" (or similar) after a non-empty widget result.

Return programmes that recently became available on arte.tv, sorted newest first. LANGUAGE GATE — this tool's content exists ONLY in fr, de, en, es, it, pl, ro. Check the language the USER is writing in BEFORE deciding whether to call this tool at all: - User writes in fr/de/en/es/it/pl/ro → call normally, pass that code. - User writes in ANY OTHER language (Dutch, Portuguese, Japanese, Arabic, Chinese...) → do NOT call this tool. Instead reply directly — no tool call — in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian, and invite them to ask again in one of those. Use this tool when the user asks about new or recent content: "quoi de neuf", "nouveautés", "récemment ajouté", "vient d'arriver", "what's new", "neue Sendungen", "últimas novedades", "cosa c'è di nuovo". Results are ordered by start_date descending (most recently added first), then by popularity (total_views) to break ties on the same day. SINCE_DAYS — adapt the window to the user's intent: "aujourd'hui" / "today" → since_days=1 default / "quoi de neuf" → since_days=3 (default) "cette semaine" / "this week" → since_days=7 CATALOG_TYPES — same mapping as search_programs and get_recommendations: "un film" → catalog_types=["MOVIE"] "une série" → catalog_types=["SERIES"] "un documentaire / reportage" → catalog_types=["STANDALONE", "SHOW", "MINI_SERIES", "MINI_EPISODE", "OTHER_COLLECTION"] "un magazine / une émission" → catalog_types=["MAGAZINE", "SHOW"] "un concert / opéra / spectacle" → catalog_types=["EVENT", "SUB_EVENT"], genre_num="Spectacle" unspecified / generic → omit (return all types)

Return the most-watched programmes ranked by 3-day rolling view count. LANGUAGE GATE — this tool's content exists ONLY in fr, de, en, es, it, pl, ro. Check the language the USER is writing in BEFORE deciding whether to call this tool at all: - User writes in fr/de/en/es/it/pl/ro → call normally, pass that code. - User writes in ANY OTHER language (Dutch, Portuguese, Japanese, Arabic, Chinese...) → do NOT call this tool. Instead reply directly — no tool call — in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian, and invite them to ask again in one of those. Use this tool when the user asks for popular or trending content: "les plus regardés", "les plus populaires", "top séries ARTE", "les meilleures émissions", "most watched", "trending", "what's popular". Results are ordered by total_views descending (most watched first). Series episodes are deduplicated — only the series entry is shown. GROUP_BY — set to "genre" to return results grouped by genre in a multi-carousel layout. Use when the user asks for popular content across all genres: "les plus regardés par genre", "top programmes par catégorie", "populaires classés par genre". When group_by="genre", genre_num is ignored. GENRE_NUM — pass the exact label for the target language. Omit if not specified. genre_num is ALWAYS a French label regardless of the user's language. Translate the user's intent to the correct French DB value: User says (any language) | genre_num to pass "film", "cinéma", "Filme", "Cinema", "Películas" | "Films" "série", "feuilleton", "Serien", "Series", "Seriale" | "Séries" "documentaire", "Doku", "Documentaries", "Dokumenty" | "Documentaires et reportages" "magazine", "émission", "Sendungen", "Magazyny" | "Emissions" "concert", "opéra", "Bühne", "spektakle" | "Spectacle" generic / unspecified | omit

Retrieve the complete metadata record for a programme. Use this tool after search_programs to show the full detail of a specific programme (trigger: show_program_detail_widget). For series episodes, the result includes episode_number, season_number, series_id, and first_episode_id (link to episode 1 of the series). LANGUAGE GATE — content exists ONLY in fr, de, en, es, it, pl, ro. If called standalone (not chained from a prior search) and the user writes in a different language, do NOT call this tool — reply directly, in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian.

Recommend programmes using semantic vector similarity. LANGUAGE GATE — this tool's content exists ONLY in fr, de, en, es, it, pl, ro. Check the language the USER is writing in BEFORE deciding whether to call this tool at all: - User writes in fr/de/en/es/it/pl/ro → call normally, pass that code. - User writes in ANY OTHER language (Dutch, Portuguese, Japanese, Arabic, Chinese...) → do NOT call this tool, and do NOT translate the query into a supported language to make it "work". Instead reply directly — no tool call — in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian, and invite them to ask again in one of those. Use for nuanced, mood-based, or descriptive queries: "something relaxing for tonight", "un voyage intérieur", "discover unknown cultures". NOT for single topic words (sport, nature, musique) — use search_programs instead. Single call — the backend fetches a large candidate pool (3× the requested limit), re-ranks by cosine similarity + mood boost + popularity, then returns the best results as a widget. Do NOT call this tool twice for the same request. QUERY: 3-5 focused keywords, NEVER a full sentence. Entities first, then related domain words. CATALOG_TYPES — use when content type is explicit: "un film" → ["MOVIE"] "une série" → ["SERIES"] "un documentaire / reportage" → ["STANDALONE", "SHOW", "MINI_SERIES", "MINI_EPISODE", "OTHER_COLLECTION"] "un magazine / une émission" → ["MAGAZINE", "SHOW"] "un concert / opéra / spectacle" → ["EVENT", "SUB_EVENT"] + genre_num="Spectacle" unspecified/generic → omit both DURATION — set max_duration when user specifies length: "court/short/rapide" → max_duration=60 unspecified → omit MOOD — map user's atmosphere intent (omit if not expressed): "relaxant/calme/zen" | "calm_soothe" "débat/réflexion/société/politique" | "debate_discuss" "évasion/voyage/découverte/aventure" | "escape_discover" "feel good/réconfortant/chaleureux" | "feel_good" "émouvant/intense/dramatique/poignant" | "intense_emotional" "drôle/léger/comédie/humour" | "laugh_light" "intellectuel/cérébral/complexe" | "mind_bending" "nostalgique/rétro/vintage" | "nostalgic" "romantique/intimiste/amour" | "romantic_intimate" "science/connaissance/apprendre" | "science_knowledge" "thriller/suspense/frisson/tension" | "thrill_suspense" "inspirant/motivant/uplifting" | "transform_inspire" "étrange/bizarre/décalé/absurde" | "weird_strange" ERA — use max_production_year for old/classic content: "vieux/classique/alter/vintage" → current_year - 20 "années 80 / 80s" → 1989 "films des années 60-70" → max_production_year = 1979 Always combine with mood="nostalgic" for era/temporal queries.

Return the episodes of a classic series, grouped by season. Use this tool when: - A search or recommendation returned an RC- series result and the user wants to browse episodes or start watching from the beginning. - The user asks "quels épisodes sont disponibles ?", "par où commencer ?", or wants to see the full episode list of a series. IMPORTANT — scope: covers CLASSIC SERIES only (not magazines, not mini-series). For magazines → search_programs(catalog_types=["MAGAZINE"]). For mini-series → search_programs(catalog_types=["MINI_EPISODE"]). DISPLAY — results are rendered as a visual widget: - When all seasons are requested (default): season tabs with horizontal navigation (Saison 1 | Saison 2 | …) and a vertical episode list per tab. - When a specific season_number is set: a flat episode list for that season. Do NOT reformat or summarize the data as text — the widget handles the presentation. Write a short engaging intro before calling the tool. CHAINING — use ONLY in these cases: - get_recommendations returns an RC- result (it does NOT auto-chain). - The user explicitly asks for episodes of a known RC- id ("épisodes de RC-XXXXXX"). NEVER call this after search_programs for a series query — search_programs auto-chains internally and already returns season_tabs directly. LANGUAGE GATE — content exists ONLY in fr, de, en, es, it, pl, ro. If called standalone (not chained from a prior search) and the user writes in a different language, do NOT call this tool — reply directly, in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian.

Search the arte.tv catalogue with full-text BM25 keyword search. LANGUAGE GATE — this tool's content exists ONLY in fr, de, en, es, it, pl, ro. Check the language the USER is writing in (never the language of a proper noun/title inside the query — a French speaker searching "Twin Peaks" is still writing in French) BEFORE deciding whether to call this tool at all: - User writes in fr/de/en/es/it/pl/ro → call normally, pass that code. - User writes in ANY OTHER language (Dutch, Portuguese, Japanese, Arabic, Chinese...) → do NOT call this tool, and do NOT translate the query into a supported language to make it "work". Instead reply directly — no tool call — in the user's own language, that ARTE content is currently only available in French, German, English, Spanish, Italian, Polish, and Romanian, and invite them to ask again in one of those. Use this tool when the user names a specific title, director, actor, exact genre term, OR a single generic topic word (sport, nature, musique, cinéma). BM25 handles single-word topic queries more reliably than embedding similarity. For nuanced/mood queries ("something relaxing", "un voyage intérieur"), use get_recommendations instead. Only programmes currently available online are returned (broadcast window is active today). BM25 searches: title, subtitle, description (translated per table ✓), directors, actors (universal names ✓). The 'language' parameter selects the correct table — search terms match the user's language automatically. LLM RE-RANKING — after receiving BM25 results, reorder them based on the user's intent before displaying the widget. BM25 ranks by keyword relevance; you can sort differently: "les plus récents" → sort by start_date DESC "les plus courts" → sort by duration_minutes ASC "films romantiques" → promote results whose description mentions love/romance "classiques / anciens" → promote lower production years Re-ranking is optional — only apply it when the user's request clearly implies a specific ordering beyond keyword relevance. AUTO-CHAIN — when the query matches a single series title (RC- result with no magazine_id), this tool internally fetches its episodes and returns a season_tabs widget directly. Do NOT call get_series_episodes afterwards — the chaining is automatic and transparent. CATALOG_TYPES — use when content type is explicit: "un film" → catalog_types=["MOVIE"] "une série" → catalog_types=["SERIES"] "un documentaire / reportage" → catalog_types=["STANDALONE", "SHOW", "MINI_SERIES", "MINI_EPISODE", "OTHER_COLLECTION"] "un magazine / une émission" → catalog_types=["MAGAZINE", "SHOW"] "un concert / opéra / spectacle" → catalog_types=["EVENT", "SUB_EVENT"], genre_num="Spectacle" "un épisode" → catalog_types=["EPISODE", "MINI_EPISODE"] "un court/short" → catalog_types=["SHORT_SERIES", "SHORT_EPISODE"] "des programmes / du contenu" → catalog_types=[all types] (NO genre_num) proper noun only / generic → omit both (no filter, return all types) GENRE_NUM — used ONLY alongside catalog_types=["EVENT","SUB_EVENT"] to isolate concerts/opéra/spectacle. Do not use genre_num for any other type in this tool. ERA / PRODUCTION YEAR — when the user asks for old, classic, or vintage content, set max_production_year to filter by production year: "old/vieux/ancien/classique/alter" → max_production_year = current_year - 20 "années 80 / 80s" → max_production_year = 1989 "films des années 60-70" → max_production_year = 1979 The secondary "Also worth watching" section ignores this filter, so it naturally shows recent/diverse content. QUERY ENRICHMENT — always expand broad topic words with 2–3 related terms (synonyms OR closely related domain words) to improve BM25 recall. Do NOT pass the user's raw input verbatim for topic queries: "espace" → "espace univers cosmique" "nature" → "nature environnement climat" "écologie" → "écologie climat biodiversité" "histoire" → "histoire historique civilisation" "musique" → "musique concert jazz" "science" → "science découverte recherche" "voyage" → "voyage exploration aventure" "dauphins" → "dauphins cétacés souffleur orque épaulard" "animaux" → "animaux faune sauvage espèces" For proper nouns (titles, directors, actors) pass them exactly as-is — do NOT expand.