Vaš AI agent zdaj nadzoruje katero koli spletno stran.
S polno revizijo.
Vstopite eno vrstico v.CLAUDE.md, AGENTS.md, or .cursorrulesin vaša AI pridobiva pravo avtomatizacijo brskalnika: Gmail, Slack, LinkedIn, GitHub in katerokoli spletno mesto. Vsak klik je podpisan, zapečatljen in preverljiv. Serwer MCP je živ.
Dodatno tolažbo vsakemu projektu v enem zapovedi
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Dodatke za avtomatizacijo brskalnika Solace do vašega Kod Claude projekta.
Step 0: Download & Install Solace Browser
Solace Browser is a desktop app that runs on your machine. Download it first, then your AI agent can control it via localhost:8888.
Download Solace Browser
Visit solaceagi.com/download and download the version for your operating system.
# Linux (one-line install): curl -sf https://storage.googleapis.com/solace-downloads/install.sh | bash # macOS / Windows: download the installer from # https://www.solaceagi.com/download
The download includes Solace Hub (desktop app) + Solace Runtime (local API on port 8888) + Solace Browser (Chromium fork with Yinyang sidebar).
Launch Solace Hub
# Start the Hub — it launches everything automatically ~/.solace/bin/solace-hub
The Hub sits in your system tray. It starts the local API server on port 8888 and opens the browser when ready.
Verify it's running
curl http://localhost:8888/api/v1/system/status
→ {"app_count": 22, "cloud_connected": false, "evidence_count": 0, "uptime_seconds": 5}
If you see JSON, your agent is ready to use Solace. No account needed. Free forever for local use.
Vsak glavni AI kodiralski agent, podprt
Prenesite pravo obliko za svojega AI pomočnika.Vsaka datoteka AI natančno pove, kako uporabljati Solace navigacijo, klik, napolnitev, zaslon in snemanje dokazov.21 oblik je podprt iz škatle.
Kod Claude
Vdrži se v svojoCLAUDE.mdKod Claude bo za vsako spletno avtomatizacijo samodejno uporabil Solace Browser.
Codex de OpenAI
Vdrži se v svojoAGENTS.mdAgenci Codex de OpenAI in ChatGPT preberejo to datoteko, da bi razumeli razpoložljive orodje in zmogljivosti.
Kursor
Vdrži se v svojo.cursorrulesKursor bo prišel do Solaceja, kadarkoli ga boste prosili, da se poveže z spletno stranjo.
Żeglarstwo przy użyciu wiatru
Vdrži se v svojo.윈드서핑 규칙Żeglarstwo przy użyciu wiatru (Codeium) zbere zmogljivosti Solace natančno tako kot Kursor isti format, nič trčenja.
Copilot GitHub
Vstopite v.github/copilot-instructions.mdCopilot bo predlagal Solace API kliče za brskalnike.
Pomočnik
Prepustite kot sistemski zahtevek z--system-prompt solace-aider.mdPomočnik bo vse spletne interakcije samodejno usmerjal skozi Solace Browser.
Continu.dev Continu.dev Continue.dev
Dodaj do svojega.continue/config.jsonNadalje bo na površini Solace pregledni avtomatise kot domorodni orodje v VS Code in JetBrains.
克莱恩
Vdrži se v svojoدليل. يقرأ 克莱恩 قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.克莱恩 prebere pravila projekta ob začetku seje Solace zmogljivosti se samodejno naložijo za vsak pogovor.
根码
Na kraju v mestu.roocode/Regeln/根码 (prej Roo-克莱恩) je podedoval zmogljivosti Solaceovega brskalnika skupaj z agentičnimi načini za kodo.
Gemini CLI Gemini CLI Google Gemini CLI
Dodajte doGEMINI.mdGoogleov odprtokodni agent CLI vbere Solace navodila na enak način kot Claude.CLAUDE.md.
Jules Jules Google Jules
Jules prebereAGENTS.mdNavodila Solace se prikazujejo samodejno, ko Jules opravlja katero koli spletno nalogo v vašem repo.
Redaktor Zed
Vstavi pravila v92Zedov AI panel jih bere na avtohtonem jeziku Solace je takoj na voljo Zed AI asistentu.
Amazon Q-udvikler
Dodajte do.amazonq/rules/solace.mdAmazon Q-udvikler prebere datoteke pravil za označevanje iz tega imenika za vsako sesjo kodiranja v vašem projektu.
JetBrains KI
Dodajte do.idea/ai-guidelines.mdJetBrains KI Assistant prebere to datoteko v vseh IntelliJ, PyCharm, WebStorm in vseh JetBrains IDE.
Kodežni graf Cody
Na mesto v kontekstu.cody/context/solace.mdCody vključuje to datoteko v svoj kontekst za pridobivanje Navodila za Solace se pojavljajo v vsakem pogovoru Codyja.
塔比尼
Konfigurirajte ga preko.. ملف تخصيص 塔比尼 يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.塔比尼ova datoteka za osebnost omogoča, da jo naučite orodju skupine, vključno z avtomatizacijo brskalnika Solace.
Répondre à l'AI
Dodaj do svojega.replit をreplitする をreplitするFiles's[ai]Od tukaj Répondre à l'AI prebere kontekst projekta Solace postane na voljo v vsakem delovnem prostoru Replit.
Devin est un homme. est un homme.
Na kraju v mestu.devin/Handling-Anleitungen/Devin est un homme. prebere projektne knjige pred začetkom dolgoročnih nalog Solace orodja za brskalnik so na voljo za vsak web tok dela.
Fabryczny Droid
V tovarni se pišeAGENTS.md in in in .fabryka/Droid agenti podedujejo Solaceove zmogljivosti pri avtomatizaciji delovnih tokov razvoja programske opreme.
Kilo Code Kilo Kilo
Dodajte do.kilocode/rules/ . .Kilo Code Kilo sledi isti vzorec pravil projekta kot 克莱恩 Solace naloži navodila za vsako agentično sesjo kodiranja.
llms.txt
Jeremy Howard standard za LLM-prebrljive opise mest. -Pustite v korenino projekta za vsak LLM, da bi razumeli Solace.
Download llms.txtKaj je v CLAUDE.md Snippet?
Vsak integrativni datoteka učita vašega AI agenta natančno, kako uporabljati Solace. Tukaj je Kod Claude snippet, ki ga lahko pustite v svoj projekt in vaš agent takoj razume vse 14 APIs Solace, Serwer MCP, e-podpis in najboljše prakse.
# Solace Browser Integration # Source: solaceagi.com/agents/claude.md ## What Solace Is Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888. Sessions persist. Evidence is hash-chained. MCP: 8 tools live now. ## Quick Start curl http://localhost:8888/api/status # → {"running": true, "status": "ready"} ## Core API (all POST, JSON body) navigate {"url": "...", "wait_for": "networkidle"} click {"selector": "..."} fill {"selector": "...", "value": "..."} screenshot {"full_page": true} → {"filepath": "artifacts/..."} evaluate {"Izraz izraz": "document.title"} aria-snapshot GET → accessibility tree JSON ## YinYang YinYang Notify (alert user, non-blocking) POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"} ## E-Sign (FDA Part 11 §11.100) POST /api/v1/esign/token {"user_id":"...","run_id run_id":"...","meaning":"reviewed_and_approved"} ## MCP (add to .claude/settings.json) {"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}} ## Best Practices 1. Screenshot before click (evidence of what agent saw) 2. ARIA snapshot for structure, screenshot for visual 3. Minimal OAuth3 scopes + budget_usd budget on every token 4. Notify user via YinYang YinYang (never console.log spam) 5. E-sign every user-approved action
# Solace Browser Integration
# Source: solaceagi.com/agents/claude.md
## What Solace Is
Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888.
Sessions persist. Evidence is hash-chained. MCP: 8 tools live now.
## Quick Start
curl http://localhost:8888/api/status
# → {"running": true, "status": "ready"}
## Core API (all POST, JSON body)
navigate {"url": "...", "wait_for": "networkidle"}
click {"selector": "..."}
fill {"selector": "...", "value": "..."}
screenshot {"full_page": true} → {"filepath": "artifacts/..."}
evaluate {"Izraz izraz": "document.title"}
aria-snapshot GET → accessibility tree JSON
## YinYang YinYang Notify (alert user, non-blocking)
POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"}
## E-Sign (FDA Part 11 §11.100)
POST /api/v1/esign/token {"user_id":"...","run_id run_id":"...","meaning":"reviewed_and_approved"}
## MCP (add to .claude/settings.json)
{"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}}
## Best Practices
1. Screenshot before click (evidence of what agent saw)
2. ARIA snapshot for structure, screenshot for visual
3. Minimal OAuth3 scopes + budget_usd budget on every token
4. Notify user via YinYang YinYang (never console.log spam)
5. E-sign every user-approved action
Popolnost datoteke:Preprimi kliček CLAUDE.md • Oglejte si agenti.json (obnavlja se strojno)
Witaj świecie v treh API klicih
Celotna API Solace se lahko nauči v treh ukazah.
Navigajte na katero koli stran
curl -X POST http://localhost:8888/api/navigate -H "Content-Type: application/json" -d '{"url": "https://example.com"}'
→ {"success": true, "status": 200, "url": "https://example.com"}
Slik s zaslonom, kaj se je zgodilo
curl -X POST http://localhost:8888/api/screenshot -H "Content-Type: application/json" -d '{"full_page": true}'
→ {"success": true, "filename": "screenshot-20260302-120000.png", "filepath": "artifacts/screenshot-20260302-120000.png", "size": 17115}
Dokazi so bili samodejno zajeti
→ plan.json env_snapshot.json run_log.txt behavior_hash.txt — سلسلة التشفير SHA-256 محكمة. كل إجراء يصعب تغييره.
Plan.json env_snapshot.json run_log.txt behavior_hash.txt SHA-256 hash verigo zapečateno.
Referenca API Referenca API Full Referenca API API
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Končni toček | Metodologija | Kaj počne | Ámbito de OAuth3 |
|---|---|---|---|
/api/navigate | POST | V brskalniku naložite URL | navegador.navegar |
/api/click | POST | Kliknite na kateri koli CSS selektor | Kliknite na Kliknite na browser.click |
/api/fill | POST | V polje obrazec izpolnite | navegador.rellenar |
/api/screenshot | POST | Upravite trenutno stran kot PNG (sprošnjena na artefakt/) | navegador.capture de pantalla |
/api/evaluate | POST | JavaScript ()Izraz izraz), return result key | evaluar navegador |
/api/snapshot | POST | Zgrabite surov HTML strani | navegador.instantánea |
/api/aria-snapshot | GET | ARIA dostopnostno drevo (strukturirano JSON) | navegador.instantánea |
/api/dom-snapshot | GET | DOM snapshot tree za preverjanje strukturne strukture | navegador.instantánea |
/api/page-snapshot | GET | Kombinirana slika strani (ARIA + DOM + metapodatki) | navegador.instantánea |
/api/health | GET | Živnostna sonda za pripravljenost na tekmovanje | (neni) |
/api/status | GET | Zdravje brskalnika, pripravljenost, trenutni URL, seans | (neni) |
/api/part11/status | GET | Del 11 stanje zajemanja, ID seje, pisane bajtove, zadnja napaka | (neni) |
/api/part11/config | POST | Konfigurirajte del 11 načrta za zasnovo in revizijsko imenik | part11.konfigurieren |
/agents.json | GET | Stroje se lahko prebereta, da se lahko manifestira | (neni) |
MCP Server Live Now
Model Context Protocol omogoča, da se kod in drugi HP3-družljivi orodji povežejo z HP1 kot domorodno orodje, brez zahtev za zapovedi v kurilu.
✅ Lokalni MCP Dostupni zdaj
# Step 1: start the Serwer MCP (stdio JSON-RPC 2.0)
python3 ~/projects/solace-browser/yinyang_mcp_server.py
# Step 2: add to Kod Claude .claude/settings.json:
{
"mcpServers": {
"solace": {
"command": "python3",
"args": ["/path/to/solace-browser/yinyang_mcp_server.py"]
}
}
}
Ko je bil konfiguriran, kliče Kod Claude. detect_apps, create_schedule, record_evidencein , in 5 more Hub-native MCP tools on localhost:8888Vsak klic je OAuth3-scoped in SHA-256 dokazano.
Daljinski MCP Oblak (Prihaja kmalu)
# Remote MCP is still coming soon:
{
"mcpServers": {
"solace": {
"url": "mcp.solaceagi.com",
"apiKey": "sol_..."
}
}
}
# Paid users can already launch a cloud twin today:
POST https://solaceagi.com/api/v1/browser/twin/launch
Authorization: Bearer sw_sk_...
{
"scope": "twin:browser",
"ttl_minutes": 15,
"app_id": "solace-yinyang",
"url": "https://solaceagi.com/dashboard"
}
Povežite se iz katerega koli stroja.Pojalniki brskalnika delujejo v oblaku.OAuth3 upravlja vsak instrumentni poziv.Vsaka dejanje je hash-vezana in dokazi-zajel v vaš trezor.Že je potrebna raven Dragon Warrior.
8 Narzędzie MCPs Available Today
| Narzędzie MCP | Kartice do API | Kaj počne |
|---|---|---|
detect_apps | POST /detect | Detect which Solace apps are available for a URL. |
list_apps | GET /credits | List the apps currently loaded by the Hub. |
create_schedule | POST /api/v1/browser/schedules | Create a cron-backed schedule for a local Solace app. |
list_schedules | GET /api/v1/browser/schedules | Read back all active Hub schedules. |
delete_schedule | DELETE /api/v1/browser/schedules/{schedule_id} | Remove a schedule by UUID. |
record_evidence | POST /api/v1/evidence | Append a structured audit event to the evidence chain. |
list_evidence | GET /api/v1/evidence | Paginate existing evidence records for review. |
get_hub_status | GET /health | Inspect Hub health, readinessin , in runtime state. |
Kaj lahko vaš agent naredi z Solacem
Preveč navigacija in klik Solace daje svojemu agentu popoln senzorni in spominni sistem za splet.
Poglejte stran
Zgrabite DOM posnetke in drevesa ARIA dostopnosti. Vaš agent dobi strukturirane vizualne + semantične podatke, ne samo surovo HTML.
Izvedite strukturirani podatki
Utekni, utegni, utegni. /api/evaluateIzvlečite tabele, cene, vrednosti obrazca ali katerokoli drugo datoteko strani neposredno v kontekst vašega agenta.
Scoped Permissions
Zahtevajte le tisto, kar potrebujete. - Tokeni OAuth3 so v obsegu ()navegador.navegar, Kliknite na Kliknite na browser.click, navegador.rellenar), časovno omejena in preklicljiva.
Automatic Evidence
Vsak del agenta je samodejno zapisovan, hash-vezan in zapečatljen, zato agent ustvari auditno sledilo, ne da bi napisal niti ene vrstice zapisovalne kode.
Recept za spomin
Na ponovnem oddaji vaš agent popolnoma preskoči LLM in za 0,001 $ 99% cenejši od ponovne odkritja.
Zagotavljanje proračuna
Nastavite omejitve porabe na sestanek."presupuesto_usd": 0.05V vašem zahtevu za znamko in Solace se je agent odločil, ko je proračun zadel.
Iskanje dokazov
Vprašanje preteklosti poteka z/api/evidence/searchAgenti lahko poiščejo, kaj se je zgodilo v prejšnjih sejah, ki so uporabne za postopne naloge, kot so "trajg e-poštne pošte, ki se niso videvale od zadnjega tekta".
Sedijsko trpljenje
Sesije brskalnika preživijo med klici agentov.Enkrat se prijavite, ponovno uporabite sejo.Ni več ovrednotitve.Piškotki, lokalni shranjevanje in auttokeni ostanejo v vseh nalogah.
Paralelne zavihke
Vaš agent lahko vzporedno odkropi 10 strani, primerja rezultate in združuje ugotovitve, vse skupaj z neodvisnimi sledovi dokazov.
Multi-Agent Swarms
Spawn več neodvisnih primerov Solace Browserja. Skautski agenti raziskujejo; koderski agenti delujejo; skeptični agenti preverjajo. Vsaka primerka ima svojo sejo, proračun in verižno verigo. Orchestrate iz katerega koli načrtovalca (cron, Cloud Run, GitHub Actions).
E-Pregled in FDA Del 11
Vsak odobren ukrep je lahko elektronsko podpisan: uporabnik zapisuje pregled in odobritev tega ukrepa na [PH0]]”. Podpis je SHA-256 zapečatljen v hash verigo.
Najboljše prakse agentov
Vzorec, ki omogoča, da je vaš agent zanesljiv, preverljiv in poceni.
✅ Slik zaslona pred klikom
Vedno pokličite/api/screenshotTo ustvarja evidenco dokazov, kaj je agent videl pred ukrepanjem kritično za revizije poti in popravljanje neuspešnih dirk.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
Slika za strukturo, zaslon za vid
Uporabite /api/aria-snapshot(ARIA dostopnostno drevo, JSON) kadar je vaš agent potreben za razumevanje strukture strani./api/snapshotUporabite za surovo HTML./api/screenshotza vizualno razporeditev in slike.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
Zahtevate minimalne oblike uporabe
Vprašajte le obsegov OAuth3, ki jih potrebuje vaš opravilnik.navegador.rellenarOzke oblike preprečujejo naključne stranske učinke in izpolnjujejo revizije skladnosti.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["navegador.navegar",
"navegador.capture de pantalla"],
"ttl_seconds": 300
}
Preverite, ali obstajajo obstoječe recepte.
Preden opravite potek dela z žetonmi LLM, pokličite ./api/recipes/matchČe obstaja recept za nalogo, ga ponovite pri 0,001. $.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
Postavite proračun za vsako sejo
Nikoli ne dovoli, da agent deluje brez proračunskega zgornjega zgornjega meje.budget_usd budget budgetSolace bo seje težko ustavil, ko bo dosežen omejitev, namesto da bi tiho preveč porabil.
POST https://solaceagi.com/api/v1/oauth3/token {
"api_key": "sw_sk_..."
}
# → {"access_token":"..."}
POST https://solaceagi.com/api/v1/oauth3/tokens
Authorization: Bearer sw_sk_...
{
"scopes": ["files.read", "files.write"]
}
# → {"token":"o3_..."}
# Use header: X-OAuth3-Token: o3_...
Ponovno uporabite seance za preverjene spletne strani
Enkrat se prijavite in shranite žeton za sejo."id phiên"V naslednjih API klikih za ponovno uporabo piškotkov in avtorskega stanja.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Agent-Native Matters Why
AEO: Agenta za optimizacijo motorja
Tako kot je SEO optimiziran za iskalnike, AEO optimizira za AI agente.Solace je prva platforma, zgrajena z agenti kot uporabniki prve klase, ne pa posmrtna misel.
Dokaz, ki ga vaši agenti ne morejo ponarediti
Vsaka akcija agenta ustvari potrdilo s šah-veziklinami SHA-256. vaš CISO lahko pregleda, kaj je naredila AI. vaš odbor lahko vidi dokaze.
Recepte, ki bodo agencije naredili pametnejšega
Ko agent dokonča nalogo, postane recept. Naslednjič: $0.001 ponovitev no LLM žetonov porabljenih.
Kako Solace primerja
Razvijalec, ki izbere orodje za avtomatizacijo brskalnika, se sprašuje na štiri vprašanja: Ali traja seje? Ali ustvarja auditno sled? Ali lahko prenesem na umetno inteligenco brez izplačevanja stroškov? Ali bo preživela audit skladnosti? Tukaj je pošten odgovor za vsako možnost.
| Kar je pomembno, je, da se še vedno spremljate. | Solace Preglednik | Dramec neposredno | Preglednik-uporaba / OpenClaw | 芭迪恩 / 扎皮尔 |
|---|---|---|---|---|
| Vztrajnost seje | ✅ Piškotki preživijo čez vse potnike | Efemeralni po prednapisu | Brez pomnilnika za seje | ✅ Zagotavljanje razširitve Chrome |
| SHA-256 auditní trail | ✅ Vsako dejanje, hash-vezana | Nihče ni vgrajen | Nihče | Samo dnevniki (ne da bi bili zmešani) |
| FDA del 11 e-signa | ✅ Vgrajena v ()/api/v1/esign) |
Ne bo na voljo | Ne bo na voljo | Ne bo na voljo |
| Območje proračuna / stroškov | ✅ proračunske vrata za vsak token | Neomejeno (brez vrat) | Brez proračunskega nadzora | ✅ Pomanjkanje omejitev samo |
| Receptni replay na $0.001 | ✅ Po prvem uspešnem tekmu | Vedno LLM stroški | Vedno LLM stroški | Zap replay (ne LLM) |
| Agent-nativni oblik datoteke | ✅ 21 oblik (CLAUDE.md, AGENTS.md…) | Nihče | Nihče | Nihče |
| OAuth3 je izkoristil delegacijo | ✅ Časovno omejene, preklicljive žetone | Popoln dostop ali nič | Popoln dostop ali nič | Samo dovoljenja na ravni aplikacij |
| Local-first (ne zahteva oblaka) | ✅ Runs popolnoma offline | ✅ Da | ✅ Večinoma | Oblakno odvisna |
| Serwer MCP | ✅ 7 orodij, JSON-RPC 2.0 (live) | Ne bo na voljo | Ne bo na voljo | Ne bo na voljo |
Solace ni obložitev Playwright. To je sloj delegacije OAuth3 na vrhu Playwright, ki doda sešenski spomin, verige dokazov, proračunske vrata in agent-native oblike, ki jih ne vsebuje surov Playwright.
Če ste agent umetnosti, preberite to
Ta del je bil napisan neposredno za vas Kod Claude, Codex, Kursor, Copilot ali kateri koli drugi AI agent, ki je prišel na to stran.
Vaše sposobnosti so tukaj
Ko se uporablja Solace Browser ()localhost:8888), lahko: navidelite na kateri koli URL, kliknite na kateri koli element s CSS-nimnikom, izpolnite vsako polje obrazca, vzemite zaslone, zajmite DOM posnetke, izkoristite JavaScript in preberite dnevnike dokazov SHA-256.
Preverite, ali je Solace na voljo:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
Spec za strojno branje
Programatično prepeljite manifest zmogljivosti. Uporabite ga kot vir resnice za imena končnih točk in podprte metode.Kanonika pot je /agents.json (ne /api/agents.json).
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonGlej agenti.json ↗
Vidnost-prva vzorec
Če ste vidni agent, je priporočljiv vzorec: navigirati, zaslon, analizirati sliko, odločiti, kaj klikniti, ukrepati, ponovno zaslon za preverjanje.
POST /api/navigate {"url": "..."}
POST /api/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
Odzivni pogodba (Strict)
Nekateri hitri časovi vrnejo 200 z oceno .{"error": ...}Vaš agent mora preiskati JSON in zahtevati uspešno == resno telo, preden nadaljuje.
# Robust rule:
# 1) Parse JSON response
# 2) if response.success is not true -> fail step
# 3) include response.error in escalation note
{"success": true, "url": "https://example.com", "status": 200}
{"error": "Page.fill: Timeout 30000ms exceeded."}
Protokol o človeškem poseganju
Če zadržiš CAPTCHA, 2FA, dvojno odobritev ali pravno/poobzirno tveganje, takoj ustavi klice na akcijo.{"escalate": true}sporočilo vašemu gostitelju (ne vrti se s slepo).
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
Varno izvedbo
Uporabite deterministično lokilo: zdravje, navigacija, pregled, delovanje, preverjanje, kontrolna točka.Pridobite /api/page-snapshotPred hitrim ukrepom se lahko odločijo, da bodo izvedene, zato se ne bodo izkazale kaskade.
GET /api/health
POST /api/navigate {"url":"..."}
GET /api/page-snapshot
POST /api/click|fill {"selector":"..."}
POST /api/screenshot {"full_page":true}
GET /api/status
Kako ustvariti zapis e-podpisa
Ko uporabnik odobri ukrep, ki ga pripravljate, zapisejte njegov elektronski podpis.To ustvarja FDA 21 CFR del 11 §11.100 skladno zapis: kdo je odobril, kaj je odobril in kdaj je zaprt v hash verigo.
# After user clicks Odločitev je bila odobrena. in the bottom rail:
POST /api/v1/esign/token
{
"user_id": "phuc@example.com",
"run_id run_id": "run-abc123",
"meaning": "reviewed_and_approved",
"action_description": "Sent email reply to Li Li re: Solace",
"timestamp": "2026-03-03T15:00:00Z"
}
# → {
# "esign_hash": "sha256:abc...",
# "sealed_at": "2026-03-03T15:00:01Z",
# "chain_entry_id": 42,
# "verifiable": true
# }
Multi-Agentov vzorec
Spawn trije agenti za odporno avtomatizacijo: Scout (navigacija + zaslon, samo branje, model L1) → Solver (kliknite + izpolnite + ocenjevajte, model L3) → Skeptic (verificirajte izhod proti dokazom, model L1).run_id run_id run_id run_id; njihove verige dokazov se združujejo ob obsegnem času.
# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["navegador.navegar","navegador.capture de pantalla"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["navegador.navegar","Kliknite na browser.click","navegador.rellenar"],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["navegador.instantánea","evidence.read"],"ttl_seconds":60}
# All share: {"run_id run_id": "run-abc123"}
Napake za referenco za agente
Vsaka Solace napaka je natpisana, odvračljive napake se okrevajo s back-offoom, neodvračljive napake pa potrebujejo človeško posredovanje ali ponovno zasnovo naloge.
| Kodec | Značilnost | Vrnila se lahko | Akcijski agent |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS selektor ni bil enak nič | No | Klic Klic/api/snapshotda bi ponovno odkrili strukturo |
NAVIGATION_TIMEOUT | Stranica je imela 30 let za naloženje. | Da | Ponovno poskusite z eksponencialnim backkoffom (max 3 poskusov) |
BUDGET_EXCEEDED | Sestavni porabi so bili omejeni. | No | Izkoristi se na človeškega operaterja za povečanje proračuna |
SCOPE_DENIED | Dejanje ne v okvirih tokenskih obsegov OAuth3 | No | Prosite za novo žeton z zahtevanim obsegom |
HUMAN_REQUIRED | CAPTCHA ali 2FA so odkrili | No | Klic Klic{"escalate": true}Takoj je bilo to potrebno. |
NETWORK_ERROR | Ciljni spletni prostor je nedosegljiv | Da | Poskusite po petih, nato pa tridesetih, nato pa ne uspejte |
SESSION_EXPIRED | Avt piškotki stale | No | Ponovno preverite, nato pa nadaljujte s zadnjega preveritvenega mesta za dokaze |
ELEMENT_NOT_INTERACTABLE | skrivan ali zaskrbljen Element | Da | Počakajte 2 sekunde in se ponovno poskušajte; zaslon za preverjanje stanja najprej |
Semantični Wayback Machine Wiki Prime
Vsako stran, ki jo Solace obišče, je stisnjena v semantični posnetek 750-bajtnega grafika, ki shrani strukturo, namero, navigacijo in ključne subjekte strani. Po prvem prenosu ni potrebnega strežnika.
Pliv razdelitve: localhost:8888Upravlja lokalno zasedanje/izvršitev v Solace Browserju, medtem kohttps://solaceagi.com/api/v1/prime-wiki/* Območje samo lokalno deluje brez indeksnega oblaka.
750 bytes → Popolnoma stran
Wayback Machine shrani 100 KB+ surovega HTML na stran (100.000 TB v celoti). Solace shrani 750-bajtni semantični skelet in lokalno rekonstruira enakovredno stran. 133x manjša. Null centralizirana odvisnost.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
Index Appstore-Focused Index
Za razliko od Wayback Machine (celotnega spleta), se Solace osredotoča naspletna mesta za trgovino aplikacijspletna mesta, ki imajo recepe za avtomatizacijo Solace. GitHub, Gmail, LinkedIn, Substack, Zamisel in še več.
GET /api/v1/prime-wiki/search?q=github
# Returns all indexed GitHub pages
GET /api/v1/prime-wiki/stats
# {"count": 7, "rtc_verified_count": 7}
Pro: Popolni dostop do skupnosti
Brezplačno:Zbirate posnetke iz lastnega brskanja.
Pro ($28/mesec):Takoj dostopajo do polnega indeksa skupnosti semantičnega pomnilnika za vsako spletno mesto v trgovini z aplikacijami. Preskoči ponovno odkritje LLM. Prihranite 10$50/mesec v žetonih.
# Download all appstore codebooks once: GET /api/v1/prime-wiki/assets?appstore_only=true # Store at ~/.solace/pzip/assets/ # Decompress locally, forever — offline capable
API za oddajo Server-Side Reconstruction
Rekonstruira vsako indeksirano stran neposredno iz API. Vrne polno HTML z vgrajenim premierskim mermaidskim FSM diagramom stanja. Koristen za predizgled, zaslone in napravo za napravo.
# Render by URL (server decompresses + reconstructs): GET /api/v1/prime-wiki/render?url=https://github.com # Render by hash: GET /api/v1/prime-wiki/render?url_hash=<sha256> # ← Returns full HTML + Prime Mermaid diagram
prispevajte k lastnim stranem
Vsak obisk v aplikacijski trgovini Solace Browser ustvarja primarni vpis na Wiki.Opt-in za skupno rabo skupnosti vaše obiske bodo koristile vsakemu članu Pro.Pložite domene kodebooke za pospešitev dekompresije.
# Push a snapshot (community contribution):
POST /api/v1/prime-wiki/push
{"url_hash": "<sha256(normalized_url)>",
"url_display": "https://github.com",
"snapshot_b64": "<base64(gzip(json_snapshot))>",
"original_size": 12345,
"compressed_size": 912,
"schema_version": "prime-wiki-v1",
"page_type": "landing",
"rtc_verified": true,
"sha256_original": "<sha256(raw_json_bytes)>",
"sha256_compressed": "<sha256(gzip_bytes)>"}
# Upload domain codebook (Pro):
POST /api/v1/prime-wiki/assets
{"domain": "github.com", "asset_b64": "..."}
Yinyang: vaš agent je na strani spremljevalec.
Vsaka stran, ki jo obišče Solace Browser, dobi stalni dvojni prekrivek.Gornji vlak prikazuje stanje vašega agenta v realnem času.Dano vlak je klepetna plošča, kjer lahko neposredno pogovoriš z Yinyangom.Oba sta se vbrizgala prek .añadir_init_scriptpreživijo navigacijo, ponovno naloženje strani in strani, ki so zaklenjene s CSP-om, kot je Gmail.
▲ Top Rail Vedno vidna
Na vrhu vsake strani je prilepen 32px bar.[PH0]] doma→ nazaj v brskalnik domov z enim klikom.IDLE / EXECUTING / PREVIEW_READY / DONE), tekoče ime aplikacije in statistike o rotaciji vrednosti (obiskanje strani, klici LLM, prihranjeni stroški, trajanje seje).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Bottom Rail Chat & Odločitev je bila odobrena.
Na dnu vsake strani je padla 36px-ska klepetna plošča, ki se samodejno razširi, ko doseže stanje.PREVIEW_READY(vsak vaš agent je pripravil akcijo),BLOCKED(potrebuje pojasnilo), aliFAILEDUporabnik klikne.Odločitev je bila odobrena. or Zavrnivaš agent prejme odločitev prek WebSocket.
# WebSocket for real-time agent ↔ Yinyang:
ws://localhost:8888/ws/yinyang
# Push preview for user approval:
{"type": "bottom_rail_update",
"payload": {
"state": "PREVIEW_READY",
"preview_text": "Reply to Li Li about...",
"show_approve_reject": true,
"run_id run_id": "run-abc123"
}}
Push Alerts 3 Kanalki
Agenti lahko na uporabniku pošljejo obvestila brez prekinitve njihovega trenutnega strani.prípitok(3 spodnje desno popup popup),popup popup popup popup(modal z akcijskimi gumbami),PrejemanjeVsi kanali so FSM-gated brez opozorilnih požarov brez veljavnega prehoda stanja.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "prípitok",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "prípitok" | "popup popup" | "Prejemanje"
# priority: "low" | "high" | "critical"
Deluje na vseh straneh Vključno z Gmailom
Železnice so vbrižane kotSodelovalni scenarist añadir_init_scriptoni ostanejo v vsakem navigacijskem kontekstu istega brskalnika, vključno s strani, ki so z zaklenjeno CSP-om, kot soGmail, Google Docs er et af de mest populære Google Docs. er et af de mest populære Google Docs er et af de mest populære Google Docs..in , inZamiselJS uporablja samo DOM metode (ne.HTML innerYinyang je vedno viden, vedno dosegljiv.
Yinyang Chat API
Uporabniki lahko neposredno v Yinyang vpišejo iz spodnjega pruga.Vodnik prejme sporočila prek WebSocket in lahko odgovori.To uporabite za zahteve za pojasnila, dvomne odobritve ali spremembe konfiguracije med opravljanjem.Vsaka sporočila se evidentira v sled dokazov dela 11.
POST /api/yinyang/chat
Authorization: Bearer <api_key>
{"message": "User says: skip newsletters",
"context": {"run_id run_id": "run-abc123"}}
# → {"reply": "Got it. Skipping newsletters..."}
Rezultati agenta: Vaša odjava, izjava in dokazi
Vsaka naloga, ki jo izvaja vaš agent, prinaša rezultate, ki so dostopne iz začetne strani Solace Browserja.Zapravljena po načelu Jony Ive: vedno prisotna, nikoli navzkrivljajoča, točno tisto, kar potrebujete.Agent deluje; pregledujete, podpisujete in pošiljate.
Vstopna škatla Zizveze čakajo na pregled
Vsak osnutek, ki ga pripravlja vaš agent (e-poštni odgovor, posnetek v skupini, komentar na LinkedIn) pride sem, preden se pošlje.V poštni škatli so prikazani: kontekst pošiljatelja, osnutek pisanega z zastopnikom, ocena zaupanja, ocenjeno čas pošiljanja. Preglejte in odobrite z enim klikom ali urejte pred odobritvijo.
GET /api/v1/inbox
# {"items": [{
# "id": "draft-abc",
# "app": "gmail-inbox-triage",
# "type": "email_reply",
# "to": "li.li@...",
# "subject": "Re: Solace user case",
# "preview": "Hi Li Li, thanks for...",
# "confidence": 0.91,
# "status": "awaiting_approval"
# }]}
Outbox Poslan in načrtovan
Pri odobrenih predmetah se v oddaji oddaje v oddaji.Poglejte, kaj je bilo poslano, kdaj, s katero aplikacijo in s katero dokazo se je povezalo.Predpremljene predmete prikazujejo čas naslednjega sprožitve.Vsaka vhoda iz oddaje oddaje povezuje do celotnega paketa dokazov dela 11.
GET /api/v1/outbox
# {"items": [{
# "id": "sent-xyz",
# "app": "gmail-inbox-triage",
# "sent_at": "2026-03-03T14:30:00Z",
# "to": "li.li@...",
# "evidence_hash": "sha256:abc...",
# "status": "sent"
# }]}
📅 Urnik in koledar
Ponavljajoče se naloge (jutrajni povzetek, tedenski prebav, nočni arhiv) se pojavijo v urniku.Glej naslednji čas, rezultat zadnjega opravka in proračun, porabljen v tem obdobju.Agenti lahko dodajo na urnik prek API; uporabniki lahko ustavijo, preskočijo ali se preusmerjajo s začetne strani.
GET /api/v1/schedule
# {"items": [{
# "app": "morning-brief",
# "cron": "0 7 * * *",
# "next_run": "2026-03-04T07:00:00Z",
# "last_status": "DONE",
# "budget_used_7d": "$0.12"
# }]}
Zgodovina Recepta Potek Log
Vsaka potek recepta je zapisana: ime aplikacije, trajanje, uporabljeni žetone, stroški, rezultat. Uspešni potek zgradi kesh recept za prihodnje $0,001 nadomestke. Neuspešni potek pokaže, kje so se razbili in zakaj so odlični za napravo receptov aplikacij.
GET /api/v1/history?limit=20
# {"runs": [{
# "run_id run_id": "run-abc",
# "app": "gmail-inbox-triage",
# "started": "2026-03-03T14:00:00Z",
# "duration_s": 18,
# "tokens": 1247,
# "cost_usd": 0.00073,
# "outcome": "DONE",
# "recipe_replayed": false
# }]}
FDA Del 11 Dokazi
Vsak odobren ukrep ustvari nestanovit sekvenco zaslonov, dostopno iz zgodovinske plošče: glejte natančno, kaj je preglednik prikazal pred tem, ko je vaš agent ukrepal, kaj je agent predlagal in kaj je dejansko izvedel.
GET /api/v1/evidence/{run_id run_id}
# {"run_id run_id": "run-abc",
# "screenshots": [
# {"step": 1, "url": "...", "sha256": "..."},
# {"step": 2, "url": "...", "sha256": "..."}
# ],
# "seal": {"hash": "sha256:...",
# "signed_at": "..."}}
Wiki Prime Snapshots
Ko vaš agent obišče novo spletno mesto, ustvari Wiki Prime posnetek: indeksirano zemljevid vseh interaktivnih elementov (DOM selektorji, ARIA vloge, akcijske poti).Ti posnetki omogočajo ponovitev prihodnjega recepta pri 0,001 $.
GET /api/v1/prime-wiki/list
# {"snapshots": [{
# "domain": "mail.google.com",
# "captured_at": "2026-03-03",
# "selectors": 847,
# "recipes": 3,
# "mermaid_url": "/prime-wiki/gmail.md"
# }]}
Učenje iz človeških ureditev
Ko uporabnik ureja zasnovo, napisano s pomočjo agenta, preden ga odobri, Solace zabeleži delta kot .signal za preferenčne informacijeSčasoma se agent nauči glasu, tonu in stilu uporabnika brez nobenega izrecnega usposabljanja. - To je povratna vez, ki agente izboljšuje, ko jih več uporabljate.
Kako to deluje
- Agent piše draftZatem se nahaja v poštnem škatlu s →
Status: v pričakovanju_prijetnosti - Uporabnik ureja osnutek→ Solace razlikuje originalni vs. urejen besedil, izvleče delta
- Uporabnik odobri→ delta je shranjen kot astilni prednostoznačeni z aplikacijo + prejemnik
- Naslednji tek→ agent prejme stilske preference v svojem sistemu prompt:
User prebere: krajše podpisovanje, brez znakov izzivov, vedno omenite referenčno številko - Dokaz se izboljšuje→ manj sprememb, ki so jih potrebovali sčasoma.
API za preference
Agenti lahko pred ustvarjanjem osnutkov preberejo preference za slog. Preference so shranjene na aplikacijo, prejemnik in globalno.
# Read preferences before drafting:
GET /api/v1/preferences?app=gmail-inbox-triage
# {"global": ["concise, 3 sentences max"],
# "recipient:li.li@...": [
# "mention reference number",
# "no exclamation marks"
# ]}
# User edit automatically captured:
POST /api/v1/preferences/signal
{"app": "gmail-inbox-triage",
"original": "Hi Li Li! Thanks for...",
"edited": "Hi Li Li, thanks for...",
"recipient": "li.li@..."}
Pravi vzorec: odobri, ureji, nauči
Anti-Clippy zakon:Nikoli ne odobri samodejno, nikoli ne pošlji samodejnoČlovek vedno vidi osnutek najprej. To ni omejitev. To je značilnost. Vsako odobritev je signal usposabljanja. Vsako urejanje je popravek. Po 510 tekmah agent osnutka z vašim glasom. Po 50 tekmah redko potrebuje urejanje. Dokazni sled dokazuje, da je bila vsaka odločitev odobrena človekom. Vaša produktivnost povezuje in vaša sodba je v evidenci.
Inspektor za tolažbo Konc manualnega QA, kot ga poznamo
Vsak razvojni tim brez strukturiranega QA mosta je slep. Solace Inspector je prvi in edini orodje, ki agentom za šifriranje AI daje standardizirano, dokazov zapečateno, odobreno s strani ljudi QA protokol.
Če vaš agent AI ne uporablja Solace Inspectorja, ima sranje QA.
Protokol agentov
Vsak kodalec oddaja JSON specifikacijo v .v poštni škatli/Zbere zapečateni poročilo odOutbox/Brez prilagojene integracije, brez SDK, brez kakršnega koli jezika, brez kakršnega koli modela.
Zvezda dokazov
Vsaka inšpekcija je SHA-256 zapečatena z FDA 21 CFR del 11 arhitekturnimi dokazi. Sodišče-prijateljivo. Tamper-evident. Stalni. Ne “ sem jo preizkusil ” — kriptografski dokaz.
Homologiranje človeškega elektronskega podpisa
AI predlaga popravke, človek odobri z enim klikom, anti-Clippy: nikoli ne samodejno odobri, vsaka popravka je odločitev človeka, ki jo je vpisal, to je ubijalna funkcija, nič drugega ga nima.
HITL Loop (Človek v poteku)
test-spec.json to v poštni škatli/
# Step 1: Agent writes test spec to v poštni škatli/ (any format, any language)
cat > v poštni škatli/test-spec-001.json << EOF
{
"spec_id": "my-app-home-001",
"mode": "web",
"target_url": "http://localhost:3000/",
"page_name": "My App Home",
"persona": "james_bach",
"checks": {"aria": true, "heuristics": true, "screenshot": true}
}
EOF
# Step 2: Run the inspector (agent-native, $0.00 LLM cost)
python3 scripts/run_solace_inspector.py --inbox
# Step 3: Agent reads sealed report from Outbox/
cat Outbox/report-my-app-home-001-*.json
# {
# "qa_score": 74,
# "belt": "Yellow",
# "heuristic_issues": [{"type": "accessibility", "msg": "3 images missing alt", "heuristic": "ARIA-1"}],
# "agent_analysis_request": { "system_prompt": "You are James Bach ist ein guter Mensch....", "evidence_summary": {...} },
# "agent_analysis_response": null, ← YOU fill this in with your model
# "fix_proposals": [], ← YOU add proposals here
# "evidence_hash": "sha256:a4f3...", ← cryptographic seal
# "human_approved": false
# }
Web Mode
Vsaka aplikacija brskalnika. Navigejte + ARIA drevo + DOM posnetek + HICCUPPS heuristika + zasnetek celotne strani. Dela na lokalnih gostiteljih, posnetkih, produkcijskih ali javnih URL-jih.
način: "spletna mreža"
CLI Mode
Kateri koli orodje za ukazno vrstico. Izvršitev podprocesov + potrditev izhodne kode + stdout/stderr zajem. Kent Beck Kent Beck: Probirajte, kar vas je strah.Deluje na katerem koli CLI v katerem koli jeziku.
način: "cli"
API način
REST/HTTP končne točke. Zahtevek + potrditev scheme odziva + časovni načrt + varnostne glave. Cem Kaner Cem Kaner: Kakšen je kakovostni tveganje v tem kontekstu?
način: "api"
Prihajajoči sprint 3
Odbor strokovnjakov (vbrizga kot navodila za analizo)
Potvrđeno: Null konkurenti imajo vse tri
| Naredilo je orodje. | Protokol agentov vmesni/izmesni okvir JSON |
Zvezda dokazov SHA-256 zapečateni |
Človeški e-pisnik odobrite popravke |
Cena/trka |
|---|---|---|---|---|
| Inspektor za tolažbo | ✅ | ✅ | ✅ | $0.00 |
| Dramec MCP | ✅ | ❌ | ❌ | Vsaka vrsta se razlikuje |
| Ketryx (samo za zdravnike) | ❌ | ✅ | ✅ | $$$ |
| 卡沃尔夫 | ❌ | ❌ | ❌ | $2,000/mo |
| Mabl Mabl | ❌ | ❌ | ❌ | $800/mo |
| 测试Rigor | ❌ | deliščen | deliščen | $1,200/mo |
| 德文2.0 | ❌ | ❌ | ❌ | 500/mesec + $5/raz $500/mesec |
Raziskave so preverile marca 2026 v 15 orodjih. - FDA s 2026 AI usmeritve tlačijo industrijo v prav tisto, kar smo že zgradili. - Regulacija nas je dosegla.612 mesecev pred poljem.
Vstavite v 30 sekundah
# Solace Inspector is built into Solace Browser. # It is the default app — always present, cannot be uninstalled. # If you have Solace Browser: python3 scripts/run_solace_inspector.py --self-diagnostic # First time? Install Solace Browser: git clone https://github.com/solaceagi/solace-browser cd solace-browser python3 -m pip install -r requirements.txt python3 web/server.py # http://localhost:8791 # Then drop any test spec in v poštni škatli/ and run: python3 scripts/run_solace_inspector.py --inbox
Tehnično-prebrati zmogljivosti
Punkt /agents.jsonKončna točka vrača strukturirane možnosti za programsko odkrivanje agentov.