Десктоп клиент және CLI
Десктоп клиенті өз үстеліңіздегі қолмен датасет жазу үшін арналған: ол жабдықты анықтайды, таза эпизод түсіруге бағыттайды және сіз жүктеп салуға шешім қабылдағанша барлық нәрсені жергілікті сақтайды. CLI онымен бірге келеді және MCP сервері ретінде де қызмет етеді.
Соңғы жаңарту 2026-08-09
Десктоп қосымшасы не істейді
Браузер кокпиті платформадағы роботтарды қашықтан басқаруға арналған. Десктоп клиенті жұмыс ағынының басқа жартысын қамтиды: сіз, үстеліңіздегі робот қолы және өзіңіз жазғыңыз келетін датасет. Ол USB арқылы қолмен байланысады, қосылған камераларды анықтайды және эпизод бойынша эпизод жазуға бағыттайды.
Анықтау автоматты түрде жүреді. SO-100 қосыңыз, қосымша тізбекті портты тауып, сервоприводтарды санайды; байланысқан веб-камералар алдын ала қарауда пайда болады, сондықтан жазбас бұрын кадрлеуді тексере аласыз. Жазатын баптау файлы жоқ, іздеп табуды қажет ететін драйвер жоқ.
Жазғаныңыздың бәрі алдымен жергілікті дискіге жазылады. Сіз нақты түрде жүктеп салмайынша ешнәрсе компьютеріңізден кетпейді, бұл эпизодтарыңызда әлі бөліскіңіз келмейтін нәрселер болса немесе сенімді байланысы жоқ жерде жазып жатсаңыз маңызды.
Жүктеп алу және орнату
Қосымша macOS, Windows және Linux үшін /download бетінде қолжетімді. Орнатыңыз, платформа есептік жазбаңызбен кіріңіз, қолды қосыңыз. Сонымен бір мезгілде роботты платформамен жұптап жатсаңыз, шебердің жұптау кодын енгізетін жері де осы қосымша.
Бағыттаушы жазу ағыны
Жақсы имитациялық оқыту деректерін жазу негізінен тәртіпке байланысты, ал қосымша сол тәртіпті сіздің орныңызға орындайды. Әр эпизод бірдей бес кезеңнен өтеді.
- 1Тапсырманы сипаттау
Бір нақты сөйлем, бірдей тапсырма үшін әрдайым бірдей түрде айтылған. Тілге бейімделген полисилер осы жолға назар аударады, сондықтан "қызыл текшені алып, оны тостаған ішіне қой" деген сөйлем "тест 4"-тен жақсырақ нәтиже береді.
- 2Сахнаны қалпына келтіру
Қолды бастапқы позицияға жылжытып, заттарды орналастырыңыз. Камера алдын ала қарауы жазуды бастамас бұрын кадрлеуді растау үшін, кейін емес, сол жерде тұрады.
- 3Жазу
Қолды тапсырма бойынша нақты, тегіс қозғалыстармен қашықтан басқарыңыз. Тапсырма аяқталған бойда тоқтаңыз, кадрда бос тұрмаңыз.
- 4Қарау
Сақтаудың алдында эпизодты қайта ойнатыңыз. Нашар эпизодты тастау бірнеше секунд алады; оны оқытуға пайдалану сағаттар алады.
- 5Жүктеп салу
Қанағаттанғаннан кейін топтаманы жүктеп салыңыз. Эпизодтар қашықтан сессиялардан жазылған кез келген нәрсемен бірге платформадағы датасет браузеріңізде пайда болады.
Жергілікті деректер және LeRobot экспорты
Эпизодтар LeRobot форматында сақталады және экспортталады, бұл ашық көзді робот оқыту экожүйесінің көбі қабылдайтын алмасу форматы. Десктоп клиентімен жазылған датасет тікелей ACT, Diffusion Policy, SmolVLA немесе GR00T дәл баптауын оқытуға кете алады.
GR00T дәл баптауды жоспарласаңыз, датасетіңізді LeRobot v2.1 форматында экспорттаңыз. GR00T басқа датасет нұсқаларын қабылдамайды, ұзақ жазба сессиясынан кейін мұны білу қуанышты болмайды.
CLI
CLI десктоп қосымшасынсыз-ақ дербес орнатылады, бұл оны басы жоқ (headless) компьютерлер мен скрипттер үшін дұрыс таңдау етеді. macOS пен Linux жүйесінде:
curl -fsSL https://www.ay-robots.com/install.sh | shWindows жүйесінде, PowerShell-де:
irm https://www.ay-robots.com/install.ps1 | iexCLI API кілтімен аутентификация жасайды. /dashboard/settings бетінде бірін жасаңыз; кілттерде ayr_live_ префиксі болады және оларды құпия сөз ретінде қарастыру керек, сондықтан оларды тапсырған скрипттеріңізде емес, қабық ортасында немесе құпия менеджерде сақтаңыз.
MCP: жергілікті және хостталған
MCP-үйлесімді көмекшімен немесе редактормен жұмыс істесеңіз, платформаға Model Context Protocol арқылы екі жолмен қол жеткізуге болады. Жергілікті сервер компьютеріңізде жұмыс істейді және бір командамен іске қосылады:
ay-robots mcpХостталған сервер https://www.ay-robots.com/api/mcp мекенжайында орналасқан және Streamable HTTP хаттамасын қолданады. Оған жергілікті орнату қажет емес: MCP клиентіңізді осы URL мекенжайына бағыттап, есептік жазба деректеріңізбен жұмыс істеу үшін /dashboard/settings бетінен ayr_live_ API кілтімен аутентификация жасаңыз.
| Жергілікті MCP сервер | Хостталған MCP сервер | |
|---|---|---|
| Қалай іске қосу | CLI орнатқаннан кейін ay-robots mcp | Ешнәрсе іске қосудың қажеті жоқ, https://www.ay-robots.com/api/mcp мекенжайына қосылыңыз |
| Транспорт | MCP клиентіңіз іске қосатын жергілікті процесс | Streamable HTTP |
| Аутентификация | CLI тіркелгі деректеріңіз | ayr_live_ префиксі бар API кілті |
| Не үшін жарайды | Жергілікті компьютер мен жабдыққа қатысты жұмыс ағындары | Кез келген жерден есептік жазба деректері, орнатудың қажеті жоқ |
Жиі қойылатын сұрақтар
Жазу интернетсіз жұмыс істей ме?▾
Иә. Жазу толығымен жергілікті. Бастапқы кіру мен жұптау үшін, содан кейін тағы да жүктеп салғанда байланыс қажет, бірақ эпизодтарды түсіру кезінде қажет емес.
Десктоп клиенті қандай қолдарды анықтайды?▾
SO-100 (SO-ARM100) негізгі қол болып табылады және қосымша баптаусыз-ақ жұмыс істейді. Платформада қолдау көрсетілетін түрлердің толық тізімі үшін роботтар бетін қараңыз.
API кілтін қайдан алуға болады?▾
/dashboard/settings бетінен. Кілттер ayr_live_ бастауымен басталады және есептік жазбаңызға қол жеткізу береді, сондықтан оларды құпия сөз ретінде сақтаңыз, ашылып қалуы мүмкін кез келген кілтті жойыңыз.
Ешнәрсе орнатпай хостталған MCP серверін пайдалана аламын ба?▾
Иә. Ол https://www.ay-robots.com/api/mcp мекенжайында Streamable HTTP хаттамасын қолданады; сізге тек MCP клиенті мен API кілті қажет. Жергілікті сервер тек жұмыс ағыны жергілікті компьютеріңізге қатысты болғанда ғана қажет.
AY-Robots қашықтан басқару жазбаларын LeRobot форматында қалай сақтайды: эпизод құрылымы, бақылау тақтасының эпизод браузері, жүктеулерді біріктіру және нарық.
AY-Robots есептік жазбасын жасаңыз, client немесе operator рөлін таңдаңыз, алғашқы ортаңызды баптаңыз, жұптау коды арқылы роботты қосыңыз және алғашқы сессияны жүргізіңіз.