将聊天机器人连接到实时数据源，实现动态回复
实时数据源允许您的聊天机器人访问系统中的实时数据。AI 可以提供最新信息，如当前可用性、价格、等待时间或库存水平，而非静态回复。
只需提供一个返回数据的 URL（JSON 或纯文本），聊天机器人在回答相关问题时会自动包含此信息。
标准实时数据源支持最多 200,000 个字符（约 500 个项目）的数据。对于更大的数据源，请参阅实时数据源 Max，支持最多 10,000,000 个字符（约 25,000 个项目）。
实时数据源非常适合需要提供当前信息的企业：
添加实时数据源只需几个步骤：
提示： 确保您的端点可公开访问（无需身份验证），以便聊天机器人可以获取数据。
保存数据源 URL 后，Asyntai 会自动验证连接。您将看到一个状态卡片，显示：
如果直接连接失败，Asyntai 会自动尝试使用备用代理访问您的 URL。如果两种方法都失败，您的 URL 仍会保存——您只会看到包含故障排除建议的提示。
您的数据源 URL 应以以下格式之一返回数据：
结构化数据最适合库存或日程等复杂信息。
{
"current_date": "2025-01-15",
"rooms": [
{
"type": "Deluxe Suite",
"available": 3,
"price": 299.99
},
{
"type": "Standard Room",
"available": 8,
"price": 149.99
}
]
}
简单文本适用于直观的信息。
Current wait time: 15 minutes Tables available: 3 Kitchen closes at: 10 PM
如果您的实时数据源包含产品信息（如库存、房间或服务），您可以启用动态产品卡片，在聊天中以精美的可视化卡片展示。
在数据源中包含产品详情，字段如下：
name - 产品/项目名称（必填）price - 显示价格（例如"$99.99"）description - 简短描述image_url - 产品图片 URLbutton_link - 操作按钮链接in_stock - 可用状态（true/false）以下是您的 JSON 数据源应有的格式示例（查看示例 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
}
]
}
提示： 动态产品卡片非常适用于电商库存、酒店房间、租赁物品或任何频繁变动的产品。对于静态产品，请改用产品卡片。
以下是不同企业如何构建实时数据源的详细示例：
{
"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"
}
}
{
"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"
}
}
{
"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"
}
{
"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"}
]
}
{
"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}
]
}
]
}
{
"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"
}
标准实时数据源支持最多 200,000 个字符的数据。您可以包含的项目数量取决于每个项目包含的数据量—包含简短精炼条目的数据源可以容纳约 500 个项目，而包含较长描述的数据源可能只能容纳其中的一小部分。如果您的数据超出此限制，保存时会看到通知。
如果您的数据源太大，以下是一些将其缩减到限制范围内的方法：
提示： 如果您需要连接包含数千个项目的更大数据源，请使用实时数据源 Max（Pro 计划），支持最多 10,000,000 个字符（约 25,000 个项目）。
重要提示： URL 必须可公开访问。如果您的端点需要身份验证，聊天机器人将无法获取数据。
您可以随时在设置中点击"移除数据源"按钮来移除数据源。聊天机器人将恢复为仅使用知识库进行回复。
注意： 实时数据源适用于 Standard 和 Pro 计划。需要连接包含数千个项目的更大数据源？请参阅实时数据源 Max（Pro 计划）。
还没有自己的 API 端点？您可以使用公共 API 测试此功能。例如，试试 Binance 的实时比特币价格：
https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT
这将返回实时 BTC/USDT 价格数据。连接后，您的聊天机器人将能够使用实时数据回答"当前比特币价格是多少？"等问题。
提示： 您可以使用任何返回 JSON 或纯文本的公共 API——天气数据、股票价格、汇率等。准备好后替换为您自己的端点。