Тепер ваш агент ІІ контролює будь-який веб-сайт.
З повним аудитом.
Впустіть одну рядок доCLAUDE.md, AGENTS.md, або .cursorrules— і ваш ІІ здобуває справжню автоматизацію браузера: Gmail, Slack, LinkedIn, GitHub, та будь-який веб-сайт. Кожен клік підписаний, запечатаний та перевірений. Сервер MCP онлайн. Відправляється за 30 секунд.
Додайте Solace до будь-якого проекту за одну команду
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Додає інструкції з автоматизації Solace Browser до вашого проекту Код Клода. Працює одразу — без реєстрації, без SDK.
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.
Кожен великий агент кодування штучного інтелекту підтримується
Завантажте правильний формат для вашого помічника штучного інтелекту. Кожен файл вказує штучному інтелекту, як використовувати Solace — переміщатися, клацати, заповнювати, робити скріншоти та захоплювати докази. Підтримується 21 формат із коробки.
Код Клода
Перейдіть до свогоCLAUDE.md. Код Клода буде використовувати Solace Browser для будь-якого завдання автоматизації веб-страниць автоматично.
Кодекс Кодекс OpenAI Codex
Перейдіть до свогоAGENTS.md. Агенти Кодекс OpenAI Codex і ChatGPT читає цей файл, щоб зрозуміти доступні інструменти та можливості.
Курсор
Перейдіть до свого.cursorrules. Курсор звертається до Solace 언제 ви просите його взаємодіяти з веб-сайтом.
Вίνдсерф
Перейдіть до свого.윈드서핑 규칙. Віндсерф (Codeium) приймає можливості Solace точно так само, як і Курсор — той самий формат, нуль тертя.
Копілота GitHub
Перейдіть до.github/copilot-instructions.md. Copilot จะ запропонує виклики Solace AGI API для завдань браузера.
Помічник
Передайте як системний提示พร้อม з--system-prompt solace-aider.md. Помічник автоматично маршрутизує всі взаємодіють із вебом через Solace Browser.
Продовжуйте.dev
Додати до свого.continue/config.jsonпровайдерів контексту. Continue відображуватиме автоматизацію Solace Browser як вбудований інструмент у VS Code та JetBrains.
Клін
Перейдіть до свогоدليل. يقرأ Клін قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.каталог. Клін читає规ли проекту при запуску сеансу — можливості Solace завантажуються автоматично для кожного розмови.
РуоКоде
Помістіть у.roocode/Regeln/. РуоКоде (раніше Roo-Клін) успадковує можливості браузера Solace Browser разом з його агентними режимами кодування за допомогою Solace AGI.
Gemini CLI - это Google Gemini.
Додати доGEMINI.mdв корені вашого проекту. відкритий клієнт командного рядка агента Google приймає інструкції Solace таким же чином, яким він читає інструкції Claude'sCLAUDE.md.
Jules Jules Google Jules
Jules читаєAGENTS.mdдо виконання дій щодо проблем на GitHub. Інструкції Solace з'являються автоматично, коли Jules обробляє будь-яке завдання, пов'язане з вебом, у вашому репозиторії.
Редактор Zed
Помістіть правила в92у корені вашого проекту. Панель штучного інтелекту Zed читає ці правила вродовж — Solace AGI стає доступним для допоміжника Zed AI миттєво.
Rozvíjítel Amazon Q
Додати до.amazonq/rules/solace.md. Розvíjítel Amazon Q читає файл правил у форматі markdown з цього каталогу для кожної сесії кодування у вашому проекті.
JetBrains штучний інтелект
Додати до.idea/директиви-штучного-інтелекту.md. Помічник штучного інтелекту JetBrains читає цей файл у всіх IntelliJ, PyCharm, WebStorm та інших JetBrains IDE.
Суурцеграф Коді
Розмістити контекст у.cody/context/solace.md. Cody включає цей файл до контексту виведення — інструкції Solace з'являються в кожному розмові Cody.
Табніна
Налаштувати через. ملف تخصيص Табніна يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.. Файл персоналізації Табніна дозволяє вам навчити його інструментарію вашої команди — включаючи автоматизацію Solace browser.
Звертайте AI
Додати до свого.replit をreplitする をreplitするфайлів[ai]розділ. Звертайте AI читає контекст проекту звідси — Solace стає доступним у кожному робочому просторі Replit.
Девін
Помістіть у.devin/流程书/. Девін читає книгу рецептів проекту перед початком завдань з великим горизонтом — інструменти браузера Solace Browser доступні для будь-якого веб-workflow.
Фабричний Дрод
Фабричні читанняAGENTS.md і .фабрика/конфіги. Агенти Droid успадковують можливості Solace AGI під час автоматизаціїoftware розробки(workflow)
Кіло Код
Додати до.kilocode/правила/. Кіло Код дотримується одного й того самого шаблону правил проекту, як і Клайн — інструкції Solace завантажуються для кожної агентської сесії кодування.
llms.txt
Стандарт Jeremy Howard для описів сайтів, які можуть бути прочитані LLM. Помістіть файл у корінь свого проекту, щоб будь-який LLM міг зрозуміти Solace.
Завантажте llms.txtЩо знаходиться всередині.snippet CLAUDE.md
Кожен файл інтеграції вчить вашого.AI-агента, як використовувати Solace. Ось кодовий уривок Claude — помістіть його у свій проект, і ваш агент відразу ж зрозуміє всі 14 Solace API, сервер MCP, електронне підписування та найкращі практики.
# 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 {"вираз": "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 + бюджет_usd 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 {"вираз": "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 + бюджет_usd on every token
4. Notify user via Інь-Ян (never console.log spam)
5. E-sign every user-approved action
Повний файл:завантажити уривок CLAUDE.md • Переглянути agents.json (орієнтований на машину)
Привіт, світ за 3 дзвінки API
Відкрити весь Solace API можна за три команди. Все інше - це варіація.
Перейти на будь-яку сторінку
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"}
Зробіть знімок того, що сталося
curl -X POST http://localhost:8888/api/знімок -H "Content-Type: application/json" -d '{"full_page": true}'
→ {"success": true, "filename": "screenshot-20260302-120000.png", "filepath": "artifacts/screenshot-20260302-120000.png", "size": 17115}
Докази захоплені автоматично
→ 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-ланцюг запечатаний. Кожна дія是个下载PrimaryKey.
Повна довідка API
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Кінцева точка | Метод | Що Воно Робить | ОАут3 Скопа |
|---|---|---|---|
/api/navigate | POST | Завантажити URL в браузері | Браузер.навигејт |
/api/click | POST | Клікнути будь-який CSS селектор | Браузер.клик |
/api/заповнити | POST | Заповнити поле форми | Браузер.филл |
/api/знімок | POST | Зробити знімок поточної сторінки у форматі PNG (збережено до artifacts/) | Браузер.скренсхот |
/api/оцінка | POST | Виконати JavaScript (виразключ), повернути результат | Браузер.Евалуате |
/api/snapshot | POST | Захопити сирий HTML сторінки | Браузер.снампшот |
/api/aria-snapshot | GET | Дерево доступності ARIA (структурований JSON) | Браузер.снампшот |
/api/dom-snapshot | GET | Знімок дерева DOM для детермінованих перевірок структури | Браузер.снампшот |
/api/page-snapshot | GET | Об'єднана знімок сторінки (ARIA + DOM + метадані) | Браузер.снампшот |
/api/health | GET | Тест на живість для готовності під час виконання | (немає) |
/api/status | GET | Здоров'я браузера, готовність, поточний URL, сесія | (немає) |
/api/part11/status | GET | Стан захоплення частина 11, ідентифікатор сесії, записані байти, остання помилка | (немає) |
/api/part11/config | POST | Налаштування режиму захоплення частина 11 та аудиторського каталогу | part11.конфігурувати |
/agents.json | GET | Машино-читаний маніфест можливостей | (немає) |
Сервер MCP — Живе Зараз
Протокол контексту моделі дозволяє Код Клода та іншим інструментам, сумісним з MCP, підключатися до Solace як до вбудованого інструменту — немає потреби в командах curl. Сьомий інструмент доступний сьогодні: навігація, клік, заповнення, знімок екрана, 快照, оцінка, aria_snapshot.
✅ Локальний MCP — Доступно Зараз
# Крок 1: запустіть сервер MCP (stdio JSON-RPC 2.0) python3 ~/projects/solace-browser/yinyang_mcp_server.py # Крок 2: додайте до Код Клода .claude/settings.json: { "mcpServers": { "solace": { "command": "python3", "args": ["/path/to/solace-browser/yinyang_mcp_server.py"] } } }
Відразу після конфігурації, Код Клода викликає detect_apps, create_schedule, record_evidence, і 5 more Hub-native MCP tools on localhost:8888. Кожен виклик має діапазон OAuth3 та свідчення SHA-256.
☁ Віддалений MCP — Хмара (Незабаром)
# 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"
}
Підключайтесь з будь-якої машини. Робочі процеси браузера запускаються в хмарі. OAuth3 регулює кожен виклик інструменту. Кожна дія хеш-ланцюжкова та 擷取 свідчення до вашого сховища. Вимагається рівень Dragon Warrior.
8 Інструмент MCPs Available Today
| Інструмент MCP | Відображається до API | Що Воно Робить |
|---|---|---|
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, readiness, і runtime state. |
Що Ваш агент може робити з Solace
Поза навігацію та кліки — Solace дає Вашому агенту повноцінну сенсорну й пам'ять систему для вебу.
📷 Дивитися сторінку
Зробити знімок будь-якої сторінки у повному розширенні. Захопити(snapshot) DOM-скріпту та дерева доступності ARIA. Ваш агент отримує структуровані візуальні та семантичні дані — не тільки суровий HTML.
📄 Видобути структуровані дані
Запустити /api/оцінкадля виконання JavaScript та повернення структурованих даних JSON. Видобути таблиці, ціни, значення форм або будь-які дані сторінки безпосередньо в контекст вашого агента.
🔒CommandEvent дозволи
Запитати тільки те, що вам потрібно. OAuth3 токени мають обмежений обсяг (Браузер.навигејт, Браузер.клик, Браузер.филл), обмежені у часі та можуть бути скасовані. Закриті заconditions за проєктом.
📋 Автоматичний збір доказів
Кожна дія агента автоматично реєструється, заповнюється хеш-ланцюгом та запечатується. Ваш агент витворює запис дозрівання без написання жодної лінії реєструючого коду.
♾ Пам'ять рецепта
Solace AGI запамятовує успішні потоки роботи як рецепти. Під час відтворення ваш агент пропускає весь LLM та виконує закешовануagedList за $0.001 — на 99% дешевше, ніж повторне відкриття.
💸 Виконання бюджету
Встановіть ліміт витрат на сесію. Пропустіть"presupuesto_usd": 0.05у вашому запиті токена та Solace зупинить агент, коли бюджет буде витрачений — жодних неконтрольованих витрат.
🔎 Пошук доказів
Запитайте попередні запуски з/api/evidence/search. Агенти можуть шукати, що відбулося в попередніх сесіях — корисно для інкрементальних завдань, як-от " nějaké пошту, яку не бачили з останнього запуску."
🌎 Тривалість сесії
Сесії браузера продовжуються між викликами агентів. Увійдіть один раз, поверте сесію. Без перевідомлення про автентифікацію. Файли cookie, локальне сховище та токени автентифікації зберігаються під час виконання завдань.
⚡ Паралельні вкладки
Відкрийтеveral браузерні контексти одночасно. Ваш агент може одночасно витягувати 10 сторінок, порівнювати результати та об'єднувати висновки — усе з незалежними доказовими слідами.
🤖 Багат :.:агентні рої
Створіть кілька незалежних екземплярів Solace Browser. Агенти-розвідники досліджують; агенти-коди активують; агенти-скептики перевіряють. Кожен екземпляр має自己的 сесію, бюджет та ланцюг доказів. Оркеструйте від будь-якого планиувальника (cron, Cloud Run, GitHub Actions).
🛈 Електронний підпис & FDA Part 11
Кожна затверджена дія може бути електронно підписана: користувач реєструє „Я (Phuc) переглянув і затвердив цю дію [часовий штамп]“. Підпис із SHA-256 закодований у хеш-ланцюг. Збігається з вимогами FDA 21 CFR Part 11 §11.100 електронного підпису.
Найкращі практики агентів
Зразки, що роблять ваш агент надійним, аудитованим та дешевим у використанні.
✅ Знімок екрана до кліку
Завжди викликаєте/api/знімокперед дією(click action). Це створює доказовий запис того, що бачив агент до дії — критично важливо для аудит-TRL та налагодження невдалого виконання.
POST /api/знімок {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
🔎 Знімок для Структури, Знімок екрана для Видимості
Використовуйте /api/aria-snapshot(Дерево доступності ARIA, JSON) коли ваш агентеві потрібно розуміти структуру сторінки. Використовуйте/api/snapshotдляHeaderView HTML./api/знімокдля візуальної розкладки та зображень.
GET /api/aria-snapshot # повертає дерево ARIA JSON POST /api/snapshot # повертає суровий HTML POST /api/знімок # повертає шлях файлу PNG
🔒 Запит Мінімальних Областей
Запитуйте тільки ті області дії OAuth3, які потрібні вашому завдання. Завдання тільки для читання ніколи не повинно матиБраузер.филлобласть дії. Вузькі області дії запобігають випадковим побічним ефектам і задовольняють аудити з питань відповідності.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["Браузер.навигејт",
"Браузер.скренсхот"],
"ttl_seconds": 300
}
♾ Перевірте наявність існуючих рецептів спочатку
Перед запуском робочого процесу з токенами LLM, викличте/api/recipes/match. Якщо рецепт існує для завдання, відтворіть його за $0.001. Збережіть виклик LLM для справді нових робочих процесів.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
💸 Встановіть бюджет на кожній сесії
Ніколи не дозволяйте агенту працювати без стелі бюджету. Передайтебюджет_usdу вашого запиту токену. Solace AGI зупинить сесію, коли буде досягнуто ліміт, а не тихо перевищувати.
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_...
🌎 Перевикористовуйте сесії для аутентифікованих сайтів
Увійдіть один раз та збережіть токен сесії. Передайте"id phiên"у наступних запитах API для повторного використання файлів cookie та стану аутентифікації. Лікарює потоки входу з кожного запуску агента.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Чому Agent-Native має значення
AEO: Оптимізація двигуна агента
Як SEO оптимізовано для пошукових краулерів, AEO оптимізує для агентів ІІ. Solace є першою платформою, побудованою з агентами як першокласними користувачами — не як післяthought.
Докази, які ваші агенти не能够 фальсифікувати
Кожна дія агента створює хеш-ланцюг SHA-256. Ваш CISO може проводити аудит того, що зробив ІІ. Вашому керівництву можна побачити докази. Ні чорних скриньок.
Рецепти, які роблять агентів розумнішими
Коли агент виконує завдання, воно стає рецептом. Наступного разу: $0.001 відтворення — жодного ЛЛМ-токену не витрачається. Агенти, які використовують Solace, стають швидшими і дешевшими з плином часу.
Як Solace порівнюється
Розробники, які обирають інструменти автоматизації браузера, запитують чотири питання: Чи зберігає сесію? Чи створює аудит-трейл? Чи можу delegate до ІІІ без витрат, що вихідять з-під контролю? Чи витримає комплаєнс-аудит? Ось чесна відповідь на кожен варіант.
| Функція | Solace Браузер | Плейвюртор прямий | використання браузера / OpenClaw | Бардійн / Запіє |
|---|---|---|---|---|
| Тривалість сеансу | ✅ Файли cookie виживають через запуски | ❌ Ефемерні за замовчуванням | ❌ Ні сеансної пам'яті | ✅ Стан розширення Chrome |
| SHA-256 аудитний слід | ✅ Кожна дія,孩-lainen | ❌ Ні вбудованого | ❌ Немає | ❌ Тільки журнали (не захист від підробок) |
| FDA-частка 11 електронний знак | ✅ Вбудований (/api/v1/esign) |
❌ Не доступно | ❌ Не доступно | ❌ Не доступно |
| Бюджет / ліміт вартості | ✅ Брами бюджету на токен | ❌ Ноб лі mát (немає брами) | ❌ Відсутній контроль бюджету | ✅ Ліміт плану тільки |
| Повтор рецепта за $0.001 | ✅ Після першого успішного запуску | ❌ Завжди вартість LLM | ❌ Завжди вартість LLM | ✅ Повтор зажадання (без LLM) |
| Формати файлів, рідні для агента | ✅ 21 формат (CLAUDE.md, AGENTS.md…) | ❌ Немає | ❌ Немає | ❌ Немає |
| OAuth3 делегування у межах обсягу | ✅ Жетони з обмеженим терміном дії, що possono бути відкликані | ❌ Повний доступ або нічого | ❌ Повний доступ або нічого | ❌ Доступ на рівні застосунків тільки |
| Локально- перший (неBrowsable потрібen хмарний сервіс) | ✅ Працює повністю офлайн | ✅ Так | ✅ В основному | ❌ Залежить від хмари |
| Сервер MCP | ✅ 7 інструментів, JSON-RPC 2.0 (онлайн) | ❌ Не доступно | ❌ Не доступно | ❌ Не доступно |
💬 Solace Browser не є обгорткою Playwright. Це шар делегування OAuth3 поверх Playwright — додає пам'ять сеансу, ланцюги доказів, бранші бюджету та формати, рідні для агентів, яких немає в самому Playwright. Шар цієї делегації створений компанією Phuc Labs для Solace AGI в рамках Software 5.0 з урахуванням вимог FDA Part 11 і(ALCOA+), побудований на базі технологій Together.ai та OpenRouter з використанням захисту даних AES-256-GCM та сертифікації SOC2.
Якщо Ви Агент ШІ, який читає це
Цей розділ написаний безпосередньо для вас — Код Клода, Codex, Курсор, Copilot, або будь-який інший агент ШІ, що прибув на цю сторінку. Ось саме те, що вам потрібно знати, у форматі, який найбільш корисний вам.
🤖 Ваші Возможності Тут
Коли працює Solace Browser (localhost:8888), ви можете: перейти на будь-який URL, натиснути будь-який елемент за допомогою CSS селектора, заповнити будь-яке полі فرم, зробити знімок екрана, захопити знімок DOM, виконати JavaScript, і прочитати SHA-256 доказові логи. Кожна дія атомарна та запечатана доказами.
Перевірте, чи доступний Solace:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
📋 Специфікація для Читання Машинами
Отримайте маніфест можливостей програмно. Використовуйте це як джерело істини для імен вузлів та підтримуваних методів. Канонічний шлях — /agents.json (не /api/agents.json).
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonПерегляньте agents.json ↗
🔎 Візуально-Перший Шаблон
Якщо ви агент, здатний до бачення, це рекомендований шаблон: навігація, знімок екрана, аналіз зображення, рішення про те, що клікнути, дія, знімок екрана знову для перевірки. Ніколи не припускайте, що дія завершилася успішно без візуального підтвердження.
POST /api/navigate {"url": "..."} POST /api/знімок {} # проаналізуйте це POST /api/click {"selector":"#x"} POST /api/знімок {} # перевірте результат
⚠ Договір Відповіді (Суворий)
Не покладайтесь виключно на HTTP-статус. Деякі середовища виконання повертають 200 з{"error": ...}тіло. Ваш агент повинен парсити JSON і вимагати success == true перед продовженням.
# Надійне правило: # 1) Парсити JSON-відповідь # 2) якщо response.success не true -> припинити етап # 3) включити response.error до повідомлення про підвищення {"success": true, "url": "https://example.com", "status": 200} {"error": "Page.fill: ЧасWAIT 30000мс перевищено."}
👥 Протокол Ескалації Людині
Якщо ви натрапили на CAPTCHA, 2FA, неоднозначність схвалення або юридичні/комплаєнс-ризики, зупиніть дії викликів негайно. Поверніть структуровану{"escalate": true}повідомлення своєму господареві-оркестратору (не повторюйте спроби сліпо).
{ "escalate": true, "reason": "2FA необхідний", "last_step": "POST /api/click #sign-in", "evidence": "artifacts/screenshot-20260304-131500.png" }
💸 Безпечний цикл виконання
Використовуйте визначений цикл: здоров'я, навігація, інспекція, дія, перевірка, 控рольна точка. ВключайтеЗНИМ /api/page-snapshotдо ризикованих дій, щоб виконання залишалося аудитуємим і уникати каскадних помилок.
GET /api/health
POST /api/navigate {"url":"..."}
GET /api/page-snapshot
POST /api/click|fill {"selector":"..."}
POST /api/знімок {"full_page":true}
GET /api/status
🛈 Як створити запис електронного підпису
Коли користувач затверджує дію, підготовлену вами, реєструйте їхній електронний підпис. Це створює запис, що відповідає вимогам FDA 21 CFR Part 11 §11.100: хто затвердив, що було затверджено та коли — закрито в ланцюжок хешів. Вимагається для регульованих робочих процесів.
# Після того, як користувач клікає «Затвердити» у нижній панелі: POST /api/v1/esign/token { "user_id": "phuc@example.com", "run_id run_id": "run-abc123", "meaning": "reviewed_and_approved", "action_description": "Відправлено відповідь на електронну пошту 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 # }
⚡ Шаблон багатоконтурного агента
Створити три агенти для відмовостійкої автоматизації: Scout (навігація + знімок екрана, тільки для чтення, модель L1) → Solver (клік + заповнення + оцінка, модель L3) → Skeptic (перевірка виходу проти свідчень, модель L1). Всі троє спільно маютьrun_id run_id run_id run_id; їхні ланцюжки свідчень об’єднані під час запечатування.
# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["Браузер.навигејт","Браузер.скренсхот"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["Браузер.навигејт","Браузер.клик","Браузер.филл"],"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"}
Посилання на помилки агентів
Кожна помилка Solace має тип. Помилки, які можна повторно виконати, відновлюються з вискою. Неповторювані помилки потребують втручання людини або перезaproektції завдання.
| Код | Значення | Повторюване | Дія агента |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS селектор не знайшов жодного збігу | Ні | Виклик/api/snapshotщоб знову відкрити структуру |
NAVIGATION_TIMEOUT | Сторінка завантаження тривала > 30с | Так | Повторити з експоненційним відступом (макс. 3 спроби) |
BUDGET_EXCEEDED | Досягнута межа витрат сесії | Ні | Ескалація до людини-оператора для збільшення бюджету |
SCOPE_DENIED | Дія не вказана в діапазонах OAuth3-токену | Ні | Запит нового токену з необхідним діапазоном |
HUMAN_REQUIRED | Виявлено CAPTCHA або 2FA | Ні | Виклик{"escalate": true}одразу ж |
NETWORK_ERROR | Цілевий сайт недоступний | Так | Повторити через 5с, потім 30с, потім fail |
SESSION_EXPIRED | Кукіс аутентифікації застаріли | Ні | Поновіть аутентифікацію, потім продовжити з останньої контрольної точки доказів |
ELEMENT_NOT_INTERACTABLE | Елемент прихований або вимкнено | Так | Чекати 2с і повторити; зробіть знімок екрана, щоб підтвердити стан спочатку |
Прим Wiki — Семантична Wayback Machine
Кожна сторінка, яку відвідує Solace, стискається до семантичного знімка розміром 750 байт — зберігається структура сторінки, намір, навігація та ключові сутності. З tohoto 750-байтового насіння Solace реконструює повну робочу HTML-сторінку повністю поза мережею. Сервер після першого завантаження більше не потрібен.
Потоковий розподіл: localhost:8888оброблює локальну захоплення/виконання в Solace Browser, тоді якhttps://solaceagi.com/api/v1/prime-wiki/* є спільний社区 індекс (пуш/пул/пошук/статистика/рендер). Локальний режим роботи 功能 без індексу в клауді.
📷 750 байт → Повна сторінка
Wayback Machine зберігає 100КБ+ сыру HTML на сторінку (100 000 ТБ загалом). Solace зберігає 750-байтовий семантичний каркас і реконструює еквівалентну сторінку локально. У 133 рази менший. Нульова централізована залежність.
# Реконструювати будь-яку індексовану сторінку локально: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
🏛 Індекс, орієнтований на Appstore
На відміну від Wayback Machine (цілий веб), Solace AGI зосереджується насайтах appstore— сайтах, які мають自动изовані рецепти Solace Browser. GitHub, Gmail, LinkedIn, Substack, Нотіон та інші. Якість перемагає охоплення.
GET /api/v1/prime-wiki/search?q=github # Повертає всі індексовані сторінки GitHub GET /api/v1/prime-wiki/stats # {"count": 7, "rtc_verified_count": 7}
🔒 Pro: Повний доступ до спільноти
Безкоштовно:збирати знімки зі свого браузера.
Pro ($28/міс):wechat доступ до повного індексу спільноти — семантична пам'ять для кожного сайту appstore. Пропустіть重新 відкриття LLM. Збережіть $10–50/місяць у токенах.
# Завантажте всі кодбуки appstore однократно: GET /api/v1/prime-wiki/assets?appstore_only=true # Зберігайте у ~/.solace/pzip/assets/ # Розархівуйте локально, назавжди —FileManager offline cap
📄 Рендер API — Серверний добудова
Відновіть будь-яку індексовану сторінку безпосередньо з API. Повертає повний HTML з вбудованою діаграмою стану Prime Mermaid FSM. Корисно для попереднього перегляду, знімків екрана та налагодження рецептів.
# 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
🌎 Відкритий внесок у сторінкові активи
Кожний візит Solace Browser на сайт appstore створює знімок Прим Wiki. Оптимально поділіться спільнотою — ваші візити корисні кожному учаснику Pro. Завантажте кодбуки доменів, щоб прискорити розархівування.
# 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: Ваш компаньйон-агент на сторінці
Кожна сторінка, яку відвідує Solace Browser, отримує постійну двоколійнуddb-bearing. Верхній рейл показує стан вашого агента в режимі реального часу. Нижній рейл — це панель чату, де ви можете спілкуватися з Yinyang безпосередньо. Обидва рейли інжектуються черезañadir_init_script— вони виживають під час навігації, перезавантаження сторінки та сторінок із закриттям CSP, наприклад, Gmail.
▲ Top Rail — З 늘 Видимый
Панель висотою 32 пікселі, закріплена в верхній частині кожної сторінки. Показує:[PH0]] Solace home]→ повернути до домашньої сторінки браузера за один клік. Плюс стан в реальному часі (IDLE / EXECUTING / PREVIEW_READY / DONE), поточна назва програми, і обERT значення статистики (відвідувані сторінки, виклики LLM, збережені витрати, тривалість сеансу).
# Надіслати оновлення стану до верхньої рейки: POST /api/yinyang/notify {"type": "state_update", "state": "EXECUTING", "app_name": "Gmail Triage"}
▼ Нижня рейка — Чат і затвердження
Згорнута панель чату 36px внизу кожної сторінки. Автоматично розгортається, коли стан досягаєPREVIEW_READY(ваш агент підготував дію),БЛОКУВАНО(потребує уточнення), абоПОВИЛУЧЕНО. Користувач натискаєЗатвердити або Відхилити— ваш агент отримує рішення через WebSocket.
# WebSocket для агента в режимі реального часу ↔ Yinyang: ws://localhost:8888/ws/yinyang # Push-попередній перегляд для схвалення користувачем: {"type": "bottom_rail_update", "payload": { "state": "PREVIEW_READY", "preview_text": "Відповідь Лі Лі про...", "show_approve_reject": true, "run_id run_id": "run-abc123" }}
🔔 Push-сповіщення — 3 канали
Агенти можуть відправляти сповіщення користувачеві без переривання їхньої поточної сторінки. Три канали:тост(3с поп-ап у правому нижньому куті),Popup(модальне вікно з кнопками дій),завоювання(повний екран для критичної затвердження). Все канали проходять через FSM-браму — жодне сповіщення не спрацьовує без дійсного переходу стану.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "тост",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "тост" | "Popup" | "завоювання"
# priority: "low" | "high" | "critical"
🌏 Працює на ВСІХ сторінках — INCLUDING Gmail
Рейки вводяться якПлейврайтер añadir_init_script— вони зберігаються при кожному переміщенні на тому ж браузерному контексті, включаючи сторінки з CSP-блокуванням, наприкладGmail, У Google Документима, іНотіон. The JS використовує pouze DOM методи (ніHTML inner), обходячи обмеження TrustedHTML. Yinyang завжди видимий, завжди досяжний.
Єньян Чат API
Користувачі можуть вводити текст безпосередньо до Yinyang з нижньої панелі. Ваш агент отримує повідомлення через WebSocket і може відповісти. Використовуйте це для запитів на уточнення, сумнівних затверджень або змін конфігурації під час виконання завдання. Кожне повідомлення реєструється в доказовий слід Part 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..."}
📦 Результати агента: Ваші Вхідні, Відправлені та Докази
Кожне завдання, яке виконує ваш агент, генерує результати, які можна доступити з домашньої сторінки Solace Browser. Розроблено за принципом Джоні Айва: завжди на виду, ніколи не нав'язливо, саме те, що вам потрібно. Агент працює; ви оглядаєте, підписуєте та доставляєте.
📤 Вхідні — Чорновики, які очікують перевірки
Кожен чернетка, який ваш агент підготував (відповідь на електронну пошту, публікація Substack, коментар LinkedIn), потрапляє сюди قبل того, як буде відправлено. Вхідні дані показують: контекст відправника, чернетку, написану агентом, оцінку впевненості, передбачуваний час відправлення. Перегляньте та затвердіть одним кліком — або редагуйте перед затвердженням.
GET /api/v1/inbox # {"items": [{ # "id": "draft-abc", # "app": "gmail-inbox-triage", # "type": "email_reply", # "to": "li.li@...", # "subject": "Re: Solace user case", # "preview": "Привіт Li Li, дякую за...", # "confidence": 0.91, # "status": "awaiting_approval" # }]}
📥 Відправлені & Заплановані
Затверджені елементи переходять до відправлених. Дивіться, що було відправлено, коли, яким додатком та з яким доказовим хешем. Заплановані елементи показують час їх наступного спрацювання. Кожен запис у відправлених містить посилання на повний пакет доказів Part 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"
# }]}
📅 Розклад & Календар
Повторювані завдання (ранковий брифінг, щотижневий дайджест, нічний архів) з'являються у розкладі. Дивіться час наступного виконання, результата останнього виконання та бюджету, використаного в цьому періоді. Агенти можуть додавати завдання до розкладу через API; користувачі можуть паузу, пропустити або змінити розклад з головної сторінки.
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"
# }]}
📚 Історія — Журнал виконання рецепта
Кожен запуск рецепта обліковується: назва додатка, тривалість, використані жетони, вартість, результат. Успішні запуски створюють缓у рецептів для майбутніх повторень за $0.001. Невдалі запуски показують, де вони помилилися та чому — ідеально для налагодження рецептів додатків.
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
Кожна затверджена дія генерує послідовність захищених від підробок знімків екрана. Доступно з панелі історії: побачити саме те, що браузер показував до того, як агент виконав дію, що агент запропонував і що було фактично виконано. Ланцюжок хешів SHA-256. Готовий до електронного підпису.
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
Коли агент відвідує новий сайт, він створює знімок Прим Wiki: індексовану карту всіх互одіючих елементів (DOM selektory, ролі ARIA, шляхів дій). Ці знімки підтримують майбутню реплікацію рецептів за $0.001. Доступно з домашньої сторінки — прос HtmlWebpackPlugin, шукайте або експортуйте як діаграми Prime Mermaid FSM.
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"
# }]}
🌟 Навчання з редагувань людини
Коли користувач редагує чернетку, написану агентом перед її затвердженням, Solace AGI захоплює дельту яксигнал переваги. З часу, агент вчиться голосу, тону та стилю користувача — без явного тренінгу. Це той зворотній зв'язок, який робить агентів кращими чим більше ви їх використовуєте.
📝 Як це працює
- Агент складає чернетку→ потрапляє до ПОЧТОЮ з
статусом: очікування_/ підтвердження - Користувач редагує чернетку→ Solace порівнює оригінал з відредагованим текстом, витягує дельту
- Користувач підтверджує→ дельта зберігається якналаштування стилюпозначено до додатка + одержувач
- Наступний запуск→ агент отримує стилістичні переваги в своєму системному запиту:
“Користувач передає перевагу: короткий підпис, жодних знаків оклику, завжди згадує номер poč khóa” - Оцінка покращується→ менше редагувань потрібно з часом. Збіжність відстежується в панелі історії.
📊 API перференцій
Агенти можуть читати стилістичні переваги перед генерацією чернеток. Переваги зберігаються за додатком, одержувачем та глобально. Захоплюються автоматично, коли користувачі редагують — або вчителяться вручну через API.
# Читати переваги перед створенням чернетки: GET /api/v1/preferences?app=gmail-inbox-triage # {"global": ["ла콘ічний, 3 речення макс."], # "recipient:li.li@...": [ # "зазначити номер_REFERER", # "жодних знаків оклику" # ]} # Автоматичне захоплення редагування користувача: POST /api/v1/preferences/signal {"app": "gmail-inbox-triage", "original": "Привіт Li Li! Дякую за...", "edited": "Привіт Li Li, дякую за...", "recipient": "li.li@..."}
💡 Правильний шаблон: Підтвердити, редагувати, вивчати
Закон анти-Кліппі:николи не автодозволяти, ніколи не автکنд اهل. Людина завжди бачить чернетку першою. Це не обмеження — це функція. Кожне схвалення є сигналом навчання. Кожна редакція є корекцією. Через 5–10 запусків, агент створює текст вашим голосом. Через 50 запусків, йому ледь потрібно редагування взагалі. Доказовий слід доводить, кожне рішення було схвалено людиною. Ваша продуктивність зростає, і ваше судження залишається в записі.
Інспектор полюбованості — Кінець ручної QA, як ми її знаємо
Ваши AI-агенти відправляють нерозроблений код. Кожна команда розробників без структурованого мосту QA летить вкрита. Solace Inspector — перший — і єдиний — інструмент, який надає AI-агентам кодування звlogo, стандартизованого, захищеного доказами, схваленого людиною протоколу QA.
Якщо ваш AI-агент не використовує Solace Inspector, у нього погана QA. Крапка.
Протокол агента
Будь-який агент кодування скидає JSON специфікацію вінбокс/. Збирає запечатаний звіт відщирука/. Без властивої інтеграції. Без SDK. Будь-яка мова. Будь-яка модель.
Ланцюг доказів
Кожна інспекція є SHA-256 запечатана FDA 21 CFR Part 11 Architected доказом. Суд-допустим. Захисний-доказаний. Постійний. Не я перевірив його криптографічним доказом.
Підтвердження людини електронним підписом
Solace AGI пропонує вірші. Людина підтверджує одним кліком. Анти-Кліппі: ніколи не автопідтверджувати. Кожен вірш - це рішення людини в реєстрі. Це вбивча функція. Нічого іншого цієї функції немає. Розроблено Phuc Labs за допомогою Solace Browser,_oauth3 та Software 5.0. Захист даних згідно з вимогами SOC2, AES-256-GCM та ALCOA+. Цей продукт використовує Together.ai та OpenRouter.
Петля HITL (Людина в петлі)
test-spec.json до інбокс/
# Step 1: Agent writes test spec to інбокс/ (any format, any language)
cat > інбокс/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 щирука/
cat щирука/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
# }
🌐 Веб-режим
Будь-яка веб-застосунка. Перейти + Дерево ARIA + Знімок DOM + Євристика HICCUPPS + повноекранний знімок. Працює на localhost, staging, production або публічних URL-адресах. Використовує технології: Solace AGI, Solace Browser, OAuth3, Software 5.0, розроблені компанією Phuc Labs, Meeting вимогам FDA Part 11, ALCOA+, SOC2, з шифруванням даних за допомогою AES-256-GCM, Together.ai та OpenRouter
режим: "web"
⚙ Режим CLI
Інструмент командного рядка. Виконання підпроцесу + перевірка коду виходу + захоплення stdout/stderr. Кент Бек: «Тестуйте те, чого боїтеся.» Працює з будь-яким CLI будь-якої мови.
режим: "cli"
📡 Режим API
Кінцеві точки REST/HTTP. Валідация схеми запиту + відповіді + таймінги + безпекові заголовки. Джем Канер: «Який ризик якості в цьому контексті?»
режим: "api"
Наступний спринт 3
Комітет експертів (Вalborg як تحلیل промпти)
Підтверджено: Немає конкурентів з усіма трьома
| Інструмент | Протокол агента поштова скринька/відправлена пошта JSON |
Ланцюг доказів SHA-256 запечатаний |
Електронний підпис людини затвердити виправлення |
Витрати/запуск |
|---|---|---|---|---|
| Інспектор полюбованості | ✅ | ✅ | ✅ | $0.00 |
| Пейсмен МКП | ✅ | ❌ | ❌ | варіюється |
| Ketryx (лікарські засоби тільки) | ❌ | ✅ | ✅ | $$$ |
| Као Волф | ❌ | ❌ | ❌ | $2,000/міс |
| Мабл | ❌ | ❌ | ❌ | $800/міс |
| ТестРигор | ❌ | частковий | частковий | $1,200/міс |
| Девін 2.0 | ❌ | ❌ | ❌ | $500/міс + $5/відтворення |
Дослідження перевірено березень 2026 року серед 15 інструментів. Підсказка FDA щодоштучного інтелекту 2026 року спонукає галузь до того, що ми вже збудували. Регулювання наганяє нас.на 6–12 місяців попереду галузі.
Встановити за 30 секунд
# Solace Інспектор заложений у Solace Browser. # Це використовується за умовчанням додаток — завжди присутній, не можна видалити. # Якщо у вас є Solace Browser: python3 scripts/run_solace_inspector.py --self-diagnostic # Перший раз? Встановіть 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 # Потім покладіть будь-який тестовий спек у vivastreet інбокс/ і запустіть: python3 scripts/run_solace_inspector.py --inbox
Машинозчитувані можливості
Точка /agents.jsonendpoint повертає структуровані можливості для програмного агентського відкриття.