Arayüz
Bilgi Tabanı API’si
Hareket bilgi tabanı için planlanan sorgu yüzeyi: pencereler, gömmeler ve kanıt — analistler, araçlar ve yapay zeka ajanları için tasarlandı.
Pencereler, gömmeler, kanıt
Bilgi tabanı üç isim etrafında örgütlenir. Pencere, tek bir vücudun birkaç saniyelik hareketidir — poz dizisi artı üstveri. Her pencere bir gömme taşır: hareket uzayındaki koordinatı. Ve türetilmiş her ifade kanıta geri bağlanır: onu gerekçelendiren ham kesitlere. API’nin etrafında tasarlandığı kural basittir — geldiği harekete işaret etmeyen yanıt yoktur.
Planlanan uç noktalar
| Uç nokta | Amaç |
|---|---|
| POST /v1/embed | Bir poz dizisini 384 boyutlu gömmesine çevirir. |
| POST /v1/query | Bilgi tabanında arama — benzerlik, filtre veya özniteliklerle — her sonuçta kanıtla. |
| GET /v1/features | Bir derlemin sunduğu türetilmiş hareket özniteliklerini listeler. |
Örnek: sorgu ve yanıt
Temsili bir alışveriş — biçimler ve adlar örnekleyicidir; ilk entegrasyon ortaklarıyla kesinleşecektir.
POST /v1/query
{
"similar_to": "win_02af31",
"filter": {
"athlete_id": "ath_114",
"date_range": ["2026-03-01", "2026-03-28"]
},
"features": ["speed_profile", "knee_asymmetry"],
"limit": 2
}
HTTP/1.1 200 OK
{
"model_version": "hmt-poc-0.9",
"schema_version": "2026-06",
"results": [
{
"window_id": "win_7c11e4",
"similarity": 0.93,
"features": { "speed_profile": 7.2, "knee_asymmetry": 0.14 },
"evidence": { "session_id": "ses_209", "t_start": 3121.4, "t_end": 3125.4 }
},
{
"window_id": "win_1d98b0",
"similarity": 0.91,
"features": { "speed_profile": 6.8, "knee_asymmetry": 0.17 },
"evidence": { "session_id": "ses_214", "t_start": 812.0, "t_end": 816.0 }
}
]
}Sürümleme, güven ve ajanlar
Her yanıt, kendisini üreten model_version ve schema_version değerlerini bildirir; çünkü farklı model sürümlerinin gömmeleri karşılaştırılamaz ve hiçbir tüketici bunu kazayla keşfetmemelidir.
Aynı sorgu yüzeyinin üzerine bir MCP sunucusu planlanıyor: yapay zeka ajanları — Claude, ChatGPT, özel sistemler — hareket sorularını doğrudan sorabilsin ve aldıkları kanıtı kaynak gösterebilsin. Bunun bir antrenörün, fizyoterapistin veya analistin yapabildiklerini nasıl değiştirdiği yapay zeka ajan platformu sayfasında anlatılıyor.