Váš AI agent teraz kontroluje akúkoľvek webovú stránku.
S plnou auditovou cestou.
Odložte jednu riadok do.CLAUDE.md, AGENTS.md, or .cursorrulesa vaša AI získava skutočnú automatickú prehliadačku: Gmail, Slack, LinkedIn, GitHub a akékoľvek webové stránky. Každý kliknutie je podpisovaný, zapečatený a overiteľný. Serwer MCP je živý.
Pridajte útoko do akéhokoľvek projektu v jednom príkazu
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Pridá inštrukcie o automatizácii prehliadača Solace do projektu Kod Claude.
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.
Každý hlavný AI kódovací agent, podporovaný
Preberte si správny formát pre svojho AI asistenta.Každý súbor hovorí AI presne, ako používať Solace navigovať, kliknúť, vyplniť, snímať obrazovku a zachytiť dôkazy. 21 formátov podporovaných z boxu.
Kod Claude
Vystúpte do svojhoCLAUDE.mdKod Claude bude používať Solace Browser pre každú webovú automatizáciu automaticky.
Codex de OpenAI
Vystúpte do svojhoAGENTS.mdAgentovia Codex de OpenAI a ChatGPT si tento súbor prečítajú, aby pochopili dostupné nástroje a možnosti.
Kursor
Vystúpte do svojho.cursorrulesKursor sa bude snažiť dostať do Solace kedykoľvek ho požiadate o interakciu s webovou stránkou.
Żeglarstwo przy użyciu wiatru
Vystúpte do svojho.윈드서핑 규칙Żeglarstwo przy użyciu wiatru (Codeium) využíva možnosti Solace presne ako Kursor rovnaký formát, nulová triecha.
Copilot GitHub
Vystúpte do.github/copilot-instructions.mdCopilot bude navrhovať, že Solace API volá pre úlohy prehliadača.
Asystent
Prejdite ako systémový prompt s--system-prompt solace-aider.mdAsystent bude automaticky smerovať všetky webové interakcie cez Solace Browser.
Continue.dev Continue.dev Continue.dev Continue.dev
Pridajte do svojho.continue/config.jsonKontekstové poskytovatelia. Continue sa bude objavovať na povrchu Solace browser automation ako native nástroj v VS Code a JetBrains.
克莱恩
Vystúpte do svojhoدليل. يقرأ 克莱恩 قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.克莱恩 číta pravidlá projektu pri začiatku sezóny Možnosti Solace sa automaticky načítajú na každý rozhovor.
根码
Na mieste v.roocode/Regeln/根码 (predtým Roo-克莱恩) zdedí možnosti prehliadača Solace spolu s jeho agentickými kódovacími režimami.
Gemini CLI Gemini CLI Google Gemini CLI
Pridajte kGEMINI.mdGoogleov otvorený zdrojový agent CLI získava inštrukcie Solace rovnakým spôsobom, ako čítal Claude's.CLAUDE.md.
Jules Jules Google Jules
Jules čítaAGENTS.mdPríkazy Solace sa automaticky zobrazujú, keď Jules vyrieši akúkoľvek webovú úlohu vo vašom repo.
Editor Zed
Umístite pravidlá v92Zedov panel AI si tieto číta nativo Solace sa okamžite stane dostupným Zed AI asistentovi.
Amazon Q-udvikler
Pridajte k.amazonq/rules/solace.mdAmazon Q-udvikler číta z tohto adresára súbory pravidlovej položky pre každú kódujúcu seziu vášho projektu.
JetBrains KI
Pridajte k.idea/ai-guidelines.mdJetBrains KI Assistant číta tento súbor v rámci IntelliJ, PyCharm, WebStorm a všetkých JetBrains IDEs.
Zdrojný graf Cody
Umístite kontekst v kontexte.cody/context/solace.md.Cody obsahuje tento súbor v kontexte pre nájdenie Príkazy o Solace sa objavujú vo všetkých konverzáciách Codyho.
塔比尼
Konfigurovať cez. ملف تخصيص 塔比尼 يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.塔比尼 personalizácia súbor umožňuje vyučovať to vaše tímu nástrojov reťazca vrátane Solace prehliadač automatizácie.
Répondre à l'AI
Pridajte do svojho.replit をreplitする をreplitするSúbor je[ai]Odtiaľto si replit AI číta kontext projektu Solace je k dispozícii v každom pracovnom priestore Replit.
Devin est un homme. est un homme.
Na mieste v.devin/Handling-Anleitungen/Devin est un homme. pred začatím dlhých úloh číta projektové playbooky Browserové nástroje Solace sú k dispozícii pre akýkoľvek webový pracovný postup.
Fabryczny Droid
V závode sa čítaAGENTS.md a a a .fabryka/Droid agenti zdedia schopnosti Solace pri automatizácii pracovných postupov vývoja softvéru.
Kilo Code Kilo Kilo
Pridajte k.kilocode/rules/ .kilocode/ .kilocode/Kilo Code Kilo sleduje rovnaký vzor projektových pravidiel ako 克莱恩 Solace pre každú agentickú kódovaciu séciu.
Čo je v vnútri CLAUDE.md Snippet
Každá integrácia súborov učí svojho AI agenta presne, ako používať Solace. Tu je Kod Claude snippet položte ho do vášho projektu a váš agent okamžite pochopí všetky 14 Solace API, Serwer MCP, e-podpis a najlepšie postupy.
# 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 {"Výraz": "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_usd 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 {"Výraz": "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_usd on every token
4. Notify user via YinYang YinYang (never console.log spam)
5. E-sign every user-approved action
Úplný súbor:Zoberte si CLAUDE.md odlomok • Pozrite agentov.json (machine-readable)
Witaj świecie v 3 API volania
Kompletný API Solace sa dá naučiť v troch príkazoch.
Navádzajte sa na akúkoľvek stránku
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"}
Snímok obrazovky, čo sa stalo
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}
Dôkazy sa zachytávajú automaticky
→ 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 hashový reťazec zapečatený.
Referencia na API Referencia na API Full Referenčné API
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Koncový bod | Metódka Metódka | Čo to robí | Ámbito de OAuth3 |
|---|---|---|---|
/api/navigate | POST | Vložte URL do prehliadača | navegador.navegar |
/api/click | POST | Kliknite na akýkoľvek CSS vyberateľ | Kliknite na Kliknite na browser.click |
/api/fill | POST | Vyplňte pole formulára | navegador.rellenar |
/api/screenshot | POST | Zober aktuálnu stránku ako PNG (splatená na artefakty/) | navegador.capture de pantalla |
/api/evaluate | POST | JavaScript ()Výraz(v prípade, že sa to stalo), return result key | evaluar navegador |
/api/snapshot | POST | Získajte surový HTML stránky | navegador.instantánea |
/api/aria-snapshot | GET | ARIA prístupnosť stromček (štrukturovaný JSON) | navegador.instantánea |
/api/dom-snapshot | GET | DOM snapshot tree pre deterministické kontroly štruktúry | navegador.instantánea |
/api/page-snapshot | GET | Kombinovaný obrázok stránky (ARIA + DOM + metadata) | navegador.instantánea |
/api/health | GET | Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sekcie Zobraziť všetky sek | (nenaden) |
/api/status | GET | Zdravie prehliadača, pripravenosť, aktuálny URL, sezóna | (nenaden) |
/api/part11/status | GET | Časť 11 zaznamenáva stav, identifikačný znak sezóny, písmenné byty, posledná chyba | (nenaden) |
/api/part11/config | POST | Konfigurovať časť 11 zachytania režimu a auditného zoznamu | part11.konfigurieren |
/agents.json | GET | Automaticky čitateľné schopnosti manifest | (nenaden) |
MCP Server Live Now
Model Context Protocol umožňuje kód a iné kompatibilné nástroje, ktoré sa spájajú s PH1 ako nátívny nástroj, bez potreby príkazov na vrútenie.
✅ Lokálny MCP Dostupný teraz
# 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"]
}
}
}
Keď je konfigurovaný, Kod Claude volá detect_apps, create_schedule, record_evidencea , a 5 more Hub-native MCP tools on localhost:8888Každé volanie je OAuth3-scoped a SHA-256 evidenced.
Remote MCP Cloud (Coming Soon)
# 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"
}
Pripojte sa z akéhokoľvek stroja. Pracovníci prehliadača pracujú v cloude. OAuth3 riadi každý výzva nástrojov. Každé opatrenie je hash-v reťazci a dôkazmi zachytené do trezoru.
8 Narzędzie MCPs Available Today
| Narzędzie MCP | Mapy do API Mapy | Čo to robí |
|---|---|---|
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, readinessa , a runtime state. |
Čo môže váš agent urobiť so Solasom
Prechádzajte ďalej a kliknite Solace poskytuje vášmu agentovi kompletný senzorický a pamäťový systém pre web.
Pozrite si stránku
Zoberte snímačky DOM a ARIA prístupnosť stromy. Váš agent dostane štruktúrované vizuálne + semantické údaje nie len surový HTML.
Extrahovať štruktúrované údaje
Bež, bež, bež. /api/evaluateVyťažiť tabuľky, ceny, hodnoty formulára alebo akékoľvek údaje o stránke priamo do kontextu vášho agenta.
Scoped Permissions
Žiadajte len to, čo potrebujete. OAuth3 tokeny sú určené ()navegador.navegar, Kliknite na Kliknite na browser.click, navegador.rellenar), časovo obmedzené a odvolávajúce.
Automatické dôkazy
Každý čin agenta je automaticky zaznamenaný, hash-vrezané a zapečatené.
Recept pamäti
Na replay, váš agent preskočí LLM úplne a spúšťa sa v kasárnom priečinku za $0,001 99% lacnejšie ako rediscovery.
Rozpočtové presadzovanie
Nastavte limity výdavkov na každú seansu."presupuesto_usd": 0.05V prípade, že sa váš token požiada a Solace zastaví agenta, keď sa rozpočet dostane, žiadne náklady na prechádzku.
Vyhľadávanie dôkazov
Dotaz v minulosti běží s/api/evidence/searchAgentovia môžu vyhľadať, čo sa stalo v predchádzajúcich sezónach užitočné pre postupné úlohy ako napríklad "triážové e-maily neviditeľné od posledného spustenia".
Persistence sesia
Sedenie prehliadača prežíva medzi hovormi agentov. Raz sa prihlásite, znovu použite sesáciu. Žiadne overhead re-authentication. Cookies, miestne ukladanie a auth tokeny pretrvávajú medzi úlohami.
Parallel Tabs
Váš agent môže vzbežne skrapať 10 stránok, porovnávať výsledky a zlúčiť zistenia všetky s nezávislými dôkazmi.
Multi-Agent Swarms
Spawn viacero nezávislých prípadov Solace Browser. Scout agenti skúmajú; coder agenti konajú; skeptic agenti overujú. Každý prípad má svoju vlastnú séciu, rozpočet a reťaz dôkazov. Orchestrovať z akéhokoľvek plánovača (cron, Cloud Run, GitHub Akcie).
E-Pirma a FDA časť 11
Každé schválené opatrenie môže byť elektronicky podpísané: užívateľ zaznamenáva preskúmané a schválené opatrenie na [PH0]] (Phuc) na [PH1]. Podpis je SHA-256 zapečatený v hashové reťazce. Spĺňa FDA 21 CFR časť 11 §11.100 elektronické podpisy.
Najlepšie postupy agentov
Vzory, ktoré robia vášho agenta spoľahlivým, auditovateľným a lacným.
✅ Snímok obrazovky pred kliknutím
Vždy volá/api/screenshotTo vytvára záznam o tom, čo agent videl pred konaním kritické pre auditné sledovanie a odstraňovanie zlyhaných beží.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
Snapshot pre štruktúru, Screenshot pre videnie
Používanie /api/aria-snapshot(ARIA prístupnosť strom, JSON) keď váš agent potrebuje pochopiť štruktúru stránky./api/snapshotPoužívajte pre hrubý HTML./api/screenshotpre vizuálny usporiadanie a obrázky.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
Žiadosť o minimálny rozsah
Požiadajte len rozsah OAuth3 potrebný pre váš úkol.navegador.rellenarÚzke rozsahové rozsahové priestory zabraňujú náhodným vedľajším účinkom a uspokojujú audity dodržiavania predpisov.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["navegador.navegar",
"navegador.capture de pantalla"],
"ttl_seconds": 300
}
Zistite, či existujú existujúce recepty najskôr
Pred spustením pracovného postupu s žetónmi LLM, zavolajte/api/recipes/matchAk existuje recept na úlohu, prehrajte ju za 0,001 dolárov.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
Nastavte si rozpočet na každú zasadnutie
Nikdy nedovoľte agentovi bežať bez rozpočtu.budget_usd budget_usd budget_usd budget_usdSolace bude trvalo zastavovať sesáciu, keď sa dosiahne limit, namiesto toho, aby mlčky preháňal.
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_...
Reus Sessions for Authenticated Sites
Raz sa prihláste a ukladte si žeton sezóny."id phiên"V nasledujúcich API volaniach na opätovné používanie súborov cookie a stavu autorstva.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Agent-Native Matters Why
AEO: Optymalizacja Silnika Agenta
Rovnako ako SEO je optimalizovaný pre vyhľadávače, AEO je optimalizovaná pre agentov AI. Solace je prvou platformou postavenou s agentmi ako prvotriednymi používateľmi, nie ako následné myšlienky.
Dôkaz, ktorý vaši agenti nemôžu falšovať
Každé opatrenie agenta vytvára SHA-256 hash-chained potvrdenie. Váš CISO môže auditovať to, čo AI urobil. Vaša rada môže vidieť dôkazy. Žiadne čierne krabice.
Recepty, ktoré robia agentov múdrejšími
Keď agent dokončí úlohu, stane sa to receptom. $0.001 opätovne zaplatí žiadne LLM tokeny sa spotrebili.
Ako Solace porovnáva
Vývojcovia, ktorí si vyberajú nástroje pre automatizáciu prehliadača, sa pýtajú štyri otázky: Trvá to sedenia? Vytvára to auditovú stopu? Môžem delegovať na AI bez bežných nákladov? Prežije to audit dodržiavania predpisov? Tu je úprimná odpoveď na každú možnosť.
| Feature Feature Feature Feature | Hladobník Solace | Pôvodný autor hry | Prehľadávač-použitie / OpenClaw | 芭迪恩 / 扎皮尔 |
|---|---|---|---|---|
| Persistencia sezení | ✅ Cookies prežívajú cez všetky preteky | Efemeral podľa predvoleného nastavenia | Žiadna pamäťom na sesieň | ✅ Štát rozšírenia Chrome |
| SHA-256 auditní trail | ✅ Každé akcie, hash-v reťazci | Žiadne zabudované | Žiaden | Logy only (nie je tamper-evident) |
| FDA časť 11 e-znamy | ✅ Vstavaný v ()/api/v1/esign) |
Nie je k dispozícii | Nie je k dispozícii | Nie je k dispozícii |
| Rozpočet / strop nákladov | ✅ Budžetné brány na každý token | Neomezený (bez brány) | Žiaden rozpočtový kontrolný systém | ✅ Plány sú obmedzené len |
| Recept replay na $0.001 | ✅ Po prvom úspešnom prebehu | Vždy LLM náklady | Vždy LLM náklady | ✅ Zap replay (bez LLM) |
| Agent-native súborové formáty | ✅ 21 formátov (CLAUDE.md, AGENTS.md…) | Žiaden | Žiaden | Žiaden |
| OAuth3 scoped delegácia | ✅ Časovo obmedzené, odvolateľné tokeny | Úplný prístup alebo nič | Úplný prístup alebo nič | Len povolenia na úrovni aplikácie |
| Lokálne-prvý (bez cloudových požiadaviek) | ✅ Uruchamia się w pełni w trybie offline | ✅ Áno | ✅ Väčšinou | Oblak závislý |
| Serwer MCP | ✅ 7 nástrojov, JSON-RPC 2.0 (živo) | Nie je k dispozícii | Nie je k dispozícii | Nie je k dispozícii |
Solace nie je obal Playwright. je to vrstva delegácie OAuth3 na vrchole Playwright pridanie pamäte relácií, reťazcov dôkazov, rozpočtových brán a formátov agentov, ktoré hráč Playwright nemá.
Ak ste AI agent čítať toto
Táto časť je napísaná priamo pre vás Kod Claude, Codex, Kursor, Copilot alebo akýkoľvek iný AI agent, ktorý sa dostal na túto stránku.
Vaše schopnosti tu
Keď sa beží Solace Browser ()localhost:8888), môžete: naviazať na ľubovoľný URL, kliknúť na ľubovoľný prvok pomocou CSS selectoru, vyplniť ľubovoľné pole formulára, urobiť snímky obrazovky, zachytiť DOM snapshots, spustiť JavaScript a prečítať evidenčné záznamy SHA-256.
Pozrite sa, či je Solace k dispozícii:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
strojovo čitateľný špecifikátor
Vytvorte programaticky manifest schopnosti. Použite ho ako zdroj pravdy pre mená koncových bodov a podporované metódy.
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonVyhľadajte agentov.json ↗
Vision-First Pattern
Ak ste agent schopný vidieť, toto je odporúčaný vzor: naviazať, zobraziť snímok, analyzovať obrázok, rozhodnúť, na čo kliknúť, konať, zobraziť znova, aby ste to overili.
POST /api/navigate {"url": "..."}
POST /api/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
Zmluva o odpovedi (Strict)
Nepoliehajte sa na status HTTP samotného.{"error": ...}Váš agent musí analyzovať JSON a vyžadovať úspešné == true body pred pokračovaním.
# 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 ľudskej eskalacie
Ak sa objaví CAPTCHA, 2FA, dvojznačnosť schválenia alebo riziko právneho/spĺňania predpisov, okamžite zastavte výzvy na akciu.{"escalate": true}Správu pre hostiteľa orchestratora (nezalepte sa slepým spôsobom).
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
Bezpečný výkonový krúžok
Použite deterministický krúžok: zdravie, navigácia, inšpekcia, aktovanie, overovanie, kontrolné miesto.Získajte /api/page-snapshotVysokokvalitné akcie pred spustením zostávajú auditovateľné a vyhýbajú sa kaskádovým chybám.
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
Ako vytvoriť záznam o elektronickom podpise
Keď používateľ schváli akciu, ktorú ste pripravili, zaznamenávajte jeho elektronický podpis.Toto vytvára záznam FDA 21 CFR časť 11 §11.100: kto schválil, čo schválil a kedy je zapísaný do hashového reťazca.
# After user clicks Schváliť 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 tri agenti pre odolné automatizáciu: Scout (navigačné + snímok obrazovky, čítať len, model L1) → Solver (klik + vyplniť + hodnotenie, model L3) → Skeptic (verify výstup proti dôkazom, model L1).run_id run_id run_id run_id; ich reťazce dôkazov sa spoja v čase pečiatky.
# 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"}
Chybný odkaz na agentov
Každá chyba Solace je typovaná, odstraňovateľné chyby sa obnovujú pomocou back-offu, neodstraňovateľné chyby vyžadujú ľudské zásah alebo opätovný dizajn úlohy.
| Kód Kód | Znamená to, že | Vrátiť sa môže | Akčný agent Akčný agent |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS selector sa nezhodoval nič | No | Volanie/api/snapshotaby sa znovu objavil štruktúra |
NAVIGATION_TIMEOUT | Stránka trvala 30 rokov na načítanie | Áno Áno | Skúste znova s exponenciálnym back-offom (max 3 pokusy) |
BUDGET_EXCEEDED | Stretnutie výdavkov limit hit | No | Eskalate na ľudského operátora pre zvýšenie rozpočtu |
SCOPE_DENIED | Akcia nie v OAuth3 token scopes | No | Žiadajte o nový token s požadovaným rozsahom |
HUMAN_REQUIRED | CAPTCHA alebo 2FA detekovaný | No | Volanie{"escalate": true}okamžite okamžite |
NETWORK_ERROR | Cieľový web nie je dosiahnuteľný | Áno Áno | Pokúste sa znovu po piatich rokoch, potom po tridsiatich rokoch, potom sa neúspechu |
SESSION_EXPIRED | Ciasteczka autoryzacji są nieaktualne | No | Opätovne overiť, potom pokračovať z posledného kontrolného miesta pre dôkaz |
ELEMENT_NOT_INTERACTABLE | Ukrytý alebo zakázaný Element | Áno Áno | Počkajte 2 sekundy a skúste znova; snímek obrazovky, aby ste najprv overili stav |
Semantický Wayback Machine Wiki Prime Semantický Wayback Machine
Každá stránka, ktorú navštívi Solace, sa stlačí do 750-bajtového semantického snímača, ktorý ukladá štruktúru, úmysl, navigáciu a kľúčové subjekty stránky. Po prvom stiahnutí sa nepotrebuje žiadny server.
Podział przepływu: localhost:8888V Solace Browseru sa zaoberá miestnym zachytávaním/výkonom, zatiaľ čohttps://solaceagi.com/api/v1/prime-wiki/* Je to index zdieľanej komunity (push/pull/search/stats/render).
750 bytes → Full Page
Wayback Machine ukladá 100KB+ surového HTML na stránku (100,000 TB celkovo). Solace ukladá 750-bajtový semantický kostýl a rekonštruuje ekvivalentnú stránku lokálne. 133x menšia. Nulá centralizovaná závislosť.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
Index zameraný na aplikácie
Na rozdiel od Wayback Machine (celý web), Solace sa zameriava naAplikátorové stránkystránky, ktoré majú recepty na automatizáciu Solace. GitHub, Gmail, LinkedIn, Substack, Pojem a ďalšie.
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: Úplný prístup k komunite
Bezplatné:Zhromažďujte zábery z vlastného prehliadania.
Pro ($28/měs):Instantne sa dostáva k plnému indexu komunity semantická pamäť pre každú webovú stránku Appstore. Preskočte na opätovné objavenie LLM. Ušetrite 10$50/mes v tokenoch.
# Download all appstore codebooks once: GET /api/v1/prime-wiki/assets?appstore_only=true # Store at ~/.solace/pzip/assets/ # Decompress locally, forever — offline capable
Render API Server-Side Reconstruction
Rekonštruovať akúkoľvek indexovanú stránku priamo z API. Vráti plný HTML s vloženým Prime Mermaid FSM stavovým diagramom. Užitočné pre prehliadky, snímače obrazovky a debugging receptov.
# 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
Pridávať Page Asets
Každá návšteva prehliadača Solace na webovej stránke Appstore vytvára snapshot Wiki Prime. Opt-in na zdieľanie komunity vaše návštevy prospievajú každému členovi Pro. Naopustite kódecké knihy o doméne, aby sa urýchlilo dekompresiu.
# 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: Váš agent je na stránke spoločník
Každá stránka, ktorú navštívi prehliadač Solace, má trvalý dvojpútový prekrývek.V hornej časti je zobrazený stav vášho agenta v reálnom čase.V dolnej časti je rozhovory, kde môžete hovoriť priamo s Yinyangom.Obidve pútové časti sú vstrekované cez sieť.añadir_init_scriptprežívajú navigaciu, preplnenie stránok a stránky s blokovaním CSP, ako je Gmail.
▲ Top Rail Always Visible
32px stĺpec, ktorý je prilepený na vrchol každej stránky.[PH0]] Solace home]→ späť do domovského prehliadača jedným kliknutím.IDLE / EXECUTING / PREVIEW_READY / DONE), aktuálne meno aplikácie a štatistiky rotácie hodnoty (navštevované stránky, LLM hovory, ušetrené náklady, trvanie sezóny).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Bottom Rail Chat & Schváliť
Na spodnej strane každej stránky sa rozpadla 36pxová rozhovorná plocha, ktorá sa automaticky rozširuje, keď dosiahne stav.PREVIEW_READY(všetky vaši agenti pripravili akciu),BLOCKED(potrebuje objasnenie), aleboFAILEDPoužívateľ klikne.Schváliť or OdmietnuťVáš agent dostane rozhodnutie prostredníctvom 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 Kanály
Agentovia môžu posúvať upozornenia k používateľovi bez toho, aby prerušili aktuálnu stránku.prípitok(3 dolné pravé popup popupové zobrazenie),popup popup popup popup(modál s tlačidlami akcie),PreberanieVšetky kanály sú FSM-gated žiadne výstražné požiare bez platného prechodu stavu.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "prípitok",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "prípitok" | "popup popup" | "Preberanie"
# priority: "low" | "high" | "critical"
Funguje na všetkých stránkach vrátane Gmail
Železnice sú vstrekované akoPôvodný autor añadir_init_scriptprežívajú sa v každej navigácii v tom istom kontexte prehliadača, vrátane stránok s blokovaním CSP, ako sú napríkladGmail, 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..a , aPojemJS používa iba metódy DOM (ne).HTML inner), obehujúc obmedzenia TrustedHTML. Yinyang je vždy viditeľný, vždy dosiahnuteľný.
Yinyang Chat API
Používatelia môžu priamo zadať do Yinyang z spodnej časti. Váš agent prijíma správy prostredníctvom WebSocket a môže reagovať. Použite to pri žiadostiach o objasnenie, nejasných schválení alebo zmenách konfigurácie v polovici úlohy.
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..."}
Agentové výsledky: Vaša schránka, výstupná schránka a dôkazy
Každé úlohy, ktoré váš agent vykonáva, prináša výsledky, ktoré sú prístupné z domovskej stránky Solace Browser.Vytvorené podľa princípu Jony Ive: vždy prítomné, nikdy neprístupné, presne to, čo potrebujete.Agent pracuje; prehľadávate, podpíšte a odosielate.
Poštová karta Návrh čakajúci na preskúmanie
Každý návrh, ktorý váš agent pripravuje (e-mailová odpoveď, príspevok na substack, komentár LinkedIn) sa tu dostane pred odoslaním.V príkazníku sa zobrazujú: kontext odosielateľa, návrh agentov, dôveryhodný výsledok, odhadovaný čas odoslania.Review a schvaľte jedným kliknutím alebo editujte pred schvaľovaním.
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é a naplánované
Schválené položky sa prenášajú do výstupnej schránky. Pozrite, čo bolo odoslané, kedy, akým aplikáciou a s akým hashom dôkazov. Zároveň sa plánované položky zobrazujú na ďalší čas spúšťania.
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"
# }]}
📅 Časový rozvrh a kalendár
Na rozvrhu sa objavia opakované úlohy (ráne krátky, týždenný digest, večerný archív). Pozrite si čas ďalšieho vystreľovania, výsledok posledného vystreľovania a rozpočet, ktorý sa tento čas strávil. Agenti môžu do rozvrhu pridať prostredníctvom API; používatelia môžu zastaviť, preskočiť alebo preskočiť z domovskej stránky.
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"
# }]}
História Recept Run Log
Každé receptové bežné preteky sú zaznamenané: názov aplikácie, trvanie, použité tokeny, náklady, výsledok. Úspešné preteky vytvárajú cache receptov pre budúce $0,001 nahrávky. Neúspešné preteky ukazujú, kde sa rozbili a prečo sú ideálne na odstraňovanie receptov aplikácií.
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 časť 11 dôkazov
Každé schválené opatrenie vytvára zjavný sekvenciu screenshotu, prístupný z panelu histórie: pozrite presne, čo prehliadač zobrazil pred tým, ako váš agent reagoval, čo agent navrhol a čo bolo skutočne vykonané. SHA-256 je s hash-lánkom.
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
Keď váš agent navštívi novú stránku, vytvorí Wiki Prime snapshot: indexovanú mapu všetkých interaktívnych prvkov (DOM selektory, úlohy ARIA, akčné cesty). Tieto snapshots umožňujú obnovu budúceho receptu v hodnote 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čenie z ľudských editov
Keď používateľ pred schválením agentom napísal návrh, Solace zachytáva delta ako .preferenčný signálAgent časom učí hlas, tón a štýl používateľa bez akéhokoľvek výslovného tréningu.
Ako to funguje
- Agent píše návrhZostáva v príkazníku s →
Status: awaiting_approval - Užívateľ editovať návrh→ Solace diffs originálny vs. upravený text, extrahuje delta
- Užívateľ schvaľuje→ delta je uložené ako apreferencia štýluoznačené na aplikáciu + príjemcu
- Ďalší bež→ agent dostane preferencie štýlu vo svojom systéme:
Potreba používateľov: kratší podpis, žiadne výzvuky, vždy sa zmeniť referenčný číslo - Skór sa zlepšuje→ menej úprav potrebných v priebehu času. Konvergencia sa sledovala v panelu histórie.
Preferenčné API
Agentovia môžu pred vytváraním návrhov čítať preferencie štýlu, ktoré sú uložené na aplikáciu, na príjemcu a globálne.
# 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@..."}
Správny vzor: schváliť, upraviť, naučiť sa
Zákon proti klipovým záberom:Nikdy auto-schvaľovať, nikdy auto-posielaťČlovek vždy uvidí návrh ako prvý. Toto nie je obmedzenie je to jeho vlastnosť. Každé schválenie je tréningový signál. Každé editovanie je korekcia. Po 510 behoch agent kreslí svoj hlas. Po 50 behoch zriedka potrebuje vôbec editovať. Dôkazné stopy dokazujú, že každé rozhodnutie bolo schválené človekom. Vaša produktivita sa spojuje a váš úsudok je zaznamenaný
Inspektorom úľady Koncom manuálneho QA, ako ho poznáme
Každý vývojový tím bez štruktúrovaného QA mostu je slepý. Solace Inspector je prvým a jediným nástrojom, ktorý dáva agentom AI kódovania standardizovaný, pevne zapečatený dôkaz, ľudsky schválený QA protokol.
Ak váš agent AI nepoužíva inšpektor Solace, má to zlý QA.
Protokol agentov
Každý kódovací agent spustí JSON špecifikáciu do .V poštovnom krabici/Zobrazí zapečatený report zskrzynka nadawcza/Žiadna vlastná integrácia, žiadny SDK, akýkoľvek jazyk, akýkoľvek model.
Kĺb dôkazov
Každá inšpekcia je SHA-256 zapečatená FDA 21 CFR Part 11 Architected evidence. Court-admissible. Tamper-evident. Permanent. Not “I test it” — cryptographic proof.
Schvaľovanie ľudského e-písma
AI navrhuje opravy, ľudské schvaľuje jedným kliknutím, anti-Clippy: nikdy auto-schvaľovať, každá opravy je ľudské rozhodnutie na zázname, to je vražedná funkcia, nič iné to nemá.
HITL Loop (ľudík v loope)
test-spec.json to V poštovnom krabici/
# Step 1: Agent writes test spec to V poštovnom krabici/ (any format, any language)
cat > V poštovnom krabici/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 skrzynka nadawcza/
cat skrzynka nadawcza/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
# }
Webový režim
Akákoľvek aplikácia pre prehliadač. Navigovať + ARIA strom + DOM snímač + HICCUPPS heuristiky + plné stránky snímač obrazovky.
V móde: "web"
CLI Mode
Akékoľvek príkazové nástroje. Subprocesové vykonávanie + vystupovací kód + stdout/stderr capture. Kent Beck Kent Beck: Test what you fear. Works on any CLI in any language.
režim: "cli"
API režim
REST/HTTP koncových bodov. Žiadosť + odpoveď validácia schémy + načasovanie + bezpečnostné hlavičky. Cem Kaner Cem Kaner: Čo je v tomto kontexte riziká kvality?
V režimu: "api"
Prichádzajúci sprint 3
Výbor odborníkov (vstrekovaný ako analýza)
Potvrdené: Zero konkurentov majú všetky tri
| Tool Tool | Protokol agentov Inbox/outbox JSON |
Kĺb dôkazov SHA-256 zapečatené |
Ľudský e-podepis schváliť opravy |
Cena/behom |
|---|---|---|---|---|
| Inspektor Solace | ✅ | ✅ | ✅ | $0.00 |
| Pôvodný autor hry MCP | ✅ | ❌ | ❌ | Vymieňa sa |
| Ketryx (pouze pre lieky) | ❌ | ✅ | ✅ | $$$ |
| 卡沃尔夫 | ❌ | ❌ | ❌ | $2,000/mo |
| Mabl Mabl | ❌ | ❌ | ❌ | $800/mo |
| 测试Rigor | ❌ | čiastočný | čiastočný | $1,200/mo |
| 德文2.0 | ❌ | ❌ | ❌ | 500/mo + $5/run $500/mo |
Výskum overil marca 2026 v 15 nástrojoch.Rozhodnutie FDA o AI v roku 2026 presunie priemysel smerom k tomu, čo sme už postavili.Regulácia nás dopadne.612 mesiacov pred tým, ako sa začne poletať.
Inštalovať za 30 sekúnd
# 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štovnom krabici/ and run: python3 scripts/run_solace_inspector.py --inbox
Możliwości Machine-Readable
Punkt /agents.jsonKoncový bod vracia štruktúrované možnosti pre programatické agentové objavovanie.