مستندات
پشتیبانی/عامل‌ها

عامل‌ها

عامل‌های هوش مصنوعی (WebMCP)

با WebMCP بگذارید یک عامل هوش مصنوعی در مرورگر شما، در حالی که تماشا می‌کنید، سکانس را بخواند و ویرایش کند.

در این صفحه

WebMCP چیست

WebMCP یک استاندارد وب پیشنهادی است که به یک صفحه اجازه می‌دهد ابزارهایی را به یک عامل هوش مصنوعی که در مرورگر اجرا می‌شود عرضه کند. هر ابزار یک نام، یک توضیح، و توضیحی دربارهٔ ورودی‌ای که می‌گیرد دارد. عامل ابزارهای صفحه را پیدا می‌کند و فرامی‌خواند، تقریباً همان‌طور که ابزارها را روی Model Context Protocol فرامی‌خواند، جز اینکه ابزارها درون خود صفحه اجرا می‌شوند.

یعنی عامل روی چیزی کار می‌کند که شما می‌بینید: پچ باز شما، در نشست خودتان، بدون حساب، سرور یا بارگذاری. هر چه تغییر دهد همان‌طور که اعمال می‌شود در PUNCHER ظاهر می‌شود.

WebMCP پیش‌نویسی از گروه جامعهٔ یادگیری ماشین وب W3C است. API هنوز تغییر می‌کند و هنوز هیچ مرورگری آن را برای همهٔ سایت‌ها روشن نمی‌کند.

یک عامل چه کارهایی می‌تواند بکند

PUNCHER نوزده ابزار عرضه می‌کند. با آن‌ها یک عامل می‌تواند کل سکانس را بخواند و تقریباً هر چیزی را که شما دستی می‌توانید تغییر دهید، تغییر دهد.

ابزارکارش
get_sequenceهمه‌چیز را می‌خواند: تنظیمات، وویس‌ها و پترن‌ها، هر استپی که چیزی دارد، مدولاسیون‌ها، ترنسپورت و انتخاب
set_stepsنت‌ها، ترانسپوز، سکوت‌ها و رد کردن‌ها، پرش‌ها و انولوپ‌های CC، روی هر تعداد استپ
set_voicesتنظیمات یک وویس، پترنش، و گزینه‌های نقطه‌هایش
list_rhythm_presetsریتم‌های نام‌دار پنل پریست‌های وویس را فهرست می‌کند، هر کدام با گروه، سرعت و نقطه‌هایش
apply_rhythm_presetیک ریتم نام‌دار را روی یک وویس می‌گذارد، همان‌طور که انتخابش در پنل پریست‌ها می‌کند
set_euclideanتعدادی ضربه را تا حد امکان یکنواخت روی یک پترن پخش می‌کند، سپس می‌چرخاندش، همان‌طور که ضربه‌ها، طول و چرخش پنل می‌کنند
transform_patternکاری که نوار ویرایش پنل می‌کند: معکوس، وارونه، آینه، دو برابر، نصف، تصادفی، پاک کردن یا پر کردن
set_sequencerتمپو، اندازه، سرعت، جهت، لوپ، گام و بقیهٔ تنظیمات سکوئنسر
set_modulationsیک تنظیم را به یک CC وصل می‌کند، همان‌طور که چرخ‌دنده‌اش می‌کند، تا انولوپ‌های استپ آن را مدوله کنند
step_menuآنچه راست‌کلیک روی یک استپ عرضه می‌کند: کپی، جای‌گذاری، درج قبل یا بعد، پاک کردن، حذف
play، pause، stopترنسپورت
set_recordingدکمهٔ ضبط، و استپی که ضبط در آن می‌رود
set_actionsنگه‌داشت، همگام، قرینه و ترانسپوز
select_stepکاری که کلیک روی یک استپ می‌کند: نشانش می‌دهد، می‌نوازدش یا بعدی پخشش می‌کند
undo، redoویرایش ← واگرد و ازنو
clear_sequenceاستپ‌ها را خالی و وویس‌ها را بازنشانی می‌کند

استپ‌ها، وویس‌ها و نقطه‌ها از 1 شماره‌گذاری می‌شوند، همان‌طور که PUNCHER نشان می‌دهد. نت‌ها نام دارند، با C4 به‌عنوان دوی میانی. وقتی نقطه‌های یک وویس یک پریست یا ریتم اقلیدسی باشند، ابزارها کنار آن‌ها می‌گویند کدام، همان‌طور که پنل پریست‌ها می‌گوید.

آنچه از آنِ شما می‌ماند

عامل نمی‌تواند فایلی را ذخیره، باز یا صادر کند، چون آن‌ها به کلیک شما در پنجرهٔ فایل نیاز دارند. نمی‌تواند تنظیمات را تغییر دهد: خروجی‌ها و ورودی‌های MIDI، تم‌ها و SoundFontها. می‌تواند ضبط را شروع کند، ولی فقط شما می‌توانید در آن بنوازید.

مرورگرها همچنین صدا را فقط پس از کلیک یا فشردن کلیدی روی صفحه شروع می‌کنند، و فراخوانی یک عامل به حساب نمی‌آید. اگر سینت داخلی بی‌صداست، یک بار در هر جای PUNCHER کلیک کنید. play و get_sequence به عامل می‌گویند چه وقت چیزی شنیده نمی‌شود.

واگرد و ایمنی

  • هر درخواست یک مرحلهٔ واگرد است. هر قدر یک فراخوانی تغییر دهد، ویرایش ← واگرد (Ctrl + Z) آن را یکجا برمی‌گرداند. فراخوانی‌ای که چیزی را تغییر نمی‌دهد ورودی‌ای باقی نمی‌گذارد.
  • همه یا هیچ. اگر بخشی از یک درخواست انجام‌شدنی نباشد، هیچ چیز تغییر نمی‌کند و به عامل گفته می‌شود چه چیزی را اصلاح کند.
  • فرود آمدنش را می‌بینید. نخستین استپ یا وویسی که عامل ویرایش می‌کند انتخاب می‌شود، پس تغییر در دید است.
  • پچ در مرورگر شما می‌ماند. ابزارها روی پچ بازِ صفحه عمل می‌کنند. عامل فقط آنچه را فراخوانی‌هایش برمی‌گردانند، بیشتر از طریق get_sequence، می‌بیند، و آمار استفادهٔ PUNCHER فقط ثبت می‌کند کدام ابزار فراخوانی شد. نام پچ و فایل می‌تواند از هر فایلی که باز کرده‌اید بیاید، پس به عامل گفته می‌شود آن را محتوایی نامعتبر بداند.

روشن کردنش

در punchermidi.app، از Chrome 149 یا بعد استفاده کنید. PUNCHER در آزمایش مبدأ WebMCP کروم شرکت می‌کند، که API را برای این سایت روشن می‌کند و چیزی برای تنظیم شما نمی‌گذارد. آزمایش تا مارس 2027 ادامه دارد.

اجرای PUNCHER روی رایانهٔ خودتان، یا روی نشانی دیگر، به‌جای آن به پرچم آزمایشی کروم نیاز دارد:

  1. chrome://flags/#enable-webmcp-testing را باز کنید.
  2. WebMCP for testing را روی Enabled بگذارید و کروم را دوباره اجرا کنید.

پشتیبانی مرورگرها در حال تغییر است: Microsoft Edge هم دورهٔ آزمایشی WebMCP دارد. این دستورها برای Chrome هستند. PUNCHER فقط وقتی API مربوط به WebMCP در صفحه فعال باشد ابزارها را ارائه می‌کند؛ نام مرورگر به‌تنهایی کافی نیست. بدون API هم سکوئنسر عادی کار می‌کند.

امتحانش کنید

سریع‌ترین راه برای دیدن ابزارها افزونهٔ Model Context Tool Inspector کروم است:

  1. آن را از Chrome Web Store نصب کنید.
  2. ویرایشگر را باز کنید، سپس روی نماد افزونه کلیک کنید تا پنل کناری‌اش باز شود. ابزارهای PUNCHER را با ورودی هر کدام فهرست می‌کند.
  3. get_sequence را انتخاب کنید، {} را وارد کنید و اجرا کنید. پچ فعلی برمی‌گردد.
  4. set_sequencer را انتخاب کنید و { "tempo": 96, "scale": "A minor" } را اجرا کنید. تنظیمات سکوئنسر بالای شبکه بی‌درنگ دنبال می‌کنند، و ویرایش ← واگرد آن را برمی‌گرداند.

سپس از یک عامل چیزی موسیقایی بخواهید، مثل «یک لوپ چهارآکوردی در A minor بساز، با بیس روی وویس 1 و یک آرپژ روی وویس 2، سپس پخشش کن.» یک عامل خوب نخست سکانس را می‌خواند، سپس چند فراخوانی انجام می‌دهد و نتیجه را پخش می‌کند.

اگر ابزاری ظاهر نشد

  • بررسی کنید که در Google Chrome 149 یا بعد هستید، نه مرورگر دیگر.
  • ویرایشگر را با Ctrl + Shift + R دوباره بارگذاری کنید.
  • در DevTools، Application ← Frames ← top را باز کنید. زیر Origin Trials، کروم نشان می‌دهد توکن PUNCHER را برای WebMCP پذیرفته یا نه، و اگر نپذیرفته چرا.
  • بیرون از punchermidi.app، از جمله روی رایانهٔ خودتان، پرچمی را که در روشن کردنش شرح داده شد روشن کنید.

بیشتر بدانید

PUNCHER / پشتیبانی و مستندات