Muse4AI yordamida AI agentlarini Muse’ga ulang

Muse4AI nima?

Muse4AI — AI agentlariga tizimga kirilgan Muse sessiyangizni boshqarish imkonini beruvchi Windows uchun mahalliy ilova. U ChatGPT, Claude, Cursor, Codex, n8n va maxsus skriptlar kabi vositalarni REST, MCP yoki OAuth orqali Muse’ga ulaydi.

Ilova shaxsiy kompyuteringizda ishlaydi va mahalliy API’sini http://127.0.0.1:47821 manzilida taqdim etadi. So‘rovlar Muse4AI bulut xizmati orqali yo‘naltirilmaydi. Natijalaringiz, API kalitlaringiz, OAuth tokenlaringiz, tarixingiz va mahalliy kutubxonangiz %APPDATA%\MuseStudio ichida saqlanadi.

Asosiy imkoniyatlar

• Rasm va video yaratish: Matnli promptlarni yuboring, ixtiyoriy ravishda namunaviy fotosuratlarni qo‘shing, hisobni tanlang va navbatdagi ish jarayonini kuzating.
• Suhbatlarni davom ettirish: Chat topshiriqlari suhbat identifikatorini qaytaradi, shuning uchun agent kontekstni saqlashi, g‘oyani takomillashtirishi va fayllarni biriktirishi mumkin.
• Tayyor videolarni uzaytirish: Yaratilgan klipni olti qadamgacha, har bir zanjirda taxminan 60 soniyagacha davom ettiring.
• Videoni tabiiy til yordamida tahrirlash: MP4 faylni biriktiring va an’anaviy tahrirlash vaqt jadvalini sozlamasdan kerakli o‘zgarishlarni tasvirlang.
• REST yoki MCP’dan foydalanish: Agent dasturlarini MCP vositalari orqali ulang yoki mahalliy REST API’ni bevosita chaqiring.
• Xavfsiz avtorizatsiya: Cheklangan vakolatli API kalitidan foydalaning yoki olti xonali tasdiqlash kodi bilan OAuth jarayonini yakunlang.
• Ishlarni mahalliy boshqarish: Ish stoli ilovasida navbatdagi topshiriqlar, oldindan ko‘rishlar, yaratilgan materiallar, ulanish sozlamalari va qidiriladigan tarixni ko‘rib chiqing.

Talablar va muhim cheklovlar

Paketlangan ilova Windows 10 yoki Windows 11 uchun mo‘ljallangan. Loyihani manba kodidan ishga tushirsangiz, Node.js 22 yoki undan yangiroq versiyasi ham kerak bo‘ladi.

Muse4AI norasmiy, mustaqil loyiha bo‘lib, Meta Platforms, Inc. bilan bog‘liq emas, u tomonidan ma’qullanmagan va homiylik qilinmaydi. U shaxsiy Muse sessiyangizni avtomatlashtiradi, shuning uchun undan foydalanishdan oldin tegishli xizmat ko‘rsatish shartlarini ko‘rib chiqing. Muse’dagi o‘zgarishlar avtomatlashtirishga ham ta’sir qilishi mumkin.

macOS va Linux uchun paketlangan versiyalar hozircha sinovdan o‘tkazilmagan va taqdim etilmaydi. Muse4AI’da bulut hisobi, telemetriya serveri yoki obuna mavjud emas.

Windows’da Muse4AI’ni o‘rnatish

1-variant: O‘rnatuvchidan foydalanish

1. Muse4AI yuklab olish sahifasini oching.
2. Windows o‘rnatuvchisini yuklab oling va ishga tushiring.
3. Agar Windows ilova imzolanmaganligi haqida ogohlantirsa, More infoni, keyin esa Run anywayni tanlang.
4. Muse4AI’ni oching va Accounts bo‘limiga o‘ting.
5. Muse hisobingizni qo‘shing va undagi sessiyaga kirilganiga ishonch hosil qiling.

2-variant: Manba kodidan ishga tushirish

Reponi klonlang yoki yuklab oling, uning ildiz katalogida terminalni oching va quyidagilarni ishga tushiring:

cd desktop
npm install
npm run build
npm start

Ishga tushgandan so‘ng ish stoli interfeysi ochiladi va mahalliy API http://127.0.0.1:47821 manzilida mavjud bo‘ladi.

AI agentini MCP va OAuth orqali ulash

MCP mos agent mijozlari uchun eng bevosita variantdir. Muse4AI’da Settings → API & agent bo‘limini oching. Ilova tayyor ulanish parchasini taqdim etadi. Asosiy MCP konfiguratsiyasi mijozni mahalliy endpoint’ga yo‘naltiradi:

{
  "mcpServers": {
    "muse4ai": {
      "url": "http://127.0.0.1:47821/mcp"
    }
  }
}

Ushbu konfiguratsiyani agentingiz foydalanadigan MCP mijoziga qo‘shing. OAuth avtorizatsiyasi vaqtida Muse4AI olti xonali kodni ko‘rsatadi. Ulanishni ma’qullash va token olish uchun bu kodni rozilik sahifasiga kiriting.

OAuth serveri avtorizatsiya metama’lumotlarini e’lon qiladi, mijozlarni dinamik ro‘yxatdan o‘tkazishni qo‘llab-quvvatlaydi va o‘z tokenlarini imzolaydi. Mahalliy MCP URL manzilini bilish kirishni ma’qullash uchun yetarli emas, chunki foydalanuvchi ish stoli ilovasida ko‘rsatilgan kodni ham taqdim etishi kerak.

Keyinchalik kirishni olib tashlash uchun Settings → API & agent → Connected apps bo‘limini oching va tegishli ilovani bekor qiling.

REST API orqali ulanish

HTTP’dan bevosita foydalanadigan skriptlar va xizmatlar uchun Settings → API & agent bo‘limidan API kaliti yarating. Muse4AI kalitlari msk_ bilan boshlanadi. Kalitni Authorization sarlavhasida bearer token sifatida yuboring.

Video yaratish topshirig‘ini yuborish

Quyidagi so‘rov matnli prompt bilan video topshirig‘ini yaratadi:

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

msk_YOUR_KEY o‘rniga ish stoli ilovasida yaratilgan kalitni kiriting. Yuborilgan topshiriq ilova ichidagi navbatda ko‘rinadi; u yerda uning holatini kuzatishingiz va natijani tekshirishingiz mumkin.

Mavjud REST amallari va MCP vositalari

• POST /v1/jobs tasvir yoki video vazifalarini yaratadi. Unga mos MCP vositasi muse_generate.
• POST /v1/jobs kind: "chat" bilan chat vazifasini yaratadi. Unga mos MCP vositasi muse_chat.
• GET /v1/jobs REST orqali vazifalar ro‘yxatini ko‘rsatadi. MCP mijozlari muse_list_jobs dan foydalanishi mumkin.
• GET /v1/jobs/{id} muayyan vazifani oladi. MCP dagi muqobili muse_get_job.
• POST /v1/jobs/{id}/cancel vazifani bekor qiladi. MCP vositasi muse_cancel_job.
• POST /v1/assets/{id}/extend va POST /v1/conversations/{id}/extend videoni davom ettirishni qo‘llab-quvvatlaydi. Tegishli MCP vositalari: muse_extend_video va muse_get_extend.
• GET /v1/status va GET /v1/health xizmat haqidagi ma’lumotlarni taqdim etadi. MCP mijozlari muse_status dan foydalanishi mumkin.

Mashina o‘qiy oladigan to‘liq API shartnomasi ishlayotgan ilovada GET /v1/openapi.json manzili orqali mavjud. Markdown hujjatlari bilan ishlash qulayroq bo‘lgan agentlar llms.txt faylini o‘qishi mumkin.

Agentlar uchun asosiy ish jarayonlari

Tasvir yoki video yaratish

1. Muse4AI ishlayotganini va Muse hisobingiz Accounts bo‘limida mavjudligini tasdiqlang.
2. Ulangan agentdan tasvir yoki video yaratishni so‘rang va aniq prompt taqdim eting.
3. Zarur bo‘lsa, ma’lumotnoma fotosuratlarini qo‘shing va qaysi sozlangan hisobdan foydalanish kerakligini ko‘rsating.
4. Vazifani kuzatish, uning holatini ko‘rish va natijani oldindan ko‘rish uchun navbatni oching.
5. Tugallangan ishlarni mahalliy kutubxonadan toping.

Chatni davom ettirish

muse_chat dan foydalaning yoki kind: "chat" bilan REST vazifasini yarating. Agent alohida suhbat boshlamasdan ayni mavzuni davom ettirishi uchun qaytarilgan suhbat ID sini saqlab qo‘ying.

Tugallangan klipni davom ettirish

Video tugagach, asset yoki suhbatni davom ettirish endpointidan foydalaning yoki MCP agentidan muse_extend_video ni chaqirishni so‘rang. Davomlar original klip yaratilgan suhbatda qoladi. Zanjir ko‘pi bilan olti davom ettirish bosqichini o‘z ichiga olishi va taxminan 60 soniyaga yetishi mumkin.

Mavjud videoni tahrirlash

MP4 faylni biriktiring va kerakli o‘zgarishni oddiy tilda tasvirlang. Muse4AI vaqt jadvali yoki render sozlamalarini talab qilmasdan so‘rovni Muse sessiyangiz orqali uzatadi.

Kengaytirilgan maslahatlar

To‘g‘ri avtorizatsiya usulidan foydalaning

MCP mijozingiz interaktiv avtorizatsiyani qo‘llab-quvvatlasa va kalitni nusxalashni istamasangiz, OAuth ni tanlang. Buyruq satri vositalari, mahalliy avtomatlashtirish va bearer tokenlarini yuboradigan tizimlar uchun API kalitini tanlang. API kalitlari doirasi cheklangan, so‘rovlar tezligi cheklangan va har biri alohida bekor qilinishi mumkin.

Mahalliy hisob ma’lumotlarini himoyalang

msk_ kalitini manba kodini boshqarish tizimida, skrinshotlarda, umumiy promptlarda yoki shell tarixida e’lon qilmang. Imkon bo‘lsa, turli mijozlar uchun alohida kalitlar yarating, shunda kirish endi kerak bo‘lmasa, faqat ta’sirlangan kalitni bekor qilishingiz mumkin.

Suhbat ID larini saqlang

Integratsiya yaratishda chat va generatsiya jarayonlari qaytargan suhbat ID sini saqlang. Uni qayta ishlatish agentga mavzuni davom ettirish, fayllarni kontekstga biriktirish va videoni original suhbatida davom ettirish imkonini beradi.

API shartnomasini tekshiring

So‘rov va javob maydonlarini taxmin qilish o‘rniga, ishlayotgan ilovadan http://127.0.0.1:47821/v1/openapi.json manzilini o‘qing. Bu, ayniqsa, tiplashtirilgan mijoz yaratishda yoki avtomatlashtirish platformasini sozlashda foydalidir.

Ish yuborishdan oldin holatni kuzating

Uzoqroq ish jarayonini boshlashdan oldin mahalliy xizmatni tekshirish uchun GET /v1/status, GET /v1/health yoki MCP ning muse_status vositasidan foydalaning. Vazifalarni kuzatish uchun ro‘yxat va olish amallaridan foydalaning, endi kerak bo‘lmagan ishlarni esa bekor qiling.

Loyihani ishlab chiqish va sinash

Repozitariy desktop ilovasi, umumiy kontent va agent ko‘rsatmalarini alohida saqlaydi:

• desktop/ asosiy jarayon, renderer, REST, MCP va OAuth API lari, testlar hamda installer kodini o‘z ichiga oladi.
• content/ ilova va veb-sayt baham ko‘radigan qo‘llanma, agent va foydalanish holatlariga oid matnlarni o‘z ichiga oladi.
• agent-kit/ agentlar vositadan qanday foydalanishni o‘rganish uchun o‘qishi mumkin bo‘lgan Muse4AI Skill ni o‘z ichiga oladi.

desktop katalogidan loyiha tekshiruvlari va Windows paketlash buyrug‘ini ishga tushiring:

cd desktop
npm test
npm run typecheck
npm run package:win

Test buyrug‘i repositoriyning testlar to‘plamini ishga tushiradi, npm run typecheck qat’iy TypeScript tekshiruvini bajaradi, npm run package:win esa Windows ZIP fayli va installer uchun kerakli fayllarni tayyorlaydi.

Xulosa

Muse4AI REST, MCP yoki OAuth ni tushunadigan AI agentlari va Muse o‘rtasida mahalliy ko‘prikni taqdim etadi. Windows ilovasi ishga tushib, Muse hisobingiz ulangach, siz media yaratishingiz, suhbatlarni davom ettirishingiz, videolarni uzaytirishingiz, MP4 fayllarni tabiiy tildagi so‘rovlar orqali tahrirlashingiz va natijalarni Muse4AI bulut vositachisisiz boshqarishingiz mumkin.

Qo‘shimcha skrinshotlar va ko‘rsatmalar uchun rasmiy qo‘llanmaga tashrif buyuring. Muse4AI MIT litsenziyasi ostida mavjud.