Atpakaļ uz informācijas paneli

Dokumentācija

Uzziniet, kā lietot Asyntai

Reāllaika datu plūsma

Connect your chatbot to live data sources for dynamic responses

Konfigurēt datu plūsmu
Standard un Pro plāni

Pārskats

Reāllaika datu plūsma ļauj jūsu tērzbotam piekļūt tiešsaistes datiem no jūsu sistēmām. Statisko atbilžu vietā jūsu AI var sniegt aktuālu informāciju, piemēram, pašreizējo pieejamību, cenas, gaidīšanas laikus vai krājumu līmeņus.

Vienkārši norādiet URL, kas atgriež jūsu datus (JSON vai vienkāršu tekstu), un tērzbots automātiski iekļaus šo informāciju, atbildot uz attiecīgajiem jautājumiem.

Standarta Reāllaika datu plūsma atbalsta plūsmas līdz 200 000 rakstzīmēm (~500 vienību). Lielākām datu plūsmām skatiet Reāllaika datu plūsma Max, kas atbalsta līdz 10 000 000 rakstzīmju (~25 000 vienību).

Kā tas darbojas

  1. Jūs norādāt URL - API galapunktu vai lapu, kas atgriež jūsu tiešsaistes datus
  2. Tērzbots iegūst datus - AI nolasa visu plūsmu ar katru nosūtīto ziņojumu, nodrošinot, ka atbildes vienmēr izmanto jaunākos datus
  3. Dinamiskās atbildes - Atbildes ietver reāllaika datus no jūsu avota
MI asistents
Vai jums ir pieejamas istabas šovakar?
Jā! Mums ir pieejamība šovakaram:

Deluxe Suite - Atlikušas 3 istabas par $299/nakti
Standarta istaba - Atlikušas 8 istabas par $149/nakti

Vai vēlaties, lai palīdzu jums rezervēt?
Kā ar rītdienu?
Rītdienai mums ir:

Deluxe Suite - 2 istabas par $299/nakti
Standarta istaba - 5 istabas par $149/nakti

Lietošanas gadījumi

Reāllaika datu plūsmas ir ideālas uzņēmumiem, kuriem jāsniedz aktuāla informācija:

Viesnīcas Istabu pieejamība un cenas pēc datuma
Restorāni Gaidīšanas laiki, galdu pieejamība, darba laiki
E-komercija Krājumu līmeņi un produktu pieejamība
Pakalpojumi Pierakstu laiki un grafiku plānošana

Iestatīšana

Reāllaika datu plūsmas pievienošana aizņem tikai dažus soļus:

1
Izveidojiet savu datu galapunktu Iestatiet URL, kas atgriež jūsu tiešsaistes datus (API vai tīmekļa lapu)
2
Dodieties uz Reāllaika datu plūsmu Savas vietnes izvēlnē noklikšķiniet "Reāllaika datu plūsma"
3
Ievadiet savu URL Ielīmējiet URL, kas atgriež jūsu datus, un noklikšķiniet Saglabāt

Padoms: Pārliecinieties, ka jūsu galapunkts ir publiski pieejams (nav nepieciešama autentifikācija), lai tērzbots varētu iegūt datus.

Savienojuma verifikācija

Pēc datu plūsmas URL saglabāšanas Asyntai automātiski pārbauda savienojumu. Jūs redzēsiet statusa karti, kas rāda:

  • Savienojuma statuss — vai URL tika veiksmīgi sasniegts
  • Datu formāts — noteiktais formāts (JSON, HTML/XML vai vienkāršs teksts)
  • Atbildes lielums — cik daudz datu tika atgriezts
  • Satura priekšskatījums — atbildes fragments, lai varat apstiprināt, ka tie ir pareizie dati

Ja tiešais savienojums neizdo das, Asyntai automātiski mēģinās rezerves starpniekserveri, lai sasniegtu jūsu URL. Ja abas metodes neizdo das, jūsu URL joprojām tiek saglabāts — jūs tikai redzēsit paziņojumu ar problēmu novēršanas ieteikumiem.

Atbalstītie formāti

Jūsu datu plūsmas URL ir jāatgriež dati vienā no šiem formātiem:

JSON formāts

Strukturēti dati visvairāk noder saržģītai informācijai, piemēram, krājumiem vai grafikiem.

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

Vienkārša teksta formāts

Vienkāršs teksts der tiešai informācijai.

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

Dinamiskās produktu kartes

Ja jūsu reāllaika datu plūsma satur produktu informāciju (piemēram, krājums, istabas vai pakalpojumi), varat iespējot Dinamiskās produktu kartes, lai tās attēlotu kā skaistas vizuālas kartes tērzēšanā.

Kā iespējot

  1. Dodieties uz Reāllaika datu plūsmas iestatījumiem
  2. Pievienojiet savu datu plūsmas URL (skatīt piemēru)
  3. Toggle "Enable Dynamic Product Cards" ON
  4. Saglabājiet savus iestatījumus

Datu formāts

Iekļaujiet produktu detaļas savā plūsmā ar šādiem laukiem:

  • name - Produkta/vienības nosaukums (obligāts)
  • price — Attēlošanas cena (piem., "$99.99")
  • description — Īss apraksts
  • image_url - Produkta attēla URL
  • button_link — Saite darbības pogai
  • in_stock — Pieejamības statuss (true/false)

Šeit ir piemērs, kā jūsu JSON plūsmai būtu jāizskatās (skatīt JSON parauga failu):

{
  "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
    }
  ]
}

Padoms: Dinamiskās produktu kartes lieliski darbojas e-komercijas krājumiem, viesnīcu istabām, nomas priekšmetiem vai jebkuriem produktiem, kas bieži mainās. Statiskiem produktiem tā vietā izmantojiet Produktu kartes.

Nozaru piemēri

Šeit ir detalizēti piemēri, kā dažādi uzņēmumi var strukturēt savas reāllaika datu plūsmas:

Šie ir tikai piemēri - varat iekļaut jebkurus laukus, kas ir būtiski jūsu uzņēmumam. AI sapratīs un izmantos jebkurus jūsu sniegtos datus.
E-komercijas veikals Produktu pieejamība, cenas, URL un akcijas
{
  "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"
  }
}
Klients: "Vai jums ir bezvadu austiņas noliktavā?"
AI: "Jā! Bezvadu austiņas Pro ir noliktavā ar 23 pieejamām vienībām. Pašlaik tās ir izpārdošanā par $119.99 (parasti $149.99). Varat apskatīt un iegādāties tās šeit: techgadgets.com/products/wireless-headphones-pro. Turklāt izmantojiet kodu SAVE20, lai saņemtu papildus 20% atlaidi pasūtījumiem virs $100!"
Veselības aprūpe / Medicīnas klīnika Pieņemšanas pieejamība un gaidīšanas laiki
{
  "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"
  }
}
Pacients: "Man šonedēļ jāapmeklē dermatoloģs"
AI: "Agrākā dermatoloģijas pieņemšana ir sestdien, 18. janvārī, plkst. 10:00 vai 11:00. Ja tie neder, ir vairāk pieejamo laiku pirmdien, 20. datumā, plkst. 9:00, 14:00 vai 15:00. Varat pieteikties tiešsaistē downtownmedical.com/book."
Fitnesa centrs / Sporta zāle Nodarbību grafiki un telpu ietilpība
{
  "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"
}
Biedrs: "Kādas jogas nodarbības jums ir šonedēļ?"
AI: "Šeit ir jogas nodarbības šonedēļ: trešdien 19:00 Jogas plūsma ar Sāru (12 vietas), piektdien 7:00 Jogas plūsma ar Sāru (15 vietas) un sestdien 10:30 Ģimenes joga ar Sāru (10 vietas). Varat pieteikties fitlifegym.com/classes."
Auto noma / Auto pakalpojumi Transportlīdzekļu pieejamība pēc datuma un atrašanās vietas
{
  "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"}
  ]
}
Klients: "Man vajag SUV šajā nedēļas nogalē"
AI: "Mums ir pieejami SUV piektdien (3 atlikuši par $89.99/dienā) un sestdien (1 atlicis par $99.99/dienā), bet svētdiena ir izpārdota. Rezervējiet drīz! Izmantojiet kodu WEEKEND15, lai saņemtu 15% atlaidi. Rezervējiet quickrent.com/book."
Pasākumi / Izklaides vieta Izrādes, biļetes un grafiki
{
  "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}
      ]
    }
  ]
}
Klients: "Kādas izrādes jums ir šajā nedēļas nogalē?"
AI: "Šajā nedēļas nogalē mums ir 'The Musical Experience' piektdien un sestdien plkst. 19:30 (arī sestdienas matinēja plkst. 14:00) - biļetes ir $85. Sestdien un svētdien plkst. 20:00 ir 'Comedy Night Live' par $45. Piektdienas vakars izpārdodas ātri, atlikušas tikai 43 vietas! Rezervējiet grandtheater.com/tickets."
Nekustamais īpašums / Īpašumu pārvaldība Sludinājumi, cenas un apskates grafiki
{
  "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"
}
Klients: "Kādi dzīvokļi jums ir zem $1500?"
AI: "Mums ir 1 istabas dzīvoklis 789 Pine Road par $1200/mēnesī, pieejams no 15. februāra. Tas ir 60 m² ar piekļuvi sporta zālei, jumta terasi un durvju sargu. Atklāto durvju diena ir sestdien, 18. janvārī, plkst. 13:00, vai pieteikties privātai apskatei premierproperties.com/schedule. Skatīt detaļas: premierproperties.com/listing/apt-12c"

Izmēra ierobežojumi

Standarta Reāllaika datu plūsma atbalsta plūsmas līdz 200 000 rakstzīmēm. Vienību skaits, ko varat iekļaut, ir atkarīgs no katra elementa datu apjoma — plūsma ar īsiem, kodolīgiem ierakstiem var ietvert ~500 vienības, savukārt plūsma ar gariem aprakstiem var ietvert tikai daļu no tā. Ja jūsu plūsma pārsniedz šo ierobežojumu, saglabāšanas laikā tiks parādīts paziņojums.

Padomi plūsmas izmēra samazināšanai

Ja jūsu plūsma ir pārāk liela, šeit ir daži veidi, kā to iekļaut ierobežojumā:

  • Iekļaujiet tikai vispopulārākās preces — Koncentrējieties uz produktiem, par kuriem klienti jautā visvairāk
  • Noņemiet nevajadzīgos laukus — Izslēdziet iekšējos ID, metadatus vai laukus, kas tērzbotam nav nepieciešami
  • Samaziniet aprakstus — Izmantojiet kodolīgus produktu aprakstus pilnu mārketinga tekstu vietā. Skatiet ieteicamo parauga struktūru, lai redzētu piemēru, kā saglabāt ierakstus kompaktus
  • Filtrējiet pēc pieejamības — Iekļaujiet tikai preces, kas pašlaik ir noliktavā vai aktīvas
  • Sadaliet pēc kategorijām — Izveidojiet plūsmu savai visatbilstošākajai produktu kategorijai, nevis visam

Padoms: Ja jums jāpievieno lielāka datu plūsma ar tūkstošiem vienību, izmantojiet Reāllaika datu plūsma Max (Pro plāns), kas atbalsta līdz 10 000 000 rakstzīmju (~25 000 vienību).

Labākā prakse

  • Uzturiet datus aktuālus — Jūsu galapunktam jāatgriež aktuāla informācija, nevis kešoti dati
  • Iekļaujiet kontekstu — Pievienojiet datumus, laikus vai etiķetes, lai AI saprastu, ko dati nozīmē
  • Strukturējiet skaidri — Izmantojiet skaidrus lauku nosaukumus JSON formātā, lai AI varētu pareizi interpretēt datus
  • Saglabājiet fokusu — Iekļaujiet tikai datus, kas tērzbotam nepieciešami, lai atbildētu uz jautājumiem

Svarīgi: URL ir jābūt publiski pieejamam. Ja jūsu galapunktam nepieciešama autentifikācija, tērzbots nevarēs iegūt datus.

Noņemt datu plūsmu

Varat noņemt datu plūsmu jebkurā laikā, noklikšķinot pogu "Noņemt datu plūsmu" savos iestatījumos. Tērzbots atgriezīsies pie tikai zināšanu bāzes izmantošanas atbilžu sniegšanai.

Piezīme: Reāllaika datu plūsma ir pieejama Standard un Pro plānos. Nepieciešams pieslēgt lielākas datu plūsmas ar tūkstošiem vienību? Skatiet Reāllaika datu plūsma Max (Pro plāns).

Izmēģiniet

Vēl nav sava API galapunkta? Varat pārbaudīt šo funkciju ar publisku API, lai redzētu, kā tā darbojas. Piemēram, izmēģiniet tiešsaistes Bitcoin cenu no Binance:

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

Šis atgriež reāllaika BTC/USDT cenu datus. Pēc pievienošanas jūsu tērzbots varēs atbildēt uz jautājumiem, piemēram, "Kāda ir pašreizējā Bitcoin cena?" izmantojot tiešsaistes datus.

Padoms: Varat izmantot jebkuru publisku API, kas atgriež JSON vai vienkāršu tekstu — laikapstākļu datus, akciju cenas, valūtas kursus un daudz ko citu. Nomainiet to ar savu galapunktu, kad esat gatavs.