Din AI agent kontrollerer nu ethvert websted.
Med en fuld audit trail.
Drop en linje ind iCLAUDE.md, AGENTS.md, or .cursorrulesog din AI får reel browser automatisering: Gmail, Slack, LinkedIn, GitHub og enhver anden hjemmeside. Hvert klik er underskrevet, forseglet og verificerbar. MCP-serverenen er live. Skiber om 30 sekunder.
Tilføj trøst til ethvert projekt i ét kommando
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Solace tilføjer browser automatisering instruktioner til dit Código Claude 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.
Alle store AI kodingsagenter, støttet
Download det rigtige format til din AI assistent. Hver fil fortæller AI præcis, hvordan man bruger Solace navigere, klikke, udfylde, tage et skærmbillede og fange bevismateriale. 21 formater understøttes ud af boksen.
Código Claude
Drop ind i dinCLAUDE.mdCódigo Claude vil automatisk bruge Solace Browser til enhver webautomation opgave.
Codex de OpenAI
Drop ind i dinAGENTS.mdCodex de OpenAI og ChatGPT-agenter læser denne fil for at forstå de tilgængelige værktøjer og muligheder.
Mauszeiger
Drop ind i din.cursorrulesMauszeiger vil nå til Solace, når du beder det om at interagere med et websted.
Windsurfenen
Drop ind i din.윈드서핑 규칙Windsurfen (Codeium) optager Solace's funktioner præcis som Mauszeiger samme format, nul friktion.
Copilot på GitHub
Drop ind i.github/copilot-instructions.mdCopilot vil foreslå Solace API opkald til browser opgaver.
Hjælper
Pass som et systemprompt med--system-prompt solace-aider.mdHjælper vil automatisk vejlede alle webinteraktioner gennem Solace Browser.
Weiterentwickeln.dev
Tilføj til din.continue/config.jsonContinues kommer til at fremstå som Solace browser automatisering som et nativt værktøj i VS Code og JetBrains.
克莱恩
Drop ind i dinدليل. يقرأ 克莱恩 قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.克莱恩 læser projektreglerne ved sessionstart Solace-funktioner lastes automatisk for hver samtale.
根码
Placer i stedet for.roocode/Regeln/根码 (tidligere Roo-克莱恩) arver Solace browserfunktioner sammen med sine agentic kodingstilstande.
Gemini CLI:n är en av Googles mest populära.
Tilføj tilGEMINI.mdGoogles open-source-agent CLI optager Solace-anvisninger på samme måde som det læser ClaudsCLAUDE.md.
Jules Jules Google Jules
Jules læserAGENTS.mdSolace-anvisninger vises automatisk, når Jules håndterer en web-relateret opgave i dit repo.
Redaktør Zed
Placerer regler i92Zed's AI-panel læser disse indfødt Solace bliver tilgængelig for Zed AI-assistenten øjeblikkeligt.
Amazon Q-udvikler
Tilføj til.amazonq/rules/solace.mdAmazon Q-udvikler læser markdown-regler fra dette katalog for hver kodningssession i dit projekt.
JetBrains KI
Tilføj til.idea/ai-guidelines.mdJetBrains KI Assistant læser denne fil på tværs af IntelliJ, PyCharm, WebStorm og alle JetBrains IDEs.
O fonte de dados Cody
Placerer kontekst i kontekst.cody/context/solace.md.Cody indeholder denne fil i sin optagelses kontekst Solace-anvisninger vises i hver Cody-samtale.
塔比尼
Konfigurere via. ملف تخصيص 塔比尼 يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.塔比尼's personaliseringsfil giver dig mulighed for at lære det dit teams værktøjsliste, herunder Solace browser automatisering.
Répondre à l'AI
Tilføj til din.replit をreplitする をreplitするFilen er i gang.[ai]Répondre à l'AI læser projektkontext herfra Solace bliver tilgængelig i hvert Replit workspace.
Devin est un homme. est un homme.
Placer i stedet for.devin/Handling-Anleitungen/Devin est un homme. læser projektplayafonden før han starter lange opgaver Solace browserværktøjer er tilgængelige for enhver web-workflow.
Fabrikdroid
Fabrikken læserAGENTS.md Og og og og .fabrik/Droid agenter arver Solace's funktioner, når de automatiserer softwareudviklingsworkflows.
Kilo Code Kilo Kilo
Tilføj til.kilocode/rules/ . .Kilo Code Kilo følger det samme projektregler mønster som 克莱恩 Solace instruktionslast for hver agentisk kodning session.
llms.txt
Jeremy Howard standard for LLM-læselige websteder beskrivelser. Drop i din projekt rod for enhver LLM for at forstå Solace.
Download llms.txtWhat’s Inside the CLAUDE.md Snippet
Hver integrationsfil lærer din AI-agent præcis, hvordan man bruger Solace. her er Código Claude-snippet og drop den i dit projekt, og din agent forstår straks alle 14 Solace API'er, MCP-serveren, e-underskrivning og bedste praksis.
# 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 {"udtryk for udtryk": "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 {"udtryk for udtryk": "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
Full fil:Download CLAUDE.md snippet[PH0]]• Se agents.json (maskine-læselig)
Hallo Welt i 3 API-opkald
Den komplette Solace API kan læres i tre kommandoer.
Navigere til enhver side
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"}
Et skærmbillede af, hvad der skete
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}
Bevis er automatisk optaget
→ 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-kæde sigileret.
Reference API Reference API Full Reference API
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Endpunkt | Metoden er en metode. | Hvad gør det | Ámbito de OAuth3 |
|---|---|---|---|
/api/navigate | POST | Lade en URL i din browser | navegador.navegar |
/api/click | POST | Klik på enhver CSS-udvælgelsesprøve | navegador.hacer clic |
/api/fill | POST | Fyll et formularfelt i | navegador.rellenar |
/api/screenshot | POST | Færd den nuværende side som PNG (saved to artifacts/) | navegador.capture de pantalla |
/api/evaluate | POST | JavaScript ()udtryk for udtryk), returresultat nøgle | evaluar navegador |
/api/snapshot | POST | Få fat i rå HTML af en side | navegador.instantánea |
/api/aria-snapshot | GET | ARIA-tilgængelighedstræet (struktureret JSON) | navegador.instantánea |
/api/dom-snapshot | GET | DOM snapshot træ for deterministiske strukturkontroller | navegador.instantánea |
/api/page-snapshot | GET | Kombineret side snapshot (ARIA + DOM + metadata) | navegador.instantánea |
/api/health | GET | Liveness-sonde for løbstedsberedskab | (ingen) |
/api/status | GET | Browser sundhed, readiness, nuværende URL, session | (ingen) |
/api/part11/status | GET | Del 11 fangst tilstand, session id, bytes skrevet, sidste fejl | (ingen) |
/api/part11/config | POST | Konfigurere del 11 indfanger-modus og auditregister | part11.configure part11.configure part11.configure part11.configure |
/agents.json | GET | Maskinlæselige evner manifesteres | (ingen) |
MCP Server Live Now
Model Context Protocol giver mulighed for at kode og andre PH3-kompatible værktøjer kan oprette forbindelse til PH1 som et nativt værktøj uden curl-kommandoer.
✅ Local MCP Available Now
# Step 1: start the MCP-serveren (stdio JSON-RPC 2.0)
python3 ~/projects/solace-browser/yinyang_mcp_server.py
# Step 2: add to Código Claude .claude/settings.json:
{
"mcpServers": {
"solace": {
"command": "python3",
"args": ["/path/to/solace-browser/yinyang_mcp_server.py"]
}
}
}
Når det er konfigureret, kalder Código Claude. detect_apps, create_schedule, record_evidenceog , og 5 more Hub-native MCP tools on localhost:8888Hver opkald er OAuth3-scoped og SHA-256 evidenteret.
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"
}
Connect fra enhver maskine. Browserarbejdere kører i skyen. OAuth3 styrer hvert værktøj opkald. Hver handling hash-kæde og bevis-fået til din skytte. Dragon Warrior tier kræves.
8 MCP-Tools Available Today
| MCP-Tool | Mapper til API | Hvad gør det |
|---|---|---|
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, readinessog , og runtime state. |
Hvad din agent kan gøre med Solace
Beyond navigere og klikke Solace giver din agent et fuldt sensorisk og hukommelsessystem til internettet.
Se siden
Få DOM-snapshots og ARIA-tilgængelighedstræer. Din agent får strukturerede visuelle + semantiske data ikke kun rå HTML.
Udvind strukturerede data
Løbe og løbe /api/evaluateUdvælg tabeller, priser, formularværdier eller andre sideoplysninger direkte i din agents kontekst.
Scoped Permissions
Anmod kun det, du har brug for. OAuth3-tokens er udvalgt ().navegador.navegar, navegador.hacer clic, navegador.rellenar), tidsbegrænset og genkaldelig.
Automatic Evidence
Hver agent handling logges automatisk, hash-kædes og forseglet, og din agent producerer et audit trail uden at skrive en eneste linje logging kode.
Opskrift på hukommelse
På gentagelse skifter din agent LLM helt og kører cachéen for $0.001 99% billigere end genopdagelse.
Budget håndhævelse
Sæt bud på udgifter per session."presupuesto_usd": 0.05I din token anmodning og Solace holder agentens arbejde fast, når budgettet er ramt uden løbende omkostninger.
Bevis søgning
Query past kører med/api/evidence/search. Agenter kan se efter, hvad der skete i tidligere sessioner nyttigt for øgede opgaver som "trierage e-mails ikke set siden sidste run".
Session Persistence
Browsersessioner overlever mellem agentopkald. Logge ind én gang, genbrug sessionen. Ingen gen-authentication overhead. Cookies, lokallagring og auth-tokens forbliver på tværs af opgaver.
Parallelstabs
Din agent kan skrabe 10 sider parallelt, sammenligne resultater og sammensætte resultater med uafhængige beviser.
Multi-Agent Swarms
Spawn flere uafhængige Solace Browser-eksempler. Scout agenter udforske; coder agenter handle; skeptiske agenter verificere. Hver instance har sin egen session, budget og bevis kæde. Orchestrere fra enhver planlægger (cron, Cloud Run, GitHub Actions).
E-Sign & FDA Part 11
Hver godkendt handling kan e-signeres: brugeren registrerer en gennemgået og godkendt handling på [PH0]] (Phuc) på [PH1]. Signaturen er SHA-256 forseglet i hashkæden.
Agent best practices Agent best practices
Mønstre, der gør din agent pålidelig, auditable og billig at køre.
✅ Skærmbillede før du klikker
Altid ring/api/screenshotDette skaber en evidensregistret over, hvad agentten så før han handlede kritisk for audit trails og debugning af mislykkede løb.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
Snapshot for struktur, Screenshot for vision
Brug /api/aria-snapshot(ARIA-tilgængelighedstræet, JSON) når din agent skal forstå sidestrukturen./api/snapshotBrug for rå HTML./api/screenshottil visuel layout og billeder.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
Anmodning af minimumsområder
En læse-kun forskningsopgave bør aldrig havenavegador.rellenarSmalte rammer forhindrer utilsigtede bivirkninger og tilfredsstiller compliance-auditer.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["navegador.navegar",
"navegador.capture de pantalla"],
"ttl_seconds": 300
}
Tjek for eksisterende opskrifter først
Før du kører en workflow med LLM-tokens, skal du ringe til mig./api/recipes/matchHvis der findes en opskrift til opgaven, skal du spille den igen til $0.001.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
Sæt et budget på hver session
Lad aldrig en agent køre uden et budgetloft.budget_usd budget budgetSolace vil stoppe sessionen, når grænsen er nået, snarere end at stilleligt overudlede.
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_...
Gennemføre genbrugssessioner for autentificerede websteder
Log ind én gang og gem session-tokenen."id phiên"I efterfølgende API opkald til genbrug af cookies og auth-stat.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Agent-Native Matters Why
AEO: Agent-Engine-Optimierung
Ligesom SEO er optimeret for søgekrawlere, optimerer AEO også AI-agenter. Solace er den første platform, der er bygget med agenter som førsteklasses brugere, ikke som eftertænkning.
Bevis din agent kan ikke falskgøre
Hver agent handling producerer en SHA-256 hash-kæde kvittering din CISO kan tjekke, hvad AI gjorde din bestyrelse kan se beviserne ingen sorte kasser
Recipes, der gør agenter klogere
Når en agent fuldfører en opgave, bliver den til en opskrift. Næste gang: $0.001 genspille ingen LLM-tokens forbrugt.
Hvordan Solace sammenligner
Udviklere, der vælger browserautomation værktøjer, stiller fire spørgsmål: Er det vedvarende sessioner? skaber det en audit trail? Kan jeg delege til en AI uden løbende omkostninger? overlever den en compliance audit? Her er det ærlige svar til hver mulighed.
| Feature Feature Feature Feature | Browseren er Solace Browser | Playwright direkt | Browser-use / OpenClaw | 芭迪恩 / 扎皮尔 |
|---|---|---|---|---|
| Sessionspersistens | ✅ Cookies overlever gennem løb | Efemeral ved standard | Ingen session hukommelse | ✅ Chrome-udvidelsestilstand |
| SHA-256 Prüfungspfad | ✅ Hver handling, hash-kædet | Ingen indbyggede | Ingen af dem. | Logs only (ikke manipuleret) |
| FDA del 11 e-sign | ✅ Built in ())/api/v1/esign) |
Ikke tilgængelig | Ikke tilgængelig | Ikke tilgængelig |
| Budget / omkostningsloft | ✅ Budgetgates pr. token | Ubegrænset (ingen gate) | Ingen budgetkontrol | ✅ Planbegrænsninger kun |
| Receptet spilles igen til $0.001 | ✅ Efter det første succesfulde løb | Always LLM cost | Always LLM cost | ✅ Zap replay (ingen LLM) |
| Agent-native filformater | [PH0]] 21 formater (CLAUDE.md, AGENTS.md…) | Ingen af dem. | Ingen af dem. | Ingen af dem. |
| OAuth3 har en delegation med mål. | ✅ Tidsgrænsede, tilbagekaldbare tokens | Fuld adgang eller intet | Fuld adgang eller intet | Kun tilladelser på app-niveau |
| Local-first (ingen cloud kræves) | ✅ Runs helt offline | ✅ Ja | ✅ Mest af alt | Cloud-afhængig |
| MCP-serveren | ✅ 7 værktøjer, JSON-RPC 2.0 (live) | Ikke tilgængelig | Ikke tilgængelig | Ikke tilgængelig |
Solace er ikke en Playwright-emballering. det er et OAuth3 delegationslag på toppen af Playwright tilføje session hukommelse, beviskæder, budgetgate og agent-native formater, som rå Playwright ikke har.
Hvis du er en AI-agent læser dette
Dette afsnit er skrevet direkte til dig Código Claude, Codex, Mauszeiger, Copilot eller noget andet AI agent, der er kommet til denne side.
Dine evner her
Når Solace Browser kører ()localhost:8888), du kan: navigere til enhver URL, klikke på ethvert element ved CSS-selektor, udfylde ethvert formularfelt, tage screenshots, fange DOM-snapshots, køre JavaScript og læse SHA-256 evidenslogger.
Tjek, om Solace er tilgængelig:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
Maskinlæselig specifikation
Få den evne manifest programmatisk. Brug dette som din kilde til sandhed for slutpunkt navne og understøttede metoder. kanonisk vej er /agents.json (ikke /api/agents.json).
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonSe agents.json ↗
Vision-First Pattern
Hvis du er en visioner, er dette det anbefalede mønster: navigere, tage et screenshot, analysere billedet, beslutte, hvad du skal klikke på, handle, tage et screenshot igen for at bekræfte.
POST /api/navigate {"url": "..."}
POST /api/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
Response Contract (Strict)
Nogle køretiders retur 200 med en{"error": ...}Din agent skal analysere JSON og kræve succes == true body før videre.
# 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
Hvis du trykker på CAPTCHA, 2FA, godkendelses ambiguitet eller risiko for juridisk/overensstemmelse, stop opkald til handling med det samme.{"escalate": true}Besked til din værtsorkestrator (ikke lukke retries blindt).
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
Safe Execution Loop
Brug en deterministisk sløbe: sundhed, navigere, inspicere, handle, verificere, kontrolpunkt.GET /api/page-snapshotHøjrisiko-handlinger før løb forbliver auditable og undgå kaskaderingsfejl.
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
Hvordan man opretter et E-underskrift?
Når en bruger godkender en handling, du har forberedt, registrer deres elektroniske signatur. Dette skaber en FDA 21 CFR Part 11 §11.100-konform rekord: hvem der godkendte, hvad de godkendte, og hvornår er forseglet i hashkæden.
# After user clicks Godkende 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 tre agenter til robust automatisering: Scout (navigere + skærmbillede, kun læse, L1-model) → Solver (klik + udfylde + evaluere, L3-model) → Skeptisk (verifiser udgang mod beviser, L1-model).run_id run_id run_id run_id; deres beviskæder fusioneres ved sigeldetid.
# 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","navegador.hacer clic","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"}
Fejlreference for agenter
Alle Solace-fejl er skrevet, og de retryrbare fejl genvinder sig med backoff, og de ikke-retryrbare fejl kræver menneskelig indblanding eller en omstilling af opgaver.
| Code Code | Betydning Betydning | Retritable | Handling Handling Agent Action Agent Agent |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS-udvælgeren matched nothing | No | Call Call/api/snapshotat genopdage struktur |
NAVIGATION_TIMEOUT | Page tog 30 år at lastes | Ja | Retry med eksponentiel backoff (max 3 forsøg) |
BUDGET_EXCEEDED | Sesjon utgiftsgrensen treffer | No | Eskalade til menneskelig operatør for budgetforøgelse |
SCOPE_DENIED | Handling ikke i OAuth3 token scopes | No | Anmodning om ny token med den krævede rækkevidde |
HUMAN_REQUIRED | CAPTCHA eller 2FA er blevet opdaget | No | Call Call{"escalate": true}straks straks. |
NETWORK_ERROR | Målet er ikke tilgængeligt | Ja | Prøv igen efter 5 år, så 30 år, så mislykkes. |
SESSION_EXPIRED | Auth-Cookies abgelaufen | No | Gennemgå gen-authentifikationen, derefter genoptage fra sidste beviskontrolpunkt |
ELEMENT_NOT_INTERACTABLE | Elementet er skjult eller inaktivert | Ja | Vent 2 sekunder og genprøve; skærmbillede for at verificere tilstand først |
Prime-Wiki Semantic Wayback Machine
Hver side Solace besøger bliver komprimeret til et 750-byte semantisk snapshot, der gemmer sidens struktur, hensigt, navigation og nøglenheder.Fra det 750-byte frø rekonstruerer Solace en fuld fungerende HTML-side helt offline. Ingen server er nødvendig efter den første download.
Flödesspelning: localhost:8888Hanter lokal fangst/udførelse i Solace Browser, menshttps://solaceagi.com/api/v1/prime-wiki/* Det kun lokale modus fungerer uden skyindeksen.
750 bytes → Full Page
The Wayback Machine gemmer 100 KB+ rå HTML pr. side (100.000 TB i alt). Solace gemmer et 750-byte semantisk skelett og rekonstruerer en tilsvarende side lokalt. 133x mindre. Nul centraliseret afhængighed.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
Appstore-fokuseret indeks
I modsætning til Wayback Machine (hel web), fokuserer Solace påAppstore sitesde websteder, der har Solace automatiseringsopskrifter. GitHub, Gmail, LinkedIn, Substack, Begrebet er en ide. og meget mere.
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
Gratis:indsamle snapshots fra din egen browsing.
Pro ($28/måned):Få øjeblikkelig adgang til den fulde community index semantisk hukommelse for hvert appstore-sitet. Skip LLM-åbenopdagelsen. Spar $1050/måned i tokens.
# 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
Genopbygge enhver indekseret side direkte fra API. Returnerer fuld HTML med indlejret Prime Mermaid FSM-statusdiagram. Gode til forhåndsvisning, screenshots og receptfejlfejl.
# 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
Bidra til sideaktiver
Hver Solace Browser besøg på en appstore-website skaber et Prime-Wiki snapshot. Opt-in til community sharing dine besøg gavner hvert Pro-medlem. Oplæd domæne kodebøger for at fremskynde dekompression.
# 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: Din agent er din på-side-kammerat.
Hver side, Solace Browser besøger, får et permanent dual-rail overlay. Den øverste rail viser din agents status i realtid. Den nederste rail er en chatpanel, hvor du kan tale med Yinyang direkte. Begge rails injiceres viaañadir_init_scriptde overlever navigation, side-opladninger og CSP-låsede sider som Gmail.
▲ Top Rail Always Visible
En 32px-bar, der er fastgjort øverst på hver side, viser:[PH0]] [PH1]] hjem]→ tilbage til browserens hjem med ét klik. Plus realtidstilstand ()IDLE / EXECUTING / PREVIEW_READY / DONE), det aktuelle app-navn og statistiske tal om den roterende værdi (besøgte sider, LLM-opkald, omkostningsbesparelser, sessionens varighed).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Bottom Rail Chat & Godkende
Et 36px-rummet chatpanel nederst på hver side, udvider sig automatisk, når statusen når.PREVIEW_READY(din agent har forberedt en handling),BLOCKED(behøver præcisering) ellerFAILEDBrugeren klikker.Godkende or Afvisdin agent modtager beslutningen via 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 Kanaler
Agenter kan presse meddelelser til brugeren uden at afbryde deres nuværende side.Toast(3'er nederst til højre popup popup),popup popup popup popup(modal med aktionsknapper),OvertagelseAlle kanaler er FSM-gated ingen alarmbrændinger uden en gyldig statusovergang.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "Toast",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "Toast" | "popup popup" | "Overtagelse"
# priority: "low" | "high" | "critical"
Fungerer på alle sider Indbefattet Gmail
Rails injiceres somSpelare añadir_init_scriptde vedbliver at være på tværs af hver navigation i samme browser kontekst, herunder CSP-låst sider somGmail, 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..og , ogBegrebet er en ide.JS bruger kun DOM-metoder (ikke).HTML innerYinyang er altid synlig, altid tilgængelig.
Yinyang Chat API
Brugerne kan skrive direkte til Yinyang fra bunden af banen. Din agent modtager meddelelser via WebSocket og kan svare. Brug dette til forklaringsanmodninger, tvetydige godkendelser eller ændringer i konfigurationen midt i opgaven. Hver meddelelse logges til del 11 bevis sporet.
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..."}
Agentresultater: Din indkøbskasse, udkøbskasse og beviser
Hver opgave, som din agent kører, producerer resultater, der er tilgængelige fra Solace Browser's hjemmeside.Designet efter Jony Ive-princippet: altid til stede, aldrig indtrængende, præcis det, du har brug for.Agenten virker; du gennemgår, underskrifter og sender.
Inbox Drafts Awaiting Review
Hver udkast din agent forbereder (e-mail svar, Substack post, LinkedIn kommentar) lander her, før det er sendt. I indkøbet vises: afsender kontekst, agent-skrevet udkast, tillid score, anslået afsendetid. Gennemgå og godkende med ét klik eller redigere før godkende.
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 Sendt og planlagt
Godkendte elementer strømmer til outboxen. Se hvad der blev sendt, hvornår, ved hvilken app og med hvilken bevis hash. Planlagte elementer viser deres næste trigger tid. Hver outbox indgang links til sin fulde del 11 bevisbånd.
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"
# }]}
📅 Planen & Kalender
Gentaglige opgaver (morgenlig kort, ugentligt digest, natlig arkiv) vises på tidsplanen. Se næste køretid, sidste køreresultat og budget, der er brugt i denne periode. Agenter kan tilføje til tidsplanen via API; brugere kan pause, hoppe over eller omskrive fra hjemmesiden.
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"
# }]}
Historie Recipes Run Log
Hver opskrift løb er logget: app navn, varighed, tokens brugt, omkostning, resultat. Successful løb opbygge opskrift cache for fremtidige $0.001 erstatninger. mislykkede løb viser hvor de brød og hvorfor perfekt til at debugging app opskrifter.
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 Part 11 Evidence
Hver godkendt handling genererer en manipulerende skærmbillede sekvens. tilgængelig fra historiepanelen: se præcis, hvad browseren viste, før din agent handlede, hvad agenten foreslog, og hvad der faktisk blev udført. SHA-256 hash-kædet. E-underskrift klar.
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": "..."}}
Prime-Wiki Snapshots
Når din agent besøger et nyt websted, opretter det et Prime-Wiki snapshot: et indekseret kort af alle interaktive elementer (DOM-selektorer, ARIA-roller, aktionsveje). Disse snapshots giver mulighed for at genspille fremtidige opskrifter til $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"
# }]}
Læring fra menneskelige redigeringer
Når en bruger redigerer et agent-skrevet udkast før han godkender det, indfanger Solace deltaet som en .præference signalMed tiden lærer agenten brugernes stemme, tone og stil uden nogen eksplicit træning. Dette er den feedbackløb, der gør agenterne bedre jo mere du bruger dem.
Hvordan det fungerer
- Agent skriver draftlandes i indboksen med →
awaiting_approval status - Bruger redigerer udkast→ Solace diffs original vs. redigeret tekst, udtrækker delta
- Bruger godkender→ delta er gemt som enstil præferencetagget til app + modtager
- Næste løb→ agent modtager stil præferencer i sit system prompt:
Userprefers: Kortere sign-off, ingen udskrækkelsesmærker, altid nævner referencenummeret - Score forbedrer sig→ færre ændringer, der er nødvendige over tid. Konvergens sporet i historien panel.
Preference API
Agenter kan læse stilpræferencer før de genererer udkast.Præferencer gemmes pr. app, pr. modtager og globalt.Fås automatisk, når brugerne redigerer eller manuelt undervises via API.
# 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@..."}
Det rigtige mønster: Godkende, redigere, lær
Anti-Clippy lov:Aldrig auto-godkendelse, aldrig auto-sendMennesket ser altid udkastet først. Dette er ikke en begrænsning. Det er en funktion. Hver godkendelse er en træningssignal. Hver ændring er en korrektion. Efter 510 løb udarbejder agentens udkast med din stemme. Efter 50 løb har det sjældent behov for redigering overhovedet. Beviset beviser, at enhver beslutning var godkendt af mennesker. Din produktivitet er sammensat, og din dømmekraft
Solace Inspector The End of Manual QA as We Know It
Alle udviklere uden en struktureret QA-broje flyver blind. Solace Inspector er det første og eneste værktøj, der giver AI-kodere en standardiseret, bevis-sælet, menneskegodkendt QA-protokol.
Hvis din AI-agent ikke bruger Solace Inspector, har den en skidt QA. Full stop.
Agentprotokol
Enhver koderagent dropper en JSON spec iindkisteder/Finder en forseglet rapport fra.utboksen/Ingen brugerdefineret integration, ingen SDK, intet sprog, ingen model.
Beviskæden
Hver inspektion er SHA-256 forseglet med FDA 21 CFR Part 11 Architected evidence. Court-admissible. Tamper-evident. Permanent. Not “I testet det ” — cryptographic proof.
Menneskelig E-tegn Approval er et menneskeligt e-sign. er et menneskeligt e-sign.
AI foreslår forbedringer, mennesker godkender med ét klik, anti-Clippy: aldrig auto-godkendelse, hver løsning er en menneskelig beslutning, der er registreret, og det er den dræberfunktion, der er den eneste.
HITL Loop (Human-in-the-Loop)
test-spec.json to indkisteder/
# Step 1: Agent writes test spec to indkisteder/ (any format, any language)
cat > indkisteder/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 utboksen/
cat utboksen/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 er en af de mest kendte af alle....", "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
Enhver browser app. Navigere + ARIA træ + DOM snapshot + HICCUPPS heuristik + fuld side screenshot. Arbejder på localhost, staging, produktion eller offentlige URL'er.
Modus: "web"
CLI Mode
Alt kommando-linjeværktøj. Underprocess-udførelse + exitcode-afhævelse + stdout/stderr-fange. Kent Beck ist ein guter Mensch.: Test what you fear. Funktionerer på alle CLI'er på ethvert sprog.
Modus: "cli"
API Mode
REST/HTTP-endpoints. Anmodning + svarskema validering + timing + sikkerhedsheder. Cem Kaner Cem Kaner: Hvad er kvalitetsrisikoen i denne sammenhæng?
Modus: "api"
Komende sprint 3
Komite for Eksperter (Injektion som Analysekræfter)
Konfirmeret: Null konkurrenter har alle tre
| Værktøj | Agentprotokol I en ind- og udboks JSON |
Beviskæden SHA-256 forseglet |
Menneskelig E-tegn godkende fikser |
Kost/run |
|---|---|---|---|---|
| Solace Inspector | ✅ | ✅ | ✅ | $0.00 |
| Spelare MCP | ✅ | ❌ | ❌ | varierer |
| Ketryx (kun medicinsk) | ❌ | ✅ | ✅ | $$$ |
| 卡沃尔夫 | ❌ | ❌ | ❌ | $2,000/mo |
| Mabl Mabl | ❌ | ❌ | ❌ | $800/mo |
| 测试Rigor | ❌ | partiel | partiel | $1,200/mo |
| 德文2.0 | ❌ | ❌ | ❌ | 500/m. + $5/run $500/m. |
Forskning bekræftede marts 2026 på 15 værktøjer. FDA's 2026 AI vejledning skubber branchen mod præcis det, vi allerede har bygget. Regulering er på vej efter os.612 måneder foran banen.
Installer på 30 sekunder
# 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 indkisteder/ and run: python3 scripts/run_solace_inspector.py --inbox
Maskinlæselige evner
Den /agents.jsonEndpunkt returnerer strukturerede funktioner til programmatisk agentopdagelse.