Vaš AI agent sada kontrolira bilo koju web stranicu.
S punim audit traelom.
Odbacite jednu liniju uCLAUDE.md, AGENTS.md, or .cursorrulesa vaša AI dobiva stvarnu automatizaciju pretraživača: Gmail, Slack, LinkedIn, GitHub i bilo koji web stranic. Svaka klik potpisana, zapečaćena i provjerljiva. МЦП сервер živ.
Dodajte utjehu svakom projektu u jednoj zapovijedi
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Dodatak Solace upute za automatizaciju preglednika u vaš Клод Код projekt.
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.
Svaki veliki AI kodiranje agent, podržan
Snimite pravi format za svog AI pomoćnika.Svaki datoteka govori AI-u točno kako koristiti Solace navigacija, klik, ispunjenje, snimak zaslona i hvatanje dokaza.21 podržanih formata iz kutije.
Клод Код
Ubaci se u svojCLAUDE.mdКлод Код će koristiti Solace Browser za bilo koji zadatak web automatizacije automatski.
Codex de OpenAI
Ubaci se u svojAGENTS.mdCodex de OpenAI i ChatGPT . . agenti čitaju ovu datoteku kako bi razumeli dostupne alate i mogućnosti.
Курсор
Ubaci se u svoj.cursorrulesКурсор će doći do Solace-a kad god ga zamolite da komunicira s web stranicom.
Vjetrovski surf
Ubaci se u svoj.윈드서핑 규칙Vjetrovski surf (Codeium) uzima Solace mogućnosti točno kao i Курсор isti format, nula trnjeva.
Copilot GitHub
Ubaci se u.github/copilot-instructions.mdCopilot će predložiti Solace API pozive za brskaljske zadaće.
Помажећ
Prođite kao sustavni poziv s--system-prompt solace-aider.mdПомажећ će automatski upućivati sve web interakcije putem Solace Browsera.
Nastavi.dev
Dodajte u svoj.continue/config.jsonNastavit će se pojaviti Solace browser automatizacija kao izvorni alat u VS Code i JetBrains.
Клин
Ubaci se u svojدليل. يقرأ Клин قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.Клин čita pravila projekta na početku sesije Solace mogućnosti se automatski učitavaju za svaki razgovor.
РуоКоде
U mjestu u mjestu.roocode/Regeln/РуоКоде (ranije Roo-Клин) naslijedi Solaceove mogućnosti browsera zajedno s agentičkim načinom kodiranja.
Гудгле ЦЛИ Гудгле Цемни ЦЛИ
Dodajte uGEMINI.mdGoogleov CLI, otvoren izvorni agent, uzima Solaceove upute na isti način kao i Claudeove.CLAUDE.md.
Jules je Jules je Google Jules..
Jules čitaAGENTS.mdUputa za Solace se automatski pojavljuju kada Jules obavlja bilo koji web-pozicijski zadatak u vašem repo-u.
Redatelj Zed
Uložite pravila u92Zedov AI panel čita ove materijale na izvornom jeziku Solace postaje odmah dostupan Zedovoj AI pomoćnici.
Амазон Ц Дизајлор
Dodajte u.amazonq/rules/solace.mdАмазон Ц Дизајлор čita oznake pravila datoteke iz ovog direktorija za svaku sesiju kodiranja u vašem projektu.
JetBrains KI
Dodajte u.idea/ai-guidelines.mdJetBrains KI Assistant čita ovu datoteku u IntelliJ, PyCharm, WebStorm i svim JetBrains IDEs-ima.
Codyjev izvorni grafičar
Mjesto u kontekstu.cody/context/solace.md.Cody uključuje ovu datoteku u svoj kontekst za otkupljanje U svakom Cody razgovoru pojavljuju se upute o Solacu.
Табнин
Konfigurirajte preko. ملف تخصيص Табнин يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.Табнинov personalizirani datoteka omogućava da naučite svoj timov lanc alatova, uključujući Solace automatizaciju pretraživača.
Реплитирајте АЛ
Dodajte u svoj.replit をreplitする をreplitする"Fajl je bio u stanju da se vrati.[ai]Replita AI čita kontekst projekta odavde Solace postaje dostupan u svakom Replitu radnom prostoru.
Девин
U mjestu u mjestu.devin/Handling-Anleitungen/Девин čita projektne knjige prije nego što pokrene zadatke s dugim horizontom Solace su alatki za preglednik dostupni za svaki web radni tok.
Фабрични дроид
Fabrika čujeAGENTS.md I i i .fabryka/Droid agenti naslijede Solace mogućnosti kada automatiziraju radne tokove razvoja softvera.
Kilo Code Kilo Kilo
Dodajte u.kilocode/rules/ . .Kilo Code Kilo slijedi isti obrazac pravila projekta kao i Клин Solace instrukcije za svaki agentic kodiranje sesije.
llms.txt
Jeremy Howard standard za LLM-opisivanje mjesta.Pusti u svoj projekt korijen za bilo LLM razumijeti Solace.
Download llms.txtŠto je unutar klaude.md Snippet
Svaka fajl integracije uči vašeg AI agenta točno kako koristiti Solace.Ovdje je Клод Код snippet odbaci ga u vaš projekt i vaš agent odmah razumije sve 14 Solace API-ova, МЦП сервер, e-podpisivanje i najbolje 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 izražavanja": "document.title"} aria-snapshot GET → accessibility tree JSON ## Ин Янг 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 Ин Янг (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 izražavanja": "document.title"}
aria-snapshot GET → accessibility tree JSON
## Ин Янг 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 Ин Янг (never console.log spam)
5. E-sign every user-approved action
Punog fajl:Preuzmite CLAUDE.md snippet • Pogledajte agente.json (mašinski čitljiv)
Здраво свету u 3 API pozive
Potpuni Solace API se može naučiti u tri zapovijedi.
Navigajte na bilo koju stranicu
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 ekrana onoga što se dogodilo
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 se automatski snimaju
→ 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 lanca zapečaćen.Svaki akcija je tamper-evident.
Referencijska API Referencijska API Full Referencijska API
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Krajnji tačka | Metodologija je metoda. | Što to radi | ОАут3 Скопа |
|---|---|---|---|
/api/navigate | POST | U bramcu učite URL-a | Браузер.навигејт |
/api/click | POST | Kliknite bilo koji CSS selektor | Browser.click |
/api/fill | POST | Popunite polje obrasca | Браузер.филл |
/api/screenshot | POST | Uzimajte trenutnu stranicu kao PNG (spasio na artefakt/) | Браузер.скренсхот |
/api/evaluate | POST | JavaScript ()Izraz izražavanja(Tradnja), povratni rezultat ključ | Браузер.Евалуате |
/api/snapshot | POST | Uzimajte sirov HTML stranice | Браузер.снампшот |
/api/aria-snapshot | GET | ARIA pristupna stablo (strukturizirano JSON) | Браузер.снампшот |
/api/dom-snapshot | GET | DOM snippet tree za provjeru strukturnih provjera | Браузер.снампшот |
/api/page-snapshot | GET | Kombinirani snimak stranice (ARIA + DOM + metapodatke) | Браузер.снампшот |
/api/health | GET | Provjerka za spremnost za vrijeme rada | (nisu) |
/api/status | GET | Zdravlje preglednika, spremnost, trenutni URL, sesija | (nisu) |
/api/part11/status | GET | Dijela 11 stanja hvatanja, identifikacije sesije, bajtova napisana, posljednje pogreške | (nisu) |
/api/part11/config | POST | Konfigurirajte dio 11 modnog načina za hvatanje i audit direktorij | Part11.configure |
/agents.json | GET | Mašina-čitajuće mogućnosti manifest | (nisu) |
MCP Server Live Now
Model Context Protocol omogućuje kod i druge uređaje kompatibilne sPH3 da se povežu saPH1 kao izvorni alat, bez potrebe za zapovijedima za curl.
✅ Lokalni MCP Dostupni sada
# Step 1: start the МЦП сервер (stdio JSON-RPC 2.0)
python3 ~/projects/solace-browser/yinyang_mcp_server.py
# Step 2: add to Клод Код .claude/settings.json:
{
"mcpServers": {
"solace": {
"command": "python3",
"args": ["/path/to/solace-browser/yinyang_mcp_server.py"]
}
}
}
Jednom nakon konfigurisanja, Клод Код poziva detect_apps, create_schedule, record_evidenceI , i 5 more Hub-native MCP tools on localhost:8888Svaki poziv je OAuth3-scoped i SHA-256 dokazan.
Daljinski MCP Oblak (Sljedeće uskoro)
# 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 s bilo kojeg stroja. Radnici preglednika rade u oblaku. OAuth3 upravlja svakom pozivnom alatom. Svaka akcija je hash-lančana i dokazi-uplovljena u vaš trezor.
8 MCP alats Available Today
| MCP alat | Mapovi do API | Što to radi |
|---|---|---|
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, readinessI , i runtime state. |
Što vaš agent može učiniti s Solacem
Osim navigacije i klikovanja Solace daje vašem agentu punu senzorsku i memorijsku sustav za web.
Pogledajte stranicu
Snimite snimke DOM-a i ARIA-ove drveće pristupačnosti. Vaš agent dobiva strukturirane vizuelne + semantičke podatke, ne samo sirov HTML.
Izvaditi strukturirani podaci
Bježi, trči, trči. /api/evaluateIzvadite tabele, cijene, vrijednosti obrasca ili bilo koji drugi podaci stranice direktno u kontekst vašeg agenta.
Scoped Permissions
Zahtjev samo ono što vam je potrebno. OAuth3 tokeni su obuhvaćeni ()Браузер.навигејт, Browser.click, Браузер.филл), vremenski ograničeni i odvozabilni.
Automatički dokaz
Svaka akcija agenta automatski se evidentira, hash-vezuje i zapečaćuje, a agent proizvodi audit trail bez pisanja ni jedne linije registracijskog koda.
Recept memorije
U ponovnom ispitivanju, vaš agent potpuno preskoči LLM i pokreće se na staroj traci za 0,001 $ 99% jeftinije od ponovno otkrivanja.
Budžetsko izvršavanje
Postavite ograničenja potrošnje po sjednici."presupuesto_usd": 0.05U vašem zahtjevu za znakom i Solace tvrdo zaustavlja agenta kada se proračun pogodi nema nestalog troškova.
Traženje dokaza
Dožnja iz prošlosti radi s/api/evidence/searchAgenti mogu tražiti ono što se dogodilo u prethodnim sesijama korisno za povećane zadaće poput "trijaže e-mailove koje nisu viđene od posljednjeg trčanja".
Sesijska ustrajnost
Sesije preglednika preživljavaju između poziva agenata. Upis jednom, ponovno korištenje sesije. Nema ponovnog ovjeravanja. Kolačići, lokalno skladištenje i aut tokeni ostaju među zadacima.
Paralelne tablice
Vaš agent može paralelno otkriti 10 stranica, usporediti rezultate i spojiti nalaze, sve uz nezavisne tragove dokaza.
Multi-Agent Swarms
Spawn više nezavisnih Solace Browser primjeraka. Skaut agenti istražuju; koderi agenti djeluju; skeptični agenti provjeravaju. Svaka instance ima svoju sesiju, proračun i lanac dokaza. Orchestrate iz bilo kojeg programera (cron, Cloud Run, GitHub Akcije).
E-Pregled i FDA dio 11
Svaka odobrena akcija može biti potpisana elektronički: korisnik zapisuje pregled i odobrenje ove akcije na [PH0] [PH1]. Potpis je SHA-256 zapečaćen u hash lancu.
Najbolje prakse agenta
Uzorci koji čine vašeg agenta pouzdanim, revidiranim i jeftinim za rad.
✅ Slik s ekrana prije nego što kliknete
Uvijek pozovite./api/screenshotOvo stvara evidenciju onoga što je agent vidio prije djelovanja kritično za audit trails i debugging neuspješnih runova.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
Snabdomak za strukturu, Snabdomak za vid
Koristite /api/aria-snapshot(ARIA pristupna stablo, JSON) kada vaš agent treba razumjeti strukturu stranice./api/snapshotZa sirov HTML./api/screenshotza vizuelni raspored i slike.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
Zahtjev minimalnih područja za korištenje
Samo tražite OAuth3 obimove koje vam je potrebno za zadatak.Браузер.филлUsuzni oblici spriječiti slučajnost nuspojava i zadovoljiti usklađivanje revizije.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["Браузер.навигејт",
"Браузер.скренсхот"],
"ttl_seconds": 300
}
Prvo provjerite postojeće recepte
Prije nego što pokrenete radni tok sa LLM tokenima, pozovite se./api/recipes/matchAko postoji recept za zadatak, ponovite ga za 0,001. $. Sačuvati poziv za pravedno nove radne tokove.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
Postavite proračun za svaku sjednicu
Nikada ne dopustite agentu da radi bez proračunskog granica.budget_usd budget budgetSolace će zaustaviti sesiju kad se doseže ograničenje, umjesto da tiho troši previše.
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 korištenje sesija za autentificirane stranice
Uđi jednom u lokaciju i čuvaj žig za sesiju."id phiên"U narednim API pozivima za ponovno korištenje kolačića i države autora.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Agent-Native Matters Why
АЕО: Агентски оптимизатор мотора
Baš kao što je SEO optimiziran za pretraživače, AEO optimizira za AI agente.Solace je prva platforma izgrađena s agentima kao korisnicima prve klase, a ne poslije.
Dokazovi koji vaši agenti ne mogu lažirati
Svaka akcija agenta proizvede potvrdu SHA-256 u lancu hash-a. Vaš CISO može provjeriti što je AI učinio.
Receptovi koji čine agente pametnijim
Kada agent završi zadatak, on postaje recept.Sljedeći put: $0.001 replay ne potrošeni LLM tokeni.Agenti koji koriste Solace postaju brži i jeftiniji s vremenom.
Kako se Solace uspoređuje
Razvojnici koji biraju alate za automatizaciju preglednika postave četiri pitanja: Da li se održavaju sesije? Stvara li se audit trail? Mogu li delegirati AI bez otpadnih troškova?
| Feature Feature Feature Feature | Solace Browser | Pjesmaš direktan | Browser-use / OpenClaw | Бардин / Запиер |
|---|---|---|---|---|
| Nastavnost sesije | ✅ Kolačići preživljavaju kroz trke | Efemeralni po podrazumevanju | Nema memorije za sesiju | ✅ Chrome proširenje stanje |
| СХА-256 аудит трал | ✅ Svaka akcija, hash-vezana | Nitko nije ugrađen | Nitko | Logs only (ne-tamper-evident) |
| FDA dio 11 e-signa | ✅ Izgrađen u ()/api/v1/esign) |
Ne dostupna | Ne dostupna | Ne dostupna |
| Buget / granični prag troškova | ✅ Budžetni kapi po žetonu | Unlimited (nema kapija) | Nema proračunskog nadzora | ✅ Plan ograničenja samo |
| Recept se ponavlja na $0.001 | ✅ Nakon prvog uspješnog trčanja | Uvijek LLM troškovi | Uvijek LLM troškovi | ✅ Zap replay (nema LLM) |
| Agent-native formatovi datoteka | ✅ 21 format (CLAUDE.md, AGENTS.md…) | Nitko | Nitko | Nitko |
| OAuth3 je imao delegiranu misiju. | ✅ Vreme ograničene, ponizive žigove | Potpuni pristup ili ništa | Potpuni pristup ili ništa | Samo dozvole na razini aplikacije |
| Lokalno-prva (ne zahtijeva se oblak) | ✅ Рани потпуно офлајн | ✅ Da | ✅ Uglavnom | Oblak-zavisni |
| МЦП сервер | ✅ 7 alata, JSON-RPC 2.0 (live) | Ne dostupna | Ne dostupna | Ne dostupna |
Solace nije Playwrightov oblog, već je sloj OAuth3 delegacije na vrhu Playwrighta, dodajući memoriju sjednica, lance dokaza, proračunske kapije i agentsko-nativne formate koje sirovi Playwright nemaju.
Ako ste AI agent, čitate ovo
Ovaj dio je napisan direktno za vas Клод Код, Codex, Курсор, Copilot ili bilo koji drugi AI agent koji je stigao na ovu stranicu.
Vaše sposobnosti su ovdje
Kada se Solace Browser pokreće ()localhost:8888), možete: navirati na bilo koji URL, kliknuti na bilo koji element CSS selektorom, ispuniti bilo koje polje obrasca, snimiti snimke zaslona, snimiti DOM snimke, pokrenuti JavaScript i čitati SHA-256 evidencijske dnevnike.
Provjerite je li Solace dostupan:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
Mašina-Čitljiv Specifikacija
Uzmi manifest mogućnosti programmatički. Koristi ga kao izvor istine za imena krajnjih tačaka i podržane metode.Kanonikalni put je /agents.json (ne /api/agents.json).
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonPogledajte agente.json ↗
Vision-First Pattern
Ako ste vizija-sposobni agent, ovo je preporučeni uzorak: navigacija, snimak zaslona, analiza slike, odlučivanje na što kliknuti, djelovanje, snimak zaslona ponovno provjeriti.
POST /api/navigate {"url": "..."}
POST /api/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
Ugovor o odgovoru (Strict)
Neki runtimes vraćaju 200 s an{"error": ...}Vaš agent mora pročitati JSON i zahtijevati uspjeh == true body prije nego što nastavi.
# 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."}
Human Escalation Protocol
Ako udariš CAPTCHA, 2FA, dvosmisleno odobrenje ili rizik od pravnog/pridržavanja, odmah prekini pozive na akciju.{"escalate": true}Uprkos tome, obavezno se poslati poruci gostićem orkestratoru (ne pokušavajte slijepo).
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
Sigurna izvedba
Koristite determinističku kružicu: zdravlje, navigacija, inspekcija, djelovanje, provjeravanje, provjeravanje.Dobijte /api/page-snapshotAkcije s visokim rizikom prije nego što se pokrene ostaju revidirane i izbjegavaju kaskadske greške.
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 stvoriti E-Pregled
Kada korisnik odobri akciju koju si pripremio, zapisi njegov elektronički potpis.To stvara FDA 21 CFR dio 11 §11.100 usklađen zapis: tko je odobrio, što su odobrili, i kada je zapečaćen u hash lancu.
# After user clicks Odobravajte 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-Agent Pattern
Spawn tri agenta za otpornu automatizaciju: Scout (navigacija + snimak zaslona, samo čitanje, L1 model) → Solver (kliknite + popunite + procjenite, L3 model) → Skeptic (verificirajte izlaz protiv dokaza, L1 model).run_id run_id run_id run_id; njihove lance dokaza se spajaju u vrijeme pečat.
# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["Браузер.навигејт","Браузер.скренсхот"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["Браузер.навигејт","Browser.click","Браузер.филл"],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["Браузер.снампшот","evidence.read"],"ttl_seconds":60}
# All share: {"run_id run_id": "run-abc123"}
Pogrešno referenciranje za agente
Svaka Solace greška se tipira, retrryable greške se oporavljaju backoffom, ne-retryable greške zahtijevaju ljudsku intervenciju ili redeseniranje zadataka.
| Kode Kode | Značenje | Retritable | Akcijski agent Akcijski agent |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS izbornik nije ništa dopala | No | Poziv/api/snapshotda ponovno otkriju strukturu |
NAVIGATION_TIMEOUT | Stranica je imala 30 godina za punjenje | Da | Ponovno pokušajte uz eksponencijalnu povlačenost (max 3 pokušaja) |
BUDGET_EXCEEDED | Sjednica potrošnje ograničenja hit | No | Eskalate na ljudski operater za povećanje proračuna |
SCOPE_DENIED | Akcija ne u OAuth3 token scopes | No | Zahtjevite novi token s potrebnim obimom |
HUMAN_REQUIRED | CAPTCHA ili 2FA otkriveni | No | Poziv{"escalate": true}odmah odmah odmah |
NETWORK_ERROR | Ciljni stranica je nedostupna | Da | Ponovno se pokušavati nakon pet godina, zatim trideset godina, a onda ne uspjeti |
SESSION_EXPIRED | Auth kolačići stale | No | Ponovo se autentificira, a zatim se nastavi s posljednjeg provjere dokaza |
ELEMENT_NOT_INTERACTABLE | Element je skriven ili isključen | Da | Čekaj 2 sekunde i pokušaj ponovno; snimak zaslona da se prvo provjeri stanje |
Semantički Wayback Machine
Svaka stranica koju Solace posjeti se komprimira u 750-bajtni semantički snimak čuvajući strukturu stranice, namjeru, navigaciju i ključne entitete. Od tog 750-bajtnog sjeme, Solace rekonstruira punu HTML stranicu koja radi potpuno offline. Nije potreban server nakon prvog preuzimanja.
Подељеност потока: localhost:8888Lokalni se uklanjanje/izvršenje u Solace Browseru upravlja, dok sehttps://solaceagi.com/api/v1/prime-wiki/* Lokalni način radi samo bez indeksnog oblaka.
750 bajtova → Full Page
The Wayback Machine čuva 100KB+ sirovog HTML-a na stranicu (100.000 TB ukupno). Solace čuva 750-bajtni semantički skelet i lokalno rekonstruira ekvivalentnu stranicu. 133x manji. Nula centralizirana ovisnost.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
Index koji se fokusira na Appstore
Za razliku od Wayback Machine (celokupnog veba), Solace se fokusira naAppstore sitesstranice koje imaju recept za automatizaciju Solace-a. GitHub, Gmail, LinkedIn, Substack, Nocija i još mnogo toga.
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: Full Community Access
Besplatno:sakupite snimke iz vlastitog pregleda.
Про ($28/м):U svakom slučaju, odmah pristupite punom indeksom zajednice semantičkom pamćenju za svaku aplikacijsku trgovinu. Preskočite ponovno otkrivanje LLM-a. Uštedite $1050/mj. u žetonima.
# 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-a za renderiranje Rekonstrukcija na strani servera
Rekonstruira bilo koju indeksiranu stranicu direktno iz API-a. Vrati puni HTML s ugrađenim Prime Mermaid FSM državnim dijagramom. Koristan za preview, snimke zaslona i debugging recepta.
# 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
Doprinijeti imovini stranice
Svaki Solace Browser posjet aplikacijskoj trgovini stvara Wiki Prime snimak.Opt-in za dijeljenje zajednice vaše posjete koristite svakom članu Pro.Putite domenske kodove za ubrzanje 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 On-Page Companion
Svaka stranica koju Solace Browser posjeti dobiva stalni dual-rail prekrivenost.Gornji vlak prikazuje stanje vašeg agenta u stvarnom vremenu.Gornji vlak je chat panel gdje možete razgovarati s Yinyangom direktno.añadir_init_scriptoni preživljavaju navigaciju, preobražavanje stranica i CSP-blokirane stranice poput Gmail-a.
▲ Top Rail Uvijek vidljiv
32px-ov bar koji je na vrhu svake stranice.[PH0]] Solace dom]→ povratak u domni preglednik jednim klikom.IDLE / EXECUTING / PREVIEW_READY / DONE), trenutno ime aplikacije i statistike rotacije vrijednosti (posjećene stranice, LLM pozive, štedeni troškovi, trajanje sesije).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Bottom Rail Chat & Odobravajte
U dnu svake stranice je raspadao 36px-ski chat panel.PREVIEW_READY(všeš agent je pripremio akciju),BLOCKED(potreban je pojasnjenje), iliFAILEDKorisnik klikne.Odobravajte or Odbijvaš agent prima odluku putem WebSocket-a.
# 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 Kanala
Agenti mogu gurati obavijesti korisniku bez prekida trenutne stranice.Toast(3-a popup popup-a u donjem desnom dijelu),popup popup popup popup(modalni sa akcionim gumbovima),PreuzimanjeSvi kanali su FSM-gated bez upozorenja na požare bez valjanog prijelaza stanja.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "Toast",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "Toast" | "popup popup" | "Preuzimanje"
# priority: "low" | "high" | "critical"
Radi na svim stranicama Uključujući Gmail
Željeznice se ubijaju kaoPjesničar añadir_init_scriptoni traju u svim navigacijama na istom kontekstu pretraživača, uključujući stranice koje su zaključane CSP-om poputGmail, У Google ДокументимаI , iNocijaJS koristi samo DOM metode (ne.HTML innerYinyang je uvijek vidljiv, uvijek dostupan.
Yinyang Chat API
Korisnici mogu pisati direktno na Yinyang iz dno željeznice. Vaš agent prima poruke putem WebSocket-a i može odgovoriti. Koristite to za zahtjeve za objašnjenje, dvosmislene odobrenje ili promjene konfiguracije srednjeg zadatka.Svaka poruka je prijavljena na dokaznu stazu dijela 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 agenata: Vaša upisnica, izlaznica i dokazi
Svaki zadatak koji vaš agent izvršava proizvodi rezultate koji su dostupni s početne stranice Solace Browsera.Designat po principu Jony Ive: uvijek prisutni, nikad narušavajuci, točno ono što vam je potrebno.Agent radi; vi pregledate, potpisate i isporučujete.
Dobavljač Znakovi čekaju pregled
Svaki nacrt koji vaš agent priprema (e-mail odgovor, post Substack, LinkedIn komentar) stiže ovdje prije nego što se pošalje.Putnjava prikazuje: kontekst pošiljatelja, nacrt pisani od agenta, ocjenu povjerenja, procjenu vremena slanja.Recenzija i odobrenje s jednim klikom ili uređenje prije odobrenja.
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 i rasporedjen
Odobravani stavci teče u izlaznu kutiju.Pogledajte što je poslato, kada, kojim aplikacijom i kojim dokazima se hashira.Predviđeni stavci pokazuju vrijeme sljedećeg pokreta.Svaki ulaz izlazne kutije povezuje se sa svojim punim paketom dokaza dijela 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"
# }]}
📅 U redu i kalendar
Ponavljaju se zadaci (jutrošnji izvještaj, tjedni digest, nočni arhiv) koji se pojavljuju u rasporedu.Pogledajte sljedeći radni čas, posljednji rezultat rada i proračun koji je potrošen u tom razdoblju.Agenti mogu se dodavati rasporedu putem API-a; korisnici mogu pauzirati, preskočiti ili preusmjeriti raspored s početne stranice
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"
# }]}
Istorija Recept Run Log
Svaki pokret recepta je evidentiran: ime aplikacije, trajanje, korišteni žigovi, cijena, rezultat. Uspešni pokreti grade kašer recepta za buduće $0.001 zamjene. Neuspešni pokreti pokazuju gdje su prekršeni i zašto su savršeni za ispravljanje aplikacijskih recepata.
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 dio 11 dokaza
Svaka odobrena akcija stvara očiglednu sekvencu snimaka zaslona.Pristupan iz povijesnog panela: pogledajte točno što je preglednik pokazao prije nego što je vaš agent djelovao, što je agent predložio i što je zapravo izvršeno.SHA-256 je hash-vezan.E-podpis spreman.
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
Kada vaš agent posjeti novu stranicu, kreira Wiki Prime snimak: indeksirana mapa svih interaktivnih elemenata (DOM selektorovi, ARIA uloge, akcijske puteve).Ti snimci omogućuju ponovnu igru budućih recepata na $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 ljudskih uređaja
Kada korisnik uređuje nacrt koji je napisao agent prije nego ga odobri, Solace uhvati delta kao .Signal preferencijeS vremenom, agent uči glas, ton i stil korisnika bez ikakvog eksplicitnog treninga.To je povratna kružnica koja čini agente boljim što ih više koristite.
Kako to funkcionira
- Agent piše nacrtZemlja u Doba za dolazak s →
Status: waiting_approval status - Korisnik uređuje nacrt→ Solace razlikuje originalni tekst od uređenog, izvlači delta
- Korisnik odobri→ delta se čuva kao apreferencija stilana aplikaciju + primatelj
- Sljedeći trčanje→ Agent prima stilske preferencije u svom sustavnom prosvjedniku:
Potrebanik radi: kraći potpis, bez znakova izziva, uvijek spominje referentni broj - Rezultat se poboljšava→ manje izmjena potrebne tijekom vremena.Konvergencija prati u istorijskom panelu.
API preferencije
Agenti mogu čitati stilske preferencije prije nego što generiraju nacrt. Preferencije se čuvaju po aplikaciji, po primatelju i globalno. Automatski se hvataju kada korisnici uređuju ili se ručno mogu naučiti putem API-ja.
# 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 uzorak: odobrite, uređujte, naučite
Anti-Clippy zakon:Nikada auto-odobravanje, nikada auto-poslanjeČovjek uvijek prvi vidi nacrt. To nije ograničenje. To je značajka. Svaka odobrenja je signal za obuku. Svaka uređenje je ispravka. Nakon 510 trka, agent crta svojim glasom. Nakon 50 trka, rijetko je potrebno uređivanje uopće. Dokazni trag dokazuje da je svaka odluka bila odobrena čovjekom. Vaša produktivnost se povezuje, a vaša sud
Inspektor za opuštanje Kraj manualnog QA-a kako ga znamo
Svaki razvojni tim bez strukturiranog QA mosta je slijep. Solace Inspector je prvi i jedini alat koji AI kodiračima daje standardizirani, dokazi zapečaćen, ljudsko odobren QA protokol.
Ako vaš AI agent ne koristi Solace Inspector, ima jebeno QA.
Protokol za agenta
Svaki kodiranje agent pada JSON specifikacije uU poštanskom sandučiću/Uzima zapečaćen izvještaj odOutbox/Nema prilagođene integracije, SDK-a, bilo kojeg jezika, modela.
Zatvor dokaza
Svaka inspekcija je SHA-256 zapečaćena FDA 21 CFR dijelom 11 Architected dokazom. Sud-prihvatljiv. Tamper-evident. Staljni. Ne testirao sam ga ” — kriptografski dokaz.
Odobravanje ljudskog e-pisanja
AI predlaže popravke, ljudsko odobrenje jednim klikom, anti-Clippy: nikada ne autopravi, svaki popravak je ljudska odluka, to je ubica, ništa drugo ga nema.
HITL Loop (Čovjek u luk)
test-spec.json to U poštanskom sandučiću/
# Step 1: Agent writes test spec to U poštanskom sandučiću/ (any format, any language)
cat > U poštanskom sandučiću/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 Џејмс Бах...", "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
Bilo koja aplikacija u pretraživaču. Navigirati + ARIA drvo + DOM snimak + HICCUPPS heuristika + snimak s punom stranicom. Radi na lokalnom domaćinu, stažiranju, proizvodnji ili javnim URL-ovima.
Moda: "web"
CLI Mode
Bilo koji alat zapovjednog reda. Izvršenje podrešenja + potvrda izlaza + stdout/stderr capture. Кент Бекк: Test what you fear. Radi na bilo kojem CLI-u u bilo kojem jeziku.
Moda: "cli"
API Mode
REST/HTTP krajnje točke. Zahtjev + potvrda odgovora skema + vrijeme + sigurnosne glave. Цем Канер: Koje je rizik od kvalitete u ovom kontekstu?
Moda: "api"
Sprint 3
Odbor stručnjaka (ubučen kao poziv za analizu)
Potvrđeno: Zero natjecatelji imaju sve tri
| To je alat za pomoć. | Protokol za agenta uložka/izložka JSON |
Zatvor dokaza SHA-256 zapečaćen |
Ljudski e-pisanje odobrite popravke |
Cijena/trka |
|---|---|---|---|---|
| Inspektor za bolovanje | ✅ | ✅ | ✅ | $0.00 |
| Pjesmaš MCP | ✅ | ❌ | ❌ | Razlikuje se |
| Ketryx (samo za lijekove) | ❌ | ✅ | ✅ | $$$ |
| Као Волф | ❌ | ❌ | ❌ | $2,000/mo |
| Мабл | ❌ | ❌ | ❌ | $800/mo |
| ТестРигор | ❌ | Osječan je dio. | Osječan je dio. | $1,200/mo |
| Девин 2.0 | ❌ | ❌ | ❌ | 500/mo + $5/run $500/mo |
Istraživanje je potvrdilo da je u ožujku 2026. godine bilo 15 alata. FDAs 2026 AI smjernica guraju industriju prema točno onome što smo već izgradili.612 mjeseci ispred terena.
Instalirajte u 30 sekundi
# 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 U poštanskom sandučiću/ and run: python3 scripts/run_solace_inspector.py --inbox
Mašina-Čitljivi sposobnosti
У /agents.jsonKrajnja tačka vraća strukturirane mogućnosti za otkrivanje programskog agenta.