← Všetky dokumenty

    Zrušiť otázku

    Čo robí

    cancel_answer zastaví výskum spustený cez ask_lexomat ešte pred jeho dokončením — tretia časť práce s identifikátorom, po spustení otázky a jej čítaní cez get_answer.

    Zrušenie je kooperatívne: pipeline kontroluje požiadavku medzi svojimi krokmi, takže samotná práca môže po návrate volania ešte chvíľu bežať. Čo sa zmení okamžite, je zaznamenaný stav behu — get_answer zavolaný hneď potom už prečíta cancelled, čo je konečný stav.

    Kľúčom je samotné session_id, nie celý identifikátor, pretože v jednej relácii beží naraz najviac jedna otázka. Ide o to isté zrušenie, aké vykoná webová aplikácia Lexomat, keď tam zastavíte bežiaci výskum.

    Pokrýva výlučne slovenské právo, výstup je informatívny, nejde o právne poradenstvo.

    Vstupy

    NázovTypPovinnéPopis
    session_idstringÁnoRelácia, ktorú vrátil ask_lexomat.

    Vracia

    {
      "session_id": "…",
      "cancelled": true
    }
    

    cancelled je true, keď bol váš bežiaci výskum označený za zrušený. Je false, keď v tej relácii nič vaše nebežalo — lebo už skončilo, lebo je relácia neznáma, alebo lebo nie je vaša. Všetky tri prípady vyzerajú zámerne rovnako, takže identifikátory relácií sa nedajú skúšať naslepo.

    Príklad

    Volajúca AI spustila otázku, dvakrát sa pýtala na stav a vy si to rozmyslíte. Zavolá cancel_answer("…"), dostane cancelled: true a oznámi, že výskum bol zastavený. Následný get_answer na ten istý identifikátor vráti status: "cancelled" bez odpovede.

    Poznámky

    • Nespotrebúva žiadnu kvótu — zastavenie práce, ktorú ste už zaplatili, nie je druhé volanie. Samotná otázka sa odpočítala už pri spustení cez ask_lexomat a zrušenie ju nevracia. Pozri Limity používania.
    • Zrušenie je pre daný beh konečné: odpoveď, ktorú by bol priniesol, nikdy nevznikne a nedá sa obnoviť. Ak ju chcete, položte otázku znova.
    • Druhé zrušenie tej istej relácie je neškodné a jednoducho vráti cancelled: false.
    • Zrušiť môžete len vlastné behy; požiadavka sa nikdy nedotkne relácie iného používateľa.