Bigyan ang model ng LM Studio ng dalawang paraan upang maabot ang web.
Idinagdag ng WebBrain Web Tools ang pagbabasa ng mga pampublikong URL sa kahit anong chat ng LM Studio na sumusuporta sa mga tool. Kapag nakakabit ang WebBrain extension, maaari ring i-delegate ng parehong plugin ang isang goal sa Chromium profile na naka-sign in ka na.
I-install ang webbrain/web-tools mula sa LM Studio Hub. Huwag i-register ang @webbrain/mcp-server o gumamit ng MCP port na 17374 para sa landas na ito; ang delegation ng browser mula sa LM Studio plugin ay gumagamit ng port 17375.
Ano ang maaabot ng modelo
| Landas | Para saan | Mga hindi kayang gawin |
|---|---|---|
fetch_url / research_url | Mga pampublikong artikulo, dokumentasyon, API, JSON, teksto, at static na HTML. | Walang cookies ng browser, JavaScript rendering, pag-click, pag-type, o authenticated na session. |
browser_task | Mga naka-sign in na dashboard, webmail, client-rendered na app, at mga trabahong nangangailangan ng nakikitang interaction ng browser. | Nangangailangan ng WebBrain sa Chromium at koneksyon ng bridge ng plugin. |
Bago mag-install
| Hinihiling | Ano ang titingnan |
|---|---|
| LM Studio | Buksan ang kasalukuyang desktop app. Maaari patakbuhin ng kasamang runtime nito ang mga naka-install na plugin; hindi kailangan ng hiwalay na pag-install ng Node.js para sa karaniwang paggamit. |
| Modelong sumusuporta sa tool | Gumamit ng modelo at configuration ng chat na kayang tumawag ng mga tool. Ang modelong teksto lang na walang paggamit ng tool ay hindi tumatawag ng plugin. |
| Access sa network | Kinokontak ng dalawang HTTP tool ang URL na hinihiling mo mula sa lokal na proseso ng plugin. |
| Opsyonal na koneksyon ng browser | Para sa browser_task, i-install ang WebBrain sa Chrome, Edge, Brave, Opera, o Vivaldi at panatilihing bakante ang port 17375. |
| Aktibong provider ng WebBrain | Ginagamit pa rin ng mga task ng browser ang provider na na-configure sa loob ng WebBrain extension. |
I-install at i-enable ang WebBrain Web Tools
- Panatilihing bukas ang LM Studio. Buksan ang listahan sa Hub ng webbrain/web-tools at piliin ang Run in LM Studio. Maaari mo ring buksan ang deep link sa ibaba sa parehong makina.
- I-enable ang plugin sa chat. Buksan ang kontrol ng integrations o tools tabi ng chat input at i-on ang webbrain/web-tools.
- Pumili ng modelong sumusuporta sa tool. Iniaalok ng plugin ang mga tool nito sa chat na iyon; ang modelo ang nagdedesisyon kung kailan ang mga ito tatawagin batay sa iyong kahilingan.
- Subukan muna ang landas ng pampublikong web. Itanong: "Basahin ang https://news.ycombinator.com at buod ang mga pangunahing tema sa mga kasalukuyang headline." Dapat gamitin ng modelo ang
research_url.
lmstudio://plugin?owner=webbrain&name=web-toolsPag-install ng CLI
Kinokopya ng lms clone ang artifact ng Hub sa kasalukuyang directory; hindi nito awtomatikong ini-install ang kopya na iyon. Pumasok sa na-clone na directory at patakbuhin ang install form ng lms dev:
lms clone webbrain/web-tools
cd web-tools
lms dev --installTingnan ang reference ng lms clone at reference ng lms dev --install ng LM Studio para sa pag-uugali ng CLI.
Mga kakayahan na binibigay ng plugin sa modelo
| Tool | Gamitin para sa | Kailangan ng browser extension? |
|---|---|---|
fetch_url | Kumukuha ng kilalang HTTP(S) URL. Hinahawakan ang JSON, HTML, plain text, request headers at bodies, at binubuod ang mga binary response sa halip na i-inline. | Hindi |
research_url | Kinukuha ang mababasang teksto ng artikulo o dokumentasyon habang binabatid ang mga karaniwang elemento ng nabigasyon. | Hindi |
browser_task | Ini-delegate ang natural-language na Ask o Act goal sa WebBrain sa naka-sign in na browser. | Oo |
browser_status | Sinusuri ang koneksyon ng extension, o nagpo-poll ng umiiral na run sa pamamagitan ng runId. | Oo |
browser_respond | Ipapadala ang sagot ng user sa run na nakapause sa needs_user_input. | Oo |
browser_abort | Hinihintang ang tumatakbong run. Hindi mababawi ang mga natapos nang aksyon. | Oo |
Kapag lumampas ang resulta sa return budget, pinapanatili ng mga HTTP tool ang simula, mga piniling high-signal na gitnang talata, at ang dulo. Ang na-compress na resulta ay nag-uulat ng compacted: true at naglalaman ng metadata ng compression. Humiling ng mas makitid na pahina o taasan ang maxChars kapag mahalaga ang lumaktawang nilalaman.
Gumamit ng mga pampublikong HTTP tool nang walang browser
Magbasa ng kilalang artikulo
Gamitin ang research_url upang basahin ang https://example.com/article at ibigay ang pangunahing argumento ng may-akda, mga suportadong ebidensya, at mga ipinahayag na limitasyon.
Suriin ang isang API response
Gamitin ang fetch_url upang basahin ang https://api.example.com/status. Ibalik ang HTTP status at ang mga field na nagpapakita ng kalusugan ng serbisyo.
Karaniwang mas angkop ang research_url para sa prose. Gamitin ang fetch_url kapag mahalaga ang uri ng response, istruktura ng JSON, headers, method, o body.
Ang mga kahilingang ito ay anonymous at hindi pinapatakbo ang JavaScript ng pahina. Kung ang isang resulta ay nag-uulat ng spaSuspected: true, o nangangailangan ang pahina ng login, huminto sa pag-ulit ng HTTP route at gamitin ang browser_task pagkatapos ikonekta ang extension.
Ikonekta ang browser na ginagamit mo na
- I-install ang WebBrain sa isang Chromium browser. Gumagana ang bridge sa Chrome, Edge, Brave, Opera, at Vivaldi. Hindi kayang tahanan ng Firefox ang koneksyong ito.
- I-enable ang webbrain/web-tools sa LM Studio. Binubuksan ng plugin ang lokal na loopback listener nito kapag na-initialize.
- Buksan ang mga Setting ng WebBrain. Pumunta sa Settings → Bridge.
- Itakda ang URL ng plugin at ang pairing key. Ilagay ang
ws://127.0.0.1:17375/extension, i-paste ang key mula sa~/.webbrain/bridge-key(nilikha kapag nagsimula ang plugin; pinagsasama sa MCP server) sa field ng Pairing key, pagkatapos ay i-enable ang cloud bridge. - Beripikahin ang buong landas. Hilingin sa model ng LM Studio na tumawag ng
browser_status. Ang resulta na connected ay patunay na handa na ang listener ng plugin at ang handshake ng extension.
May isang labas na bridge socket lamang ang extension. Iniekonekta ng port 17375 ito sa plugin na ito, ng port 17374 sa MCP server, at ng port 17373 sa WebBrain Cloud. Ang pagbabago ng URL ay lumilipat ng destinasyon; hindi pinagsasama ang mga ito.
Dinudugtong ng chat model ng LM Studio na tumawag ng browser_task at tinatanggap ang resulta. Isinasagawa ng WebBrain extension ang na-delegate na browser run gamit ang aktibong provider na na-configure sa loob ng WebBrain. Kung dapat manatili sa device ang nilalaman ng pahina, i-configure ang WebBrain provider na iyon upang gumamit din ng lokal na modelo.
Pagbabasa nang hindi binabago ang pahina
Gamitin ang browser_task sa Ask mode upang basahin ang account dashboard na nakabukas na sa browser ko at ilista ang limang pinakabagong alert. Huwag baguhin ang kahit ano.
Interaction sa pamamagitan ng mga permission gate
Gamitin ang browser_task sa Act mode upang buksan ang draft na nakikita na sa browser ko at i-update ang pangalan ng kompanya sa Acme Europe. Huminto bago ang kahit anong final na pagsumite o pagkumpirma.
Hayaan na magpatuloy ang tumatakbong browser run
Naghihintay ang browser_task ng resulta, ngunit hindi kinakansela ng timeout nito ang trabaho na tumatakbo na sa extension. Panatilihin ang ibinigay na runId at gamitin ang recovery tool na tumutugma sa status.
runningMag-poll gamit ang browser_statusneeds_user_inputMagtanong, pagkatapos gamitin ang browser_respondcompletedHanda na ang resultafailedTingnan ang error at ebidensyaabortedHumininto; nanatiling may bisa ang mga naunang aksyon- Huwag magsimula ng inulit na
browser_taskpagkatapos ng timeout; i-poll ang umiiral na run. - Huwag kailanang gumawa ng sagot sa mga tanong ng WebBrain para sa linaw. Itanong sa user at ipasa ang kanilang sagot nang salita-sa-salita.
- Hinihintang ang
browser_abortang mga susunod na hakbang. Hindi nito mababawi ang naipadala nang form, naipadala nang mensahe, o ibang natapos nang aksyon.
Panatilihing malinaw ang dalawang trust surface
- Tumatakbo ang pampublikong HTTP sa lokal na proseso ng plugin. Maaaring magpadala ang
fetch_urlng method, headers, at body, kaya humiling lamang ng mutation kapag sinasadya mo ito. - Default na harang ang mga pribadong network target. Tinanggihan ang loopback, RFC1918, link-local, cloud metadata, at mga karaniwang intranet hostname. Para maabot ang localhost o LAN, i-on ang Allow private network access sa mga setting ng plugin sa LM Studio, lamang sa usaping nangangailangan nito. Hindi maaaring i-on ng modelo ang setting na ito, at nananatiling harang ang mga cloud metadata endpoint kahit na naka-on.
- Muling sinusuri ang mga redirect. Vinevalida ng plugin ang bawat destinasyon at tinatanggal ang mga credential-like na header kapag tumawid ang redirect sa ibang origin.
- Nanatiling naka-loopback ang listener ng browser. Huwag kailanang i-forward o i-proxy ang port
17375. Kinikilala ng handshake ng extension ang client ngunit hindi ito shared-secret authentication; ituring ang lokal na software na pinagkakatiwalaan. - Ang Ask mode ang default. Gamitin ang Act lamang kapag nangangailangan ang hinahiling na resulta ng nakikitang interaction ng browser, at panatilihin ang browser sa paraang kayang mong ihinto ang hindi inaasahang pag-uugali.
- Nakikita ng model ng LM Studio ang mga resulta ng tool. Nagpapadala rin ng task context ang browser run sa pamamagitan ng aktibong provider na na-configure sa loob ng WebBrain. Maingat na piliin ang hangganan ng parehong modelo.
Para sa mga detalye sa antas ng implementation (kasama kung paano inii-pin ang bawat koneksyon sa sinusuri nang address), basahin ang mga Tala ng kaligtasan ng plugin.
Pag-troubleshoot ayon sa sintomas
| Sintomas | Karaniwang ibig sabihin | Pag-aayos |
|---|---|---|
| Hindi lumilitaw ang mga tool | Hindi na-enable ang plugin para sa chat na ito, o ang napiling modelo ay hindi makapagtawag ng mga tool. | I-enable ang webbrain/web-tools tabi ng chat input at pumili ng modelong sumusuporta sa tool. |
Nag-uulat ang browser_status ng disconnected | Available ang plugin, ngunit hindi pa nakakonekta ang WebBrain extension. | Gumamit ng Chromium, i-enable ang cloud bridge, at ilagay nang eksakto ang ws://127.0.0.1:17375/extension. |
| Hindi makapagsimula ang listener o nag-uulat ng address conflict | May ibang instance ng plugin o proseso na sumakop na sa port 17375. | Isarado ang inulit na instance, pagkatapos i-reload ang plugin. Suriin muna gamit ang lsof -nP -iTCP:17375 -sTCP:LISTEN. |
| Walang laman ang pampublikong pahina | Iri-render ang pahina gamit ang JavaScript o itinatago ang nilalaman sa likod ng login. | Kung true ang spaSuspected, ikonekta ang extension at gamitin ang browser_task. |
| Na-timeout ang task ngunit gumagalaw pa rin ang browser | Naubos ang budget ng paghihintay, ngunit hindi kinansela ang run ng WebBrain. | Tumawag ng browser_status gamit ang ibinigay na runId, o browser_abort kung nais mong ihinto ito. |
| Hindi kailanang nakakonekta ang Firefox | Wala ang Firefox ng offscreen-document bridge runtime. | Gumamit ng Chromium browser para sa mga operasyon ng browser tool. Magagamit ang dalawang pampublikong HTTP tool nang walang extension. |
| Nadiskonekta ang MCP o WebBrain Cloud | Pinalitan ng URL ng LM Studio ang iisang destinasyon ng bridge ng extension. | Ibalik ang mga setting sa port 17374 (MCP) o 17373 (WebBrain Cloud) kapag tapos na. |
Configuration ng environment ng bridge
| Variable | Default | Kahulugan |
|---|---|---|
WEBBRAIN_BRIDGE_PORT | 17375 | Ang loopback port na kinokonektahan ng extension. |
WEBBRAIN_BRIDGE_PATH | /extension | Ang path ng WebSocket; dapat tumugma sa URL sa mga setting ng WebBrain. |
WEBBRAIN_COMMAND_TIMEOUT_MS | 30000 | Budget ng timeout para sa isang bridge command at reply. |
Kung binago mo ang port o path para sa plugin na lokal na binubuo, i-update ang URL ng cloud bridge sa mga setting ng WebBrain upang tumugma. Panatilihin ng karamihan sa mga user ang mga default.
