PolytenderDocs
Dashboard

Tool-Referenz

Alle Tools des KI-Connectors, was sie tun und welche nach einer Bestätigung fragen.

Diese Liste wird aus dem Connector selbst erzeugt und entspricht daher immer dem, was deine Assistenz tatsächlich sieht.

Deine Assistenz wählt die Tools selbst aus, du rufst sie nicht namentlich auf. Die Liste steht hier, damit du weißt, was möglich ist und was nicht.

Öffentliche Tools

Verfügbar für alle angemeldeten Zugriffe: Suche und Lesen, dazu das Changelog.

get_changelogNur lesend

Was in Polytender neu ist: Funktionen, Verbesserungen und Fixes, neueste zuerst. Lässt das "Neu"-Badge in der App unberührt.

Parameter (5)
  • since string
    Only entries published on or after this date (YYYY-MM-DD).
  • category "new" | "improved" | "fixed"
    Filter by category.
  • major boolean
    Only the major highlights.
  • limit integer
    Max entries (default 10).
  • locale "de" | "en"
    Language of the entries (default 'de', like the tender data).
search_tendersNur lesend

Ausschreibungen mit Filtern suchen: Land, Region, Quelle, CPV, Stichwörter, Stufe, Status, Frist und Wert.

Parameter (17)
  • query string
    Keyword matched against the tender title (case-insensitive substring).
  • country string[]
    ISO country codes, e.g. ["DEU","AUT"]. Note: the corpus stores ISO-3 for most sources.
  • source "TED_EU" | "SAM_GOV" | "UK_CONTRACTS_FINDER" | "UK_FIND_A_TENDER" | "AT_KDQ" | "AT_KDQ_XML" | … (41 values)[]
    Restrict to specific source portals.
  • cpvDivision string[]
    Two-digit CPV division filters, e.g. ["45"] construction, ["72"] IT services.
  • stage "tender" | "award" | "planning" | "amendment" | "cancellation" | "other" | "all"
    Notice lifecycle stage. Default 'tender' = biddable calls for competition. 'award' = contract award notices.
  • status "open" | "soon" | "closed" | "unknown"
    For stage 'tender' only: 'open' = deadline in the future, 'soon' = closing within 14 days, 'unknown' = no deadline published.
  • publishedSince string
    Only notices published on/after this date (YYYY-MM-DD or ISO datetime).
  • deadlineFrom string
    Only notices whose submission deadline is on/after this date (YYYY-MM-DD).
  • valueMin number
    Minimum contract value (in the notice currency, mostly EUR).
  • buyer string
    Case-insensitive substring match on the buyer/contracting-authority name.
  • lotGroup string
    Lot family id (the `lotGroupId` on a result). Returns every notice that is a lot of the SAME procurement. These are NOT duplicates: each lot is awarded and bid for separately, so evaluate them individually.
  • regions string[]
    Region filter: NUTS prefixes ("DE2" = Bayern, "AT13" = Wien, "DE" + digits at any depth) or synthetic US state codes ("USCA"). OR-ed with `country`. Coverage is ~100% on TED-fed countries but only ~73% in Germany, so for "all of Germany" use country, not a region.
  • keywords string[]
    Full-text terms or phrases matched in title AND description (OR-ed; a multi-word entry is a phrase), e.g. ["SAP", "Microsoft 365"]. Complements `query`, which only matches the title.
  • cpv string
    Exact 8-digit CPV code (use lookup_cpv to find it). Finer than cpvDivision.
  • includeUnclassified boolean
    With cpvDivision/cpv: also return notices that carry no CPV code at all.
  • page integer
    Page number (default 1).
  • limit integer
    Results per page (default 20, max 50).
get_tenderNur lesend

Alles, was wir zu einer Ausschreibung haben: Beschreibung, Kontakt des Auftraggebers, Termine, Klassifizierungen und Quelllink.

Parameter (3)
  • id stringerforderlich
    The Polytender tender id (UUID).
  • include "documents" | "lifecycle" | "raw"[]
    Extra blocks to include. 'documents' = the attached procurement documents IF already cached (otherwise a hint to call get_tender_documents, which may hit the source portal). 'lifecycle' = every notice about this procurement across sources and stages (planning → tender → award), oldest first. 'raw' = the untouched payload as published by the source portal (large; only when the shaped fields are not enough).
  • descriptionMaxChars integer
    Truncate the description to this many characters. Default 20000; at most 40000 (0 = that maximum). A `descriptionNote` says when it was shortened.
get_tender_documentsNur lesend

Die Liste der Vergabeunterlagen zu einer Ausschreibung, mit Hinweis, wenn ein Portal einen Login verlangt.

Parameter (3)
  • id stringerforderlich
    The Polytender tender id (UUID).
  • offset integer
    Index of the first document to return (default 0). `pagingNote` gives the next offset when more exist.
  • limit integer
    Documents per call (default 40, max 80).
read_tender_documentNur lesend

Der Text in einem Dokument, adressiert über seine Position in der Dokumentliste. Lange Dateien seitenweise.

Parameter (5)
  • id stringerforderlich
    The Polytender tender id (UUID).
  • index integererforderlich
    Position of the document in the list returned by get_tender_documents.
  • zipEntry string
    For ZIP archives: the name of the entry to read (from the `entries` list).
  • offset integer
    Start reading at this character offset (use `nextOffset` from the previous page).
  • maxChars integer
    Characters to return (default 20000, at most 40000; 0 = that maximum). Longer documents are paged.
semantic_searchNur lesend

Nach Bedeutung statt exakten Wörtern suchen, sprachübergreifend. Gut für "so etwas wie X"-Fragen.

Parameter (3)
  • query stringerforderlich
    What the user is looking for, in natural language (any language).
  • country string[]
    Optional ISO country codes to restrict results.
  • limit integer
    Max results (default 10).
get_facetsNur lesend

Die Länder- und Quellcodes, die in den Daten tatsächlich vorkommen, dazu offene und bald endende Verfahren.

lookup_cpvNur lesend

CPV-Codes über Text oder Code-Präfix finden und einen Code zu seiner Bezeichnung auflösen.

Parameter (3)
  • query string
    Free text ("Gebäudereinigung", "software") or a code prefix ("4521"). Up to 20 hits.
  • codes string[]
    Codes to resolve to labels (label is null for codes not in the catalog).
  • lang "de" | "en"
    Label language (default de).
lookup_companyNur lesend

Die Zuschlagshistorie eines Unternehmens nach Namen: was es gewonnen hat, wo und wann zuletzt.

Parameter (1)
  • name stringerforderlich
    Company name or a distinctive part of it.
list_sourcesNur lesend

Alle Portale, die wir aggregieren, mit Anzahl der Ausschreibungen und letztem Sync.

Organisations-Tools

Verfügbar mit einem persönlichen API-Key oder mit einer OAuth-Verbindung, der Zugriff auf die Organisation gewährt wurde. Sie arbeiten mit den Suchprofilen, Mitgliedern und dem Plan deiner Organisation und mit deinen persönlichen Favoriten und Alerts. Die Mitgliederverwaltung folgt denselben Rollen wie die App: Einladen braucht Inhaberin oder Admin, eine Rolle ändern die Inhaberin.

Hat die Organisation keinen aktiven Plan (Testphase abgelaufen, Abo beendet), sieht die Assistenz nur get_subscription_status und get_changelog, bis in der App ein Plan gewählt wurde.

get_subscription_statusNur lesend

Der Plan deiner Organisation: Testphase oder aktiv, verbleibende Tage, genutzte und enthaltene Nutzerplätze und Suchprofile, Verlängerungsdatum und wer ihn ändern darf.

list_search_profilesNur lesend

Die Suchprofile deiner Organisation mit einer Übersicht ihrer Treffer.

get_search_profile_matchesNur lesend

Die gespeicherten bewerteten Treffer eines Suchprofils. Schnell, weil nichts neu berechnet wird.

Parameter (1)
  • id stringerforderlich
    The search profile id (from list_search_profiles).
refresh_search_profile

Das Matching eines Suchprofils neu ausführen. Höchstens einmal pro Profil und Tag.

Parameter (1)
  • id stringerforderlich
    The search profile id (from list_search_profiles).
match_companyNur lesend

Gewinnbare Ausschreibungen für dein Unternehmen finden. Ohne Website-Angabe wird dein gespeichertes Profil verwendet.

Parameter (1)
  • website string
    Company website URL of an existing search profile. Omit to use the organization's newest profile.
get_search_profileNur lesend

Die Definition eines Suchprofils: Länder, Regionen, Stichwörter, CPV-Codes und Ausschluss-Stichwörter.

Parameter (1)
  • id stringerforderlich
    The search profile id (from list_search_profiles).
update_search_profile

Ein Suchprofil umbenennen oder Länder, Regionen, Stichwörter und CPV-Codes ändern. Startet kein neues Matching.

Parameter (5)
  • id stringerforderlich
    The search profile id.
  • name string
    New display name.
  • country string[]
    Target countries as ISO-2 codes (["DE","AT"]); ["ALL"] = worldwide; [] = Europe default (only when no regions are set). OR-ed with regions.
  • regions string[]
    Target regions as NUTS prefixes or synthetic US state codes (["DE2","AT13","USCA"]); [] clears. OR-ed with country.
  • refinements object
preview_company_profileNur lesend

Eine Website auslesen und das Profil zeigen, das wir daraus ableiten würden, ohne etwas zu speichern.

Parameter (2)
  • website stringerforderlich
    Company website URL.
  • lang "de" | "en"
    Language for CPV labels (default de).
create_search_profile

Ein Suchprofil aus einer Website oder manuell aus Zusammenfassung, Stichwörtern und CPV-Codes anlegen und das erste Matching starten.

Parameter (6)
  • website string
    Company website URL. Omit to create a MANUAL profile from `name` + `refinements` only (no crawl).
  • name string
    Display name (default: the website). REQUIRED when no website is given.
  • country string[]
    Target countries as ISO-2 codes; ["ALL"] = worldwide; omit = Europe.
  • regions string[]
    Target regions as NUTS prefixes / US state codes ("DE2", "USCA"). OR-ed with country.
  • refinements object
    Overrides for the crawled profile (each key replaces the crawled value). REQUIRED, with at least one of summary/keywords/cpvCodes, when no website is given.
  • allowDuplicate boolean
    Create even if a profile for this website already exists.
delete_search_profileFragt vor der Ausführung nach einer Bestätigung

Ein Suchprofil archivieren. Fragt vorher nach einer Bestätigung.

Parameter (2)
  • id stringerforderlich
    The search profile id (from list_search_profiles).
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
explain_matchNur lesend

Warum eine Ausschreibung in einer Trefferliste gelandet ist: Regionsprüfung, CPV-Treffer, Stichworttreffer.

Parameter (3)
  • profileId stringerforderlich
    The search profile id.
  • tenderId stringerforderlich
    The tender id of the match (from get_search_profile_matches).
  • lang "de" | "en"
    CPV label language (default de).
dismiss_matchFragt vor der Ausführung nach einer Bestätigung

Einen Treffer ausblenden und dem Profil optional beibringen, warum. Fragt vorher nach einer Bestätigung.

Parameter (6)
  • profileId stringerforderlich
    The search profile id.
  • tenderId stringerforderlich
    The tender id of the match to dismiss.
  • negativeKeywords string[]
    Terms to add as hard excludes to the profile.
  • removeKeywords string[]
    Positive keywords to remove from the profile (as listed by explain_match `profileKeywords`).
  • removeCpvCodes string[]
    CPV codes to remove from the profile.
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
undo_match_feedback

Das Ausblenden eines Treffers rückgängig machen, inklusive der dabei vorgenommenen Profiländerungen.

Parameter (3)
  • profileId stringerforderlich
    The search profile id.
  • tenderId stringerforderlich
    The tender id that was dismissed.
  • feedbackId stringerforderlich
    The feedbackId returned by dismiss_match.
list_bookmarksNur lesend

Deine markierten Ausschreibungen und privaten Notizen, filterbar nach Status, Quelle, Land und Text.

Parameter (9)
  • scope "org" | "all"
    'org' (default) = active organization only; 'all' = all of the user's organizations.
  • tab "starred" | "noted"
    'starred' (default) or 'noted' (has a private note).
  • status "open" | "closingSoon" | "expired"
    Filter by submission deadline.
  • query string
    Text search over note, title and buyer.
  • source "TED_EU" | "SAM_GOV" | "UK_CONTRACTS_FINDER" | "UK_FIND_A_TENDER" | "AT_KDQ" | "AT_KDQ_XML" | … (41 values)
    Restrict to one source portal.
  • country string
    Country code as stored on the tender (ISO-2 or ISO-3 depending on source).
  • sort "starredAt" | "deadline"
    'starredAt' (default, newest first) or 'deadline' (soonest first).
  • page integer
  • limit integer
    Rows per page (default 25, max 50).
bookmark_tender

Eine Ausschreibung mit einem Stern markieren, damit sie in deinen Favoriten erscheint.

Parameter (1)
  • tenderId stringerforderlich
    Polytender tender id (UUID from search_tenders, semantic_search or a search profile match).
unbookmark_tender

Den Stern einer Ausschreibung entfernen. Eine Notiz dazu bleibt erhalten.

Parameter (3)
  • tenderId stringerforderlich
    Polytender tender id.
  • organizationId unknown
    Only for rows outside the active organization: the row's organization id (null = deleted organization).
  • workspaceId unknown
    Deprecated alias of organizationId.
set_tender_note

Deine private Notiz zu einer Ausschreibung ergänzen oder ersetzen. Nur du siehst sie.

Parameter (5)
  • tenderId stringerforderlich
    Polytender tender id.
  • note stringerforderlich
    The note text (plain text).
  • mode "append" | "replace"
    'append' (default) or 'replace'.
  • organizationId unknown
    Only for rows outside the active organization (then mode must be 'replace').
  • workspaceId unknown
    Deprecated alias of organizationId.
track_tender

Eine Ausschreibung verfolgen: Updates per E-Mail und in der App, wenn sich die Frist verschiebt, Unterlagen oder Bieterfragen ändern oder sie aufgehoben bzw. vergeben wird.

Parameter (1)
  • tenderId stringerforderlich
    Polytender tender id (UUID from search_tenders, semantic_search or a search profile match).
untrack_tender

Eine Ausschreibung nicht mehr verfolgen. Bisherige Updates bleiben in deinem Verlauf.

Parameter (1)
  • tenderId stringerforderlich
    Polytender tender id.
list_tracked_tendersNur lesend

Die Ausschreibungen, die du verfolgst, nächste Frist zuerst, mit verbleibenden Tagen und dem letzten Update.

get_notification_settingsNur lesend

Welche E-Mails du bekommst: der Kontoschalter, der Schalter je Organisation und deine täglichen Alerts.

set_daily_alertsFragt vor der Ausführung nach einer Bestätigung

Die tägliche E-Mail zu einem Suchprofil abonnieren oder abbestellen. Das Abbestellen fragt nach einer Bestätigung.

Parameter (5)
  • profileId stringerforderlich
    The search profile id.
  • organizationId string
    Only for a profile in another organization (see get_notification_settings).
  • workspaceId unknown
    Deprecated alias of organizationId.
  • enabled booleanerforderlich
    true = receive the daily alert email, false = stop it.
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
set_digest_enabledFragt vor der Ausführung nach einer Bestätigung

Die Zusammenfassung für dein ganzes Konto oder eine Organisation ein- oder ausschalten. Das Ausschalten fragt nach einer Bestätigung.

Parameter (5)
  • level "account" | "organization" | "workspace"erforderlich
    'account' = master switch, 'organization' = one organization's digest ('workspace' is the deprecated spelling).
  • organizationId string
    For level 'organization': the organization id (default: the active one).
  • workspaceId unknown
    Deprecated alias of organizationId.
  • enabled booleanerforderlich
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
get_organizationNur lesend

Die Organisation, in der der Connector arbeitet: Name, Anzahl der Mitglieder und deine Rolle darin.

list_membersNur lesend

Die Mitglieder deiner Organisation mit Rolle und Beitrittsdatum.

list_pending_invitationsNur lesend

Versendete, noch nicht angenommene Einladungen, mit Absender und Ablaufdatum. Jede belegt einen Nutzerplatz.

invite_memberFragt vor der Ausführung nach einer Bestätigung

Jemanden per E-Mail in deine Organisation einladen. Nur Owner und Admins; fragt vorher nach einer Bestätigung, weil eine E-Mail verschickt und ein Nutzerplatz belegt wird.

Parameter (3)
  • email stringerforderlich
    Email address of the person to invite.
  • role "admin" | "member"
    Role they get on joining (default 'member'). Admins can invite and manage people.
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
cancel_invitationFragt vor der Ausführung nach einer Bestätigung

Eine offene Einladung zurückziehen und den Nutzerplatz freigeben. Nur Owner und Admins; fragt vorher nach einer Bestätigung.

Parameter (2)
  • invitationId stringerforderlich
    The invitation id (from list_pending_invitations).
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
update_member_roleFragt vor der Ausführung nach einer Bestätigung

Die Rolle eines Mitglieds ändern. Nur der Owner; wer zum Owner gemacht wird, übernimmt die Organisation. Fragt vorher nach einer Bestätigung.

Parameter (3)
  • memberId stringerforderlich
    The member id (from list_members — not the user id).
  • role "owner" | "admin" | "member"erforderlich
    The new role.
  • confirm boolean
    Set to true ONLY after the user explicitly confirmed the preview returned by a previous call of this tool. Never set it on the first call.
get_lot_familyNur lesend

Alle Lose einer Vergabe als eine Serie, über die Losgruppen-ID oder eine beliebige Ausschreibungs-ID daraus.

Parameter (2)
  • lotGroupId string
    The lot group id from a search result or get_tender.
  • tenderId string
    A tender id instead: its lot series is resolved for you.

Die Tabelle lesen

  • Nur lesend bedeutet, dass das Tool nichts verändert.
  • Fragt vor der Ausführung nach einer Bestätigung heißt, dass das Tool beim ersten Aufruf nichts tut und stattdessen eine Vorschau liefert, siehe Sicherheit, Bestätigungen und faire Nutzung.
  • Parameternamen und -werte sind in beiden Sprachen dieser Dokumentation englisch, weil die Assistenz sie so sendet.
War diese Seite hilfreich?

Auf dieser Seite

Öffentliche ToolsOrganisations-ToolsDie Tabelle lesen