Duomenų srautas realiuoju laiku

Connect your chatbot to live data sources for dynamic responses

Standard ir Pro planai

Apžvalga

Realaus laiko duomenų srautas leidžia jūsų pokalbių robotui pasiekti gyvus duomenis iš jūsų sistemų. Vietoj statinių atsakymų, jūsų DI gali pateikti naujausią informaciją apie esamą prieinamumą, kainas, laukimo laikus ar atsargų lygius.

Tiesiog pateikite URL, kuris grąžina jūsų duomenis (JSON arba paprastą tekstą), ir pokalbių robotas automatiškai įtrauks šią informaciją atsakydamas į susijusius klausimus.

Standartinis Realaus laiko duomenų srautas palaiko srautus iki 200 000 simbolių (~500 elementų). Didesniems duomenų srautams žiūrėkite Realaus laiko duomenų srautas Max, kuris palaiko iki 10 000 000 simbolių (~25 000 elementų).

Kaip tai veikia

Jūs pateikiate URL - API galutinį tašką arba puslapį, kuris grąžina jūsų gyvus duomenis
Pokalbių robotas gauna duomenis - DI perskaito visą srautą su kiekviena išsiųsta žinute, užtikrindamas, kad atsakymai visada naudoja naujausius duomenis
Dinaminiai atsakymai - Atsakymai apima realaus laiko duomenis iš jūsų šaltinio

DI asistentas

Ar turite laisvų kambarių šį vakarą?

Taip! Šiam vakarui turime:

Prabangus liuksas - Liko 3 kambariai po $299/naktį
Standartinis kambarys - Liko 8 kambariai po $149/naktį

Ar norėtumėte, kad padėčiau užsakyti?

O kaip dėl rytojaus?

Rytojui turime:

Prabangus liuksas - 2 kambariai po $299/naktį
Standartinis kambarys - 5 kambariai po $149/naktį

Naudojimo atvejai

Realaus laiko duomenų srautai puikiai tinka įmonėms, kurioms reikia pateikti naujausią informaciją:

Viešbučiai Kambarių prieinamumas ir kainos pagal datą

Restoranai Laukimo laikas, stalų prieinamumas, darbo valandos

Elektroninė prekyba Atsargų lygiai ir produktų prieinamumas

Paslaugos Vizitų laikai ir tvarkaraščiai

Nustatymas

Realaus laiko duomenų srauto pridėjimas užtrunka tik kelis žingsnius:

Sukurkite savo duomenų galutinį tašką Nustatykite URL, kuris grąžina jūsų gyvus duomenis (API arba tinklalapį)

Eikite į Realaus laiko duomenų srautą Savo svetainės meniu spustelėkite "Realaus laiko duomenų srautas

Įveskite savo URL Įklijuokite URL, kuris grąžina jūsų duomenis, ir spustelėkite Išsaugoti

Patarimas: Įsitikinkite, kad jūsų galutinis taškas yra viešai prieinamas (nereikia autentifikacijos), kad pokalbių robotas galėtų gauti duomenis.

Ryšio patikrinimas

Išsaugojus duomenų srauto URL, Asyntai automatiškai patikrina ryšį. Pamatysite būsenos kortelę, rodančią:

Ryšio būsena — ar URL buvo sėkmingai pasiektas
Duomenų formatas — aptiktas formatas (JSON, HTML/XML arba paprastas tekstas)
Atsakymo dydis — kiek duomenų buvo grąžinta
Turinio peržiūra — atsakymo fragmentas, kad galėtumėte patvirtinti, jog tai teisingi duomenys

Jei tiesioginis ryšys nepavyksta, Asyntai automatiškai bandys atsarginį tarpinį serverį, kad pasiektų jūsų URL. Jei abu metodai nepavyksta, jūsų URL vis tiek bus išsaugotas — tik pamatysite pranešimą su trikčių šalinimo pasiūlymais.

Palaikomi formatai

Jūsų duomenų srauto URL turėtų grąžinti duomenis vienu iš šių formatų:

JSON formatas

Struktūrizuoti duomenys geriausiai tinka sudėtingai informacijai, tokiai kaip atsargos ar tvarkaraščiai.

{
  "current_date": "2025-01-15",
  "rooms": [
    {
      "type": "Deluxe Suite",
      "available": 3,
      "price": 299.99
    },
    {
      "type": "Standard Room",
      "available": 8,
      "price": 149.99
    }
  ]
}

Paprasto teksto formatas

Paprastas tekstas tinka nesudėtingai informacijai.

Current wait time: 15 minutes
Tables available: 3
Kitchen closes at: 10 PM

Dinaminės produktų kortelės

Jei jūsų realaus laiko duomenų sraute yra produktų informacijos (pvz., atsargos, kambariai ar paslaugos), galite įjungti Dinamines produktų korteles, kad jos būtų rodomos kaip gražios vizualinės kortelės pokalbyje.

Kaip įjungti

Eikite į Realaus laiko duomenų srauto nustatymus
Pridėkite savo duomenų srauto URL (žiūrėti pavyzdį)
Įjunkite "Įgalinti dinamines produktų korteles"
Išsaugokite nustatymus

Duomenų formatas

Įtraukite produktų informaciją į savo srautą su tokiais laukais:

name - Produkto/prekės pavadinimas (privalomas)
price - Rodoma kaina (pvz., "$99.99")
description - Trumpas aprašymas
image_url - Produkto nuotraukos URL
button_link - Veiksmo mygtuko nuoroda
in_stock - Prieinamumo būsena (true/false)

Štai pavyzdys, kaip turėtų atrodyti jūsų JSON srautas (peržiūrėti pavyzdinį JSON failą):

{
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "price": "$149.99",
      "description": "Noise-cancelling over-ear headphones with 30h battery",
      "image_url": "https://yourstore.com/images/headphones-pro.jpg",
      "button_link": "https://yourstore.com/products/headphones-pro",
      "in_stock": true
    },
    {
      "name": "Smart Watch Ultra",
      "price": "$299.99",
      "description": "GPS, heart rate monitor, 5ATM water resistance",
      "image_url": "https://yourstore.com/images/smart-watch-ultra.jpg",
      "button_link": "https://yourstore.com/products/smart-watch-ultra",
      "in_stock": true
    },
    {
      "name": "Portable Charger 20K",
      "price": "$39.99",
      "description": "20,000mAh fast charging power bank with USB-C",
      "image_url": "https://yourstore.com/images/charger-20k.jpg",
      "button_link": "https://yourstore.com/products/charger-20k",
      "in_stock": false
    }
  ]
}

Patarimas: Dinaminės produktų kortelės puikiai tinka elektroninės prekybos asortimentui, viešbučių kambariams, nuomos prekėms ar bet kokiems dažnai besikeičiantiems produktams. Statiniams produktams naudokite Produktų korteles.

Pramonės pavyzdžiai

Štai išsamūs pavyzdžiai, kaip skirtingos įmonės gali struktūrizuoti savo realaus laiko duomenų srautus:

Tai tik pavyzdžiai - galite įtraukti bet kokius jūsų verslui svarbius laukus. DI supras ir naudos bet kokius jūsų pateiktus duomenis.

Elektroninė parduotuvė Produktų prieinamumas, kainos, URL ir akcijos

{
  "store_name": "TechGadgets Store",
  "store_url": "https://techgadgets.com",
  "last_updated": "2025-01-15T14:30:00Z",
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "sku": "WHP-001",
      "url": "https://techgadgets.com/products/wireless-headphones-pro",
      "price": 149.99,
      "sale_price": 119.99,
          "in_stock": true,
      "quantity_available": 23,
      "category": "Audio"
    },
    {
      "name": "Smart Watch Series X",
      "sku": "SWX-002",
      "url": "https://techgadgets.com/products/smart-watch-series-x",
      "price": 299.99,
          "in_stock": true,
      "quantity_available": 8,
      "category": "Wearables"
    },
    {
      "name": "Bluetooth Speaker Mini",
      "sku": "BSM-003",
      "url": "https://techgadgets.com/products/bluetooth-speaker-mini",
      "price": 49.99,
          "in_stock": false,
      "restock_date": "2025-01-20",
      "category": "Audio"
    }
  ],
  "active_promotions": [
    {
      "code": "SAVE20",
      "description": "20% off orders over $100",
      "expires": "2025-01-31"
    }
  ],
  "shipping": {
    "free_shipping_threshold": 50,
    "estimated_delivery": "2-3 business days"
  }
}

Klientas: "Ar turite belaidžių ausinių sandėlyje?"

DI: "Taip! Wireless Headphones Pro yra sandėlyje, turimi 23 vienetai. Šiuo metu jie parduodami už $119.99 (įprasta kaina $149.99). Galite juos peržiūrėti ir įsigyti čia: techgadgets.com/products/wireless-headphones-pro. Be to, naudokite kodą SAVE20 papildomai 20% nuolaidai užsakymams virš $100!"

Sveikatos priežiūra / Medicinos klinika Vizitų prieinamumas ir laukimo laikas

{
  "clinic_name": "Downtown Medical Center",
  "booking_url": "https://downtownmedical.com/book",
  "current_wait_times": {
    "General Practice": 25,
    "Pediatrics": 15,
    "Urgent Care": 40
  },
  "available_appointments": {
    "General Practice": [
      {"date": "2025-01-15", "slots": ["3:30 PM", "4:00 PM", "4:30 PM"]},
      {"date": "2025-01-16", "slots": ["9:00 AM", "10:30 AM", "2:00 PM", "3:30 PM"]},
      {"date": "2025-01-17", "slots": ["9:00 AM", "11:00 AM", "1:00 PM"]}
    ],
    "Dermatology": [
      {"date": "2025-01-18", "slots": ["10:00 AM", "11:00 AM"]},
      {"date": "2025-01-20", "slots": ["9:00 AM", "2:00 PM", "3:00 PM"]}
    ],
    "Pediatrics": [
      {"date": "2025-01-15", "slots": ["4:00 PM", "5:00 PM"]},
      {"date": "2025-01-16", "slots": ["9:00 AM", "10:00 AM", "11:00 AM", "2:00 PM"]}
    ]
  },
  "accepting_new_patients": true,
  "operating_hours": {
    "weekdays": "8:00 AM - 6:00 PM",
    "saturday": "9:00 AM - 1:00 PM",
    "sunday": "Closed"
  }
}

Pacientas: "Man reikia apsilankyti pas dermatologą šią savaitę"

DI: "Anksčiausias dermatologijos vizitas yra šeštadienį, sausio 18 d., 10:00 arba 11:00 val. Jei šie laikai netinka, daugiau laisvų laikų yra pirmadienį, 20 d., 9:00, 14:00 arba 15:00 val. Galite užsiregistruoti internetu adresu downtownmedical.com/book."

Fitneso centras / Sporto salė Užsiėmimų tvarkaraščiai ir patalpų talpa

{
  "gym_name": "FitLife Gym",
  "booking_url": "https://fitlifegym.com/classes",
  "current_status": {
    "occupancy": 45,
    "capacity": 150,
    "pool": "open",
    "sauna": "maintenance until Jan 20"
  },
  "class_schedule": [
    {
      "date": "2025-01-15",
      "day": "Wednesday",
      "classes": [
        {"time": "12:00 PM", "name": "HIIT Training", "instructor": "Mike", "spots_left": 8},
        {"time": "5:30 PM", "name": "Spin Class", "instructor": "Jessica", "spots_left": 3},
        {"time": "7:00 PM", "name": "Yoga Flow", "instructor": "Sarah", "spots_left": 12}
      ]
    },
    {
      "date": "2025-01-16",
      "day": "Thursday",
      "classes": [
        {"time": "6:00 AM", "name": "Morning Bootcamp", "instructor": "Mike", "spots_left": 10},
        {"time": "12:00 PM", "name": "Pilates", "instructor": "Emma", "spots_left": 6},
        {"time": "6:00 PM", "name": "Boxing Fitness", "instructor": "Carlos", "spots_left": 4}
      ]
    },
    {
      "date": "2025-01-17",
      "day": "Friday",
      "classes": [
        {"time": "7:00 AM", "name": "Yoga Flow", "instructor": "Sarah", "spots_left": 15},
        {"time": "5:30 PM", "name": "HIIT Training", "instructor": "Mike", "spots_left": 12},
        {"time": "6:30 PM", "name": "Zumba", "instructor": "Maria", "spots_left": 20}
      ]
    },
    {
      "date": "2025-01-18",
      "day": "Saturday",
      "classes": [
        {"time": "9:00 AM", "name": "Weekend Warrior", "instructor": "Carlos", "spots_left": 8},
        {"time": "10:30 AM", "name": "Family Yoga", "instructor": "Sarah", "spots_left": 10}
      ]
    }
  ],
  "membership_info_url": "https://fitlifegym.com/join"
}

Narys: "Kokias jogos pamokas turite šią savaitę?"

DI: "Štai šios savaitės jogos pamokos: trečiadienį 19:00 Yoga Flow su Sarah (12 vietų), penktadienį 7:00 Yoga Flow su Sarah (15 vietų) ir šeštadienį 10:30 Šeimos joga su Sarah (10 vietų). Galite užsiregistruoti adresu fitlifegym.com/classes."

Automobilių nuoma / Autopaslaugos Transporto priemonių prieinamumas pagal datą ir vietą

{
  "company": "QuickRent Cars",
  "booking_url": "https://quickrent.com/book",
  "availability": {
    "2025-01-17": {
      "Economy": {"available": 5, "price_per_day_usd": 45.99},
      "SUV": {"available": 3, "price_per_day_usd": 89.99},
      "Luxury": {"available": 1, "price_per_day_usd": 159.99}
    },
    "2025-01-18": {
      "Economy": {"available": 3, "price_per_day_usd": 52.99},
      "SUV": {"available": 1, "price_per_day_usd": 99.99},
      "Luxury": {"available": 2, "price_per_day_usd": 179.99}
    },
    "2025-01-19": {
      "Economy": {"available": 2, "price_per_day_usd": 52.99},
      "SUV": {"available": 0, "price_per_day_usd": null},
      "Luxury": {"available": 2, "price_per_day_usd": 179.99}
    }
  },
  "active_promotions": [
    {"code": "WEEKEND15", "description": "15% off Fri-Sun rentals"}
  ]
}

Klientas: "Man reikia visureigio šiam savaitgaliui"

DI: "Turime laisvų visureigių penktadienį (liko 3 po $89.99/dieną) ir šeštadienį (liko 1 po $99.99/dieną), bet sekmadienis išparduotas. Užsakykite greičiau! Naudokite kodą WEEKEND15 15% nuolaidai. Rezervuokite adresu quickrent.com/book."

Renginiai / Pramogų vieta Pasirodymai, bilietai ir tvarkaraščiai

{
  "venue": "Grand Theater",
  "tickets_url": "https://grandtheater.com/tickets",
  "shows": [
    {
      "title": "The Musical Experience",
      "url": "https://grandtheater.com/shows/musical-experience",
      "duration": "2h 30min",
      "price_usd": 85,
      "performances": [
        {"date": "2025-01-15", "time": "7:30 PM", "seats_available": 43},
        {"date": "2025-01-16", "time": "7:30 PM", "seats_available": 115},
        {"date": "2025-01-17", "time": "2:00 PM", "seats_available": 155},
        {"date": "2025-01-17", "time": "7:30 PM", "seats_available": 70}
      ]
    },
    {
      "title": "Comedy Night Live",
      "url": "https://grandtheater.com/shows/comedy-night",
      "duration": "2h",
      "price_usd": 45,
      "performances": [
        {"date": "2025-01-18", "time": "8:00 PM", "seats_available": 120},
        {"date": "2025-01-19", "time": "8:00 PM", "seats_available": 85}
      ]
    }
  ]
}

Klientas: "Kokius pasirodymus turite šį savaitgalį?"

DI: "Šį savaitgalį turime 'The Musical Experience' penktadienį ir šeštadienį 19:30 (taip pat šeštadienį 14:00 dieninis seansas) - bilietai po $85. Šeštadienį ir sekmadienį 20:00 vyksta 'Comedy Night Live' po $45. Penktadienio vakaras greitai išsiperka - liko tik 43 vietos! Užsakykite adresu grandtheater.com/tickets."

Nekilnojamasis turtas / Turto valdymas Skelbimai, kainos ir apžiūros tvarkaraščiai

{
  "agency": "Premier Properties",
  "website": "https://premierproperties.com",
  "listings": [
    {
      "id": "APT-4B",
      "url": "https://premierproperties.com/listing/apt-4b",
      "address": "123 Oak Street, Apt 4B",
      "type": "Apartment",
      "bedrooms": 2,
      "bathrooms": 1,
      "sqft": 950,
      "rent_usd_per_month": 1850,
      "available_from": "2025-02-01",
      "features": ["In-unit laundry", "Parking included", "Pet-friendly", "Balcony"],
      "open_houses": ["2025-01-18 11:00 AM", "2025-01-19 2:00 PM"]
    },
    {
      "id": "HSE-456",
      "url": "https://premierproperties.com/listing/hse-456",
      "address": "456 Maple Avenue",
      "type": "House",
      "bedrooms": 3,
      "bathrooms": 2,
      "sqft": 1800,
      "rent_usd_per_month": 2800,
      "available_from": "Immediate",
      "features": ["Backyard", "2-car garage", "Updated kitchen", "Central AC"],
      "open_houses": ["2025-01-16 2:00 PM", "2025-01-17 10:00 AM"]
    },
    {
      "id": "APT-12C",
      "url": "https://premierproperties.com/listing/apt-12c",
      "address": "789 Pine Road, Unit 12C",
      "type": "Apartment",
      "bedrooms": 1,
      "bathrooms": 1,
      "sqft": 650,
      "rent_usd_per_month": 1200,
      "available_from": "2025-02-15",
      "features": ["Gym access", "Rooftop deck", "Doorman"],
      "open_houses": ["2025-01-18 1:00 PM"]
    }
  ],
  "contact_url": "https://premierproperties.com/contact",
  "schedule_viewing_url": "https://premierproperties.com/schedule"
}

Klientas: "Kokius butus turite iki $1500?"

DI: "Turime 1 miegamojo butą adresu 789 Pine Road už $1 200/mėn., prieinamą nuo vasario 15 d. Jis yra 60 kv. m su sporto salės prieiga, stogo terasa ir durininku. Atviras lankymas šeštadienį, sausio 18 d., 13:00 val., arba suplanuokite privatų apsilankymą adresu premierproperties.com/schedule. Peržiūrėkite detales: premierproperties.com/listing/apt-12c"

Dydžio limitai

Standartinis Realaus laiko duomenų srautas palaiko srautus iki 200 000 simbolių. Elementų, kuriuos galite įtraukti, skaičius priklauso nuo to, kiek duomenų kiekvienas elementas turi — srautas su trumpais, glaustais įrašais gali tilpti ~500 elementų, o srautas su ilgais aprašymais gali tilpti tik dalį to. Jei jūsų srautas viršija šį limitą, bandydami išsaugoti pamatysite pranešimą.

Patarimai srauto dydžiui sumažinti

Jei jūsų srautas per didelis, štai keli būdai, kaip jį sumažinti iki limito:

Įtraukite tik populiariausias prekes — Sutelkite dėmesį į produktus, apie kuriuos klientai dažniausiai klausia
Pašalinkite nereikalingus laukus — Atsisakykite vidinių ID, metaduomenų ar laukų, kurių pokalbių robotui nereikia
Sutrumpinkite aprašymus — Naudokite glaustus produktų aprašymus vietoj pilno reklaminio teksto. Peržiūrėkite rekomenduojamą pavyzdinę struktūrą, kaip išlaikyti įrašus kompaktiškus
Filtruokite pagal prieinamumą — Įtraukite tik prekes, kurios šiuo metu yra sandėlyje arba aktyvios
Skaidykite pagal kategoriją — Sukurkite srautą svarbiausiai produktų kategorijai, o ne viskam

Patarimas: Jei jums reikia prijungti didesnį duomenų srautą su tūkstančiais elementų, naudokite Realaus laiko duomenų srautą Max (Pro planas), kuris palaiko iki 10 000 000 simbolių (~25 000 elementų).

Geriausi praktikos pavyzdžiai

Laikykite duomenis naujus — Jūsų galutinis taškas turėtų grąžinti esamą informaciją, o ne talpyklos duomenis
Įtraukite kontekstą — Pridėkite datas, laikus ar žymas, kad DI suprastų, ką duomenys reiškia
Struktūrizuokite aiškiai — Naudokite aiškius laukų pavadinimus JSON formatu, kad DI galėtų teisingai interpretuoti duomenis
Laikykite sutelktą — Įtraukite tik tuos duomenis, kurių pokalbių robotui reikia atsakymams

Svarbu: URL turi būti viešai prieinamas. Jei jūsų galutinis taškas reikalauja autentifikacijos, pokalbių robotas negalės gauti duomenų.

Pašalinti duomenų srautą

Galite bet kada pašalinti duomenų srautą spustelėję mygtuką "Pašalinti duomenų srautą" savo nustatymuose. Pokalbių robotas grįš prie atsakymų tik iš jūsų žinių bazės.

Pastaba: Realaus laiko duomenų srautas prieinamas Standard ir Pro planuose. Reikia prijungti didesnius duomenų srautus su tūkstančiais elementų? Žiūrėkite Realaus laiko duomenų srautą Max (Pro planas).

Išbandykite

Dar neturite savo API galutinio taško? Galite išbandyti funkciją su vieša API, kad pamatytumėte, kaip ji veikia. Pavyzdžiui, išbandykite gyvą Bitcoin kainą iš Binance:

https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

Tai grąžina realaus laiko BTC/USDT kainos duomenis. Prisijungus, jūsų pokalbių robotas galės atsakyti į klausimus, tokius kaip "Kokia dabartinė Bitcoin kaina?", naudodamas gyvus duomenis.

Patarimas: Galite naudoti bet kokią viešą API, kuri grąžina JSON arba paprastą tekstą — orų duomenis, akcijų kainas, valiutų kursus ir daugiau. Pakeiskite ją savo galutiniu tašku, kai būsite pasiruošę.

Dokumentacija