Grįžti į valdymo skydą

Dokumentacija

Sužinokite, kaip naudoti Asyntai

Duomenų srautas realiuoju laiku

Sujunkite savo pokalbių robotą su tiesioginiais duomenų šaltiniais dinaminiams atsakymams

Konfigūruoti duomenų srautą
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, CSV arba paprastą tekstą), ir pokalbių robotas automatiškai naudos šią informaciją atsakydamas į susijusius klausimus.

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

Kaip tai veikia

  1. Jūs pateikiate URL - API galutinį tašką arba puslapį, kuris grąžina jūsų gyvus duomenis
  2. Pokalbių robotas indeksuoja jūsų duomenis - Jūsų srautas automatiškai indeksuojamas ir palaikomas atnaujintas. Kiekvienam pokalbiui AI randa ir naudoja aktualiausius elementus iš jūsų srauto
  3. Dinaminiai atsakymai - Atsakymai apima realaus laiko duomenis iš jūsų šaltinio

Patarimas: Esamų prekių pakeitimai, tokie kaip kainos, atsargų lygiai ir prieinamumas, atspindimi iš karto. Kai į savo srautą pridedate visiškai naujų produktų ar prekių, jie pasirodys pokalbių roboto atsakymuose per 24 valandas.

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

Sąranka

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

1
Sukurkite savo duomenų galutinį tašką Nustatykite URL, kuris grąžina jūsų gyvus duomenis (API arba tinklalapį)
2
Eikite į Realaus laiko duomenų srautą Savo svetainės meniu spustelėkite "Realaus laiko duomenų srautas"
3
Į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
    }
  ]
}

CSV formatas

Kableliais atskirtos reikšmės puikiai tinka produktų katalogams, atsargų eksportui ir skaičiuoklių duomenims.

id,title,description,availability,price,link,image_link
101,"Wireless Headphones","Noise-cancelling, 30h battery","in stock","149.99 USD",https://store.com/headphones,https://store.com/img/hp.jpg
102,"Smart Watch","GPS, heart rate monitor","in stock","299.99 USD",https://store.com/watch,https://store.com/img/sw.jpg
103,"Portable Charger","20000mAh USB-C","out of stock","39.99 USD",https://store.com/charger,https://store.com/img/pc.jpg

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

  1. Eikite į Realaus laiko duomenų srauto nustatymus
  2. Pridėkite savo duomenų srauto URL (žiūrėti pavyzdį)
  3. Perjunkite "Įgalinti dinamines produktų korteles" į ĮJUNGTA
  4. 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 650 kv. pėdų su sporto salės prieiga, stogo terasa ir durininku. Atviros durys š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ų).

Geriausios praktikos

  • 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: You can use any public API that returns JSON or plain text — weather data, stock prices, exchange rates, and more. Replace it with your own endpoint when you're ready.

Platform Guides

Using a specific CMS or e-commerce platform? We have step-by-step setup instructions for each — pick yours below to jump straight to the guide. The setup works for both Real-Time Data Feed and Real-Time Data Feed Max; only the feed size limits differ.