Nazaj na nadzorno ploščo

Dokumentacija

Naučite se uporabljati Asyntai

Podatkovni vir v realnem času

Connect your chatbot to live data sources for dynamic responses

Nastavitev vira podatkov
Načrta Standard in Pro

Pregled

Vir podatkov v realnem času omogoča vašemu klepetalniku dostop do podatkov v živo iz vaših sistemov. Namesto statičnih odgovorov lahko vaša umetna inteligenca zagotavlja posodobljene informacije, kot so trenutna razpoložljivost, cene, čakalni časi ali ravni zalog.

Preprosto navedite URL, ki vrne vaše podatke (JSON ali navadno besedilo), in klepetalnik bo samodejno vključil te informacije pri odgovarjanju na ustrezna vprašanja.

Standardni vir podatkov v realnem času podpira vire do 200.000 znakov (~500 elementov). Za večje vire podatkov glejte Real-Time Data Feed Max, ki podpira do 10.000.000 znakov (~25.000 elementov).

Kako deluje

  1. Vi navedete URL - končno točko API ali stran, ki vrne vaše podatke v živo
  2. Klepetalnik pridobi podatke - UI prebere celoten vir ob vsakem poslanem sporočilu, kar zagotavlja, da odgovori vedno uporabljajo najnovejše podatke
  3. Dinamični odgovori - Odgovori vključujejo podatke v realnem času iz vašega vira
Pomočnik UI
Ali imate nocoj na voljo kakšne sobe?
Da! Za nocoj imamo na voljo:

Deluxe apartma - 3 sobe na voljo po $299/noč
Standardna soba - 8 sob na voljo po $149/noč

Želite, da vam pomagam pri rezervaciji?
Kaj pa jutri?
Za jutri imamo:

Deluxe apartma - 2 sobi po $299/noč
Standardna soba - 5 sob po $149/noč

Primeri uporabe

Viri podatkov v realnem času so popolni za podjetja, ki morajo zagotavljati aktualne informacije:

Hoteli Razpoložljivost sob in cene po datumih
Restavracije Čakalni časi, razpoložljivost miz, delovni čas
E-trgovina Ravni zalog in razpoložljivost izdelkov
Storitve Termini za naročila in razporejanje

Nastavitev

Dodajanje vira podatkov v realnem času zahteva le nekaj korakov:

1
Ustvarite svojo podatkovno končno točko Nastavite URL, ki vrne vaše podatke v živo (API ali spletna stran)
2
Pojdite na Vir podatkov v realnem času V meniju vašega spletnega mesta kliknite "Real-Time Data Feed
3
Vnesite svoj URL Prilepite URL, ki vrne vaše podatke, in kliknite Shrani

Nasvet: Prepričajte se, da je vaša končna točka javno dostopna (brez zahtevane avtentikacije), da lahko klepetalnik pridobi podatke.

Preverjanje povezave

Po shranjevanju URL-ja vira podatkov Asyntai samodejno preveri povezavo. Videli boste kartico stanja, ki prikazuje:

  • Stanje povezave — ali je bil URL uspešno dosežen
  • Format podatkov — zaznana oblika (JSON, HTML/XML ali navadno besedilo)
  • Velikost odziva — koliko podatkov je bilo vrnjenih
  • Predogled vsebine — delček odziva, da lahko potrdite, da gre za prave podatke

Če neposredna povezava ne uspe, bo Asyntai samodejno poskusil z nadomestnim posrednikom za doseg vašega URL-ja. Če obe metodi ne uspeta, je vaš URL še vedno shranjen — videli boste le obvestilo s predlogi za odpravljanje težav.

Podprte oblike zapisa

Vaš URL vira podatkov mora vrniti podatke v enem od naslednjih formatov:

Format JSON

Strukturirani podatki najbolje delujejo za zapletene informacije, kot so zaloge ali urniki.

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

Format navadnega besedila

Preprosto besedilo deluje za enostavne informacije.

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

Dinamične kartice izdelkov

Če vaš vir podatkov v realnem času vsebuje informacije o izdelkih (kot so zaloge, sobe ali storitve), lahko omogočite dinamične kartice izdelkov, da jih prikažete kot lepe vizualne kartice v klepetu.

Kako omogočiti

  1. Pojdite na nastavitve vira podatkov v realnem času
  2. Dodajte URL vašega vira podatkov (oglejte si primer)
  3. Toggle "Enable Dynamic Product Cards" ON
  4. Shranite nastavitve

Format podatkov

Vključite podrobnosti o izdelkih v vaš vir s polji, kot so:

  • name - Ime izdelka/artikla (obvezno)
  • price — Prikazana cena (npr. "$99,99")
  • description — Kratek opis
  • image_url - URL slike izdelka
  • button_link — Povezava za akcijski gumb
  • in_stock — Stanje razpoložljivosti (true/false)

Tukaj je primer, kako naj bi izgledal vaš JSON vir (oglejte si vzorčno datoteko JSON):

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

Nasvet: Dinamične kartice izdelkov odlično delujejo za zaloge e-trgovine, hotelske sobe, artikle za najem ali katerekoli izdelke, ki se pogosto spreminjajo. Za statične izdelke namesto tega uporabite kartice izdelkov.

Primeri iz panoge

Tukaj so podrobni primeri, kako lahko različna podjetja strukturirajo svoje vire podatkov v realnem času:

To so le primeri - vključite lahko katerakoli polja, relevantna za vaše podjetje. Umetna inteligenca bo razumela in uporabila vse podatke, ki jih navedete.
E-trgovina Razpoložljivost izdelkov, cene, URL-ji in promocije
{
  "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"
  }
}
Stranka: "Ali imate brezžične slušalke na zalogi?"
UI: "Da! Brezžične slušalke Pro so na zalogi z 23 razpoložljivimi kosi. Trenutno so v akciji za $119,99 (redno $149,99). Ogledate si jih lahko in jih kupite tukaj: techgadgets.com/products/wireless-headphones-pro. Poleg tega uporabite kodo SAVE20 za dodatnih 20% popusta na naročila nad $100!"
Zdravstvo / Zdravniška ambulanta Razpoložljivost terminov in čakalni časi
{
  "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"
  }
}
Pacient: "Moram obiskati dermatologa ta teden"
UI: "Najzgodnejši termin pri dermatologu je v soboto, 18. januarja, ob 10:00 ali 11:00. Če vam to ne ustreza, je več terminov na voljo v ponedeljek, 20., ob 9:00, 14:00 ali 15:00. Rezervirate lahko na spletu na downtownmedical.com/book."
Fitnes center / Telovadnica Urniki vadb in zmogljivost objekta
{
  "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"
}
Član: "Kakšne tečaje joge imate ta teden?"
UI: "Tukaj so tečaji joge ta teden: sreda ob 19:00 Yoga Flow s Sarah (12 mest), petek ob 7:00 Yoga Flow s Sarah (15 mest) in sobota ob 10:30 Družinska joga s Sarah (10 mest). Rezervirate lahko na fitlifegym.com/classes."
Najem avtomobilov / Avto storitve Razpoložljivost vozil po datumu in lokaciji
{
  "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"}
  ]
}
Stranka: "Potrebujem SUV za ta vikend"
UI: "Imamo SUV-je na voljo v petek (3 na voljo po $89,99/dan) in soboto (1 na voljo po $99,99/dan), vendar je nedelja razprodana. Rezervirajte kmalu! Uporabite kodo WEEKEND15 za 15% popusta. Rezervirajte na quickrent.com/book."
Dogodki / Zabavišča Predstave, vstopnice in urniki
{
  "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}
      ]
    }
  ]
}
Stranka: "Kakšne predstave imate ta vikend?"
UI: "Ta vikend imamo 'The Musical Experience' v petek in soboto ob 19:30 (tudi ob 14:00 matinejska predstava v soboto) - vstopnice so $85. V soboto in nedeljo ob 20:00 je 'Comedy Night Live' za $45. Petkov večer se hitro razprodaja z le 43 preostalimi sedeži! Rezervirajte na grandtheater.com/tickets."
Nepremičnine / Upravljanje nepremičnin Oglasi, cene in urniki ogledov
{
  "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"
}
Stranka: "Kakšna stanovanja imate pod $1500?"
UI: "Imamo enosobno stanovanje na 789 Pine Road za $1.200/mesec, na voljo od 15. februarja. Ima 60 m2, dostop do telovadnice, strešno teraso in vratarja. Dan odprtih vrat je v soboto, 18. januarja, ob 13:00, ali pa se dogovorite za zasebni ogled na premierproperties.com/schedule. Podrobnosti: premierproperties.com/listing/apt-12c"

Omejitve velikosti

Standardni vir podatkov v realnem času podpira vire do 200.000 znakov. Število elementov, ki jih lahko vključite, je odvisno od količine podatkov, ki jih vsak element vsebuje — vir s kratkimi, jedrnatimi vnosi lahko vsebuje ~500 elementov, medtem ko vir z dolgimi opisi morda vsebuje le delček tega. Če vaš vir preseže to omejitev, boste ob poskusu shranjevanja videli obvestilo.

Nasveti za zmanjšanje velikosti vira

Če je vaš vir prevelik, so tu nekateri načini, kako ga zmanjšati pod mejo:

  • Vključite le najbolje prodajane ali priljubljene artikle — Osredotočite se na izdelke, po katerih stranke najpogosteje sprašujejo
  • Odstranite nepotrebna polja — Izpustite interne ID-je, metapodatke ali polja, ki jih klepetalnik ne potrebuje
  • Skrajšajte opise — Uporabite jedrnate opise izdelkov namesto celotnih trženjskih besedil. Oglejte si priporočeno vzorčno strukturo za primer, kako ohraniti vnose kompaktne
  • Filtrirajte po razpoložljivosti — Vključite le artikle, ki so trenutno na zalogi ali aktivni
  • Razdelite po kategorijah — Ustvarite vir za vašo najbolj relevantno kategorijo izdelkov namesto za vse

Nasvet: Če morate povezati večji vir podatkov s tisoči elementi, uporabite Real-Time Data Feed Max (načrt Pro), ki podpira do 10.000.000 znakov (~25.000 elementov).

Najboljše prakse

  • Ohranjajte podatke sveže — Vaša končna točka mora vračati trenutne informacije, ne predpomnjenih podatkov
  • Vključite kontekst — Dodajte datume, čase ali oznake, da UI razume, kaj podatki pomenijo
  • Strukturirajte jasno — Uporabite jasna imena polj v JSON-u, da lahko UI pravilno interpretira podatke
  • Ohranjajte osredotočenost — Vključite le podatke, ki jih klepetalnik potrebuje za odgovarjanje na vprašanja

Pomembno: URL mora biti javno dostopen. Če vaša končna točka zahteva avtentikacijo, klepetalnik ne bo mogel pridobiti podatkov.

Odstrani vir podatkov

Vir podatkov lahko kadar koli odstranite s klikom na gumb "Odstrani vir podatkov" v vaših nastavitvah. Klepetalnik se bo vrnil k uporabi le vaše baze znanja za odgovore.

Opomba: Vir podatkov v realnem času je na voljo pri načrtih Standard in Pro. Morate povezati večje vire podatkov s tisoči elementi? Glejte Real-Time Data Feed Max (načrt Pro).

Preizkusite

Še nimate lastne končne točke API? Funkcijo lahko preizkusite z javnim API-jem in vidite, kako deluje. Na primer, poskusite s ceno Bitcoina v živo iz Binance:

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

To vrne podatke o ceni BTC/USDT v realnem času. Ko bo povezano, bo vaš klepetalnik lahko odgovarjal na vprašanja, kot je "Kakšna je trenutna cena Bitcoina?" z uporabo podatkov v živo.

Nasvet: Uporabite lahko kateri koli javni API, ki vrne JSON ali navadno besedilo — vremenske podatke, cene delnic, menalne tečaje in več. Zamenjajte ga s svojo končno točko, ko boste pripravljeni.