Теперь ваш агент ИИ控制рует любой веб-сайт.
С полной аудиторской трассировкой.
Опустите одну строку вCLAUDE.mdFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. 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.
Каждый основной агент кодирования ИИ hỗ-svg_trimmed, Поддерживается
Загрузите правильный формат для вашего помощника ИИ. Каждый файл говорит ИИ точно, как использовать Solace — переход, клик, заполнение, снимок экрана и захват доказательств. Поддерживается 21 формат из коробки.
Клод Код
Перейдите в вашCLAUDE.md. Клод Код будет использовать Solace Browser для любой задачи веб-автоматизации автоматически.
Кодекс OpenAI
Перейдите в вашAGENTS.md. Кодекс OpenAI и агенты ChatGPT читают этот файл, чтобы понять доступные инструменты и возможности.
Курсор
Перейдите в ваш.cursorrules. Курсор будет обращаться к Solace AGI всякий раз, когда вы попросите его взаимодействовать с веб-сайтом.
Виндсерфинг
Перейдите в ваш.윈드서핑 규칙. Виндсерфинг (Codeium) принимает возможности Solace Browser точно как Курсор — в том же формате, без каких-либо препятствий.
Помощник GitHub
Перейти в.github/copilot-instructions.md. Copilot будет предлагать вызовы Solace API для задач браузера.
Помощник
Передайте в качестве системного сообщения с--system-prompt solace-aider.md. Помощник будет автоматически маршрутизировать все взаимодействия веб-браузера через Solace Browser.
Continu.dev Продолжайте.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в корне вашего проекта. Инструмент CLI агента от Google с открытым исходным кодом получает инструкции Solace AGI так же, как он читает Claude'sCLAUDE.md.
Джульес Гугл Джульес Гугл Джульес Гугл Джульес Джульес Гугл Джульес Джульес Гугл Джульес Джульес Джульес Гугл Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джульес Джуль
Jules читаетAGENTS.mdдо выполнения действий по vấnам GitHub. Инструкции Solace появляются автоматически, когда Jules обрабатывает любую задачу, связанную с вебом, в вашем репозитории.
Редактор Zed
Разместите правила в92в корне вашего проекта. Панель ИИ Zed читает эти файлы правил в родном формате — Solace AGI становится доступен помощнику ИИ Zed сразу же.
Разработчик Amazon Q
Добавить в.amazonq/rules/solace.md. Разработчик Amazon Q читает файлы правил в формате markdown из этого каталога для каждой сессии кодирования в вашем проекте.
JetBrains ИИ
Добавить в.idea/ai-руководства.md. Помощник ІИ JetBrains читает этот файл во всех IntelliJ, PyCharm, WebStorm и других средах розробки JetBrains.
Источник: Коди
Поместить контекст в.cody/контекст/solace.md. Cody включает этот файл в контекст извлечения — инструкции Solace отображаются в каждом разговоре Cody.
Табнин
Настройка через. ملف تخصيص Табнин يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.. Файл персонализации Табнин позволяет научить его инструментам вашей команды — включая автоматизацию Solace Browser.
Звертайте AI
Добавить к вашему.replit をreplitする をreplitするфайл[ai]раздел. Звертайте AI считывает контекст проекта отсюда — Solace AGI становится доступным в каждом рабочем пространстве Replit.
Девин
Поместить в.devin/流程书/. Девин считывает книжки проекта перед началом задач с долгим горизонтом — инструменты Solace Browser доступны для любого веб-워크флоу.
Фабрика Дроид
Фабрика читаетAGENTS.md и .фабрика/конфиги. Дроид-агенты наследуют возможности Solace AGI при автоматизации рабочих процессов разработки программного обеспечения.
КилоКод
Добавить в.kilocode/правила/. КилоКод следует одному и тому же шаблону проекта правил, как и Клайн — Solace Browser инструкции загружаются для каждой сессии кодирования агентом.
llms.txt
Стандарт Jeremy Howard для описаний сайтов, читаемых LLM. Поместите его в корень своего проекта, чтобы любой LLM мог понять Solace.
Скачать llms.txtЧто внутри сниппета CLAUDE.md
Каждый файл интеграции учит вашего агента AIExactly, как использовать Solace. Вот сниппет Клод Код — опустите его в свой проект, и ваш агент сразу же поймет все 14 API Solace, сервер 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 сниппетPaper 41: One App Database — Firestore + Code-Served CatalogПросмотр 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/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}
Доказательства захвачены автоматически
→ 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 хеш-цепочка загерметизирована. Каждое действие имеет доказательства изменений.
Полная справочная документация 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/fill | POST | Заполнить поле формы | Браузер.филл |
/api/screenshot | POST | Сделать снимок текущей страницы в формате PNG ( сохра្្அனவே в artifacts/) | Браузер.скренсхот |
/api/evaluate | 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.configure → часть11.configure → часть11.configure |
/agents.json | GET | Читаемый машиной манифест возможностей | (никого) |
MCP Server — Живая Передача
Протокол контекста модели позволяет Клод Код и другим инструментам, совместимым с MCP, подключаться к Solace в качестве родного инструмента — без необходимости использования команд curl. Семь инструментов доступны сегодня: навигация, клик, заполнение, скриншот, моментальный снимок, оценка, снимок aria.
✅ Локальный MCP — Доступен сейчас
# Step 1: start the Сервер MCP (stdio JSON-RPC 2.0)
python3 ~/projects/solace-browser/yinyang_mcp_server.py
# Step 2: add to Клод Код .claude/settings.json:
{
"mcpServers": {
"solace": {
"command": "python3",
"args": ["/path/to/solace-browser/yinyang_mcp_server.py"]
}
}
}
После настройки Клод Код вызывает detect_appsFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. create_scheduleFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. 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 даёт Вашему агенту полную сенсорную и память систему для веба.
📷 Смотреть страницу
Сделайте снимок любой страницы в полном разрешении. Захватите снимки DOM и деревьев доступности ARIA. Ваш агент получает структурированные визуальные и семантические данные — не просто сырой HTML.
📄 Извлечь Структурированные Данные
Запустить /api/evaluateдля выполнения JavaScript и возврата структурированного JSON. Извлеките таблицы, цены, значения форм или любые данные страницы напрямую в контекст вашего агента.
🔒 Ограниченные Права
Запросите только то, что вам нужно. Токены OAuth3 имеют ограниченный объем (Браузер.навигејтFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. Браузер.кликFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. Браузер.филл), ограниченный по времени и отменяемый. Закрыт по умолчанию.
📋 Автоматическое Доказательство
Каждое действие агента автоматически регистрируется, создает цепочку хешей и запечатывается. Ваш агент производит аудиторский след без написания одного строки кода для регистрации.
♾ Память Рецепта
Solace запоминает успешные рабочие процессы как рецепты. При воспроизведении ваш агент полностьюypassет LLM и запускает закэшированный путь за $0.001 — на 99% дешевле, чем повторное открытие.
💸 Контроль бюджета
Установите лимиты расходов за сессию. Проход"presupuesto_usd": 0.05в вашем запросе токена, и Solace жестко ограничивает агента, когда достигнут бюджет — нет расходов без контроля.
🔎 Поиск доказательств
Выполняйте запросы прошлых запусков с/api/evidence/search. Агенты могут найти, что произошло в предыдущих сессиях — полезно для задач, таких как "обработка писем, не виденных с последнего запуска."
🌎 Сохранение сессии
Сеансы браузера сохраняются между вызовами агентов. Войдите один раз, повторно используйте сеанс. Нет накладных расходов на повторную аутентификацию. Cookies, локальное хранилище и токены аутентификации сохраняются между задачами.
⚡ Параллельные вкладки
Откройте несколько контекстов браузера одновременно. Ваш агент может сканировать 10 страниц параллельно, сравнивать результаты и объединять выводы — все с независимыми доказательствами.
🤖 Мульт-агентные рои
Создайте несколько независимых экземпляров Solace Browser. Агенты-разведчики исследуют; агенты-кодеры действуют; агенты-скептики верифицируют. Каждый экземпляр имеет свою собственную сессию, бюджет и цепочку доказательств. Оркестрируйте из любого планировщика (cron, Cloud Run, GitHub Actions).
🛈 Электронная подпись & FDA Part 11
Каждое одобренное действие может быть электронно подписано: пользователь записывает «Я (Фук) просмотрел и одобрил это действие [метка времени]». Подпись запечатана в хеш-цепочку с помощью SHA-256. Соответствует требованиям FDA 21 CFR Part 11 §11.100 электронных подписей.
Лучшие практики агентов
Шаблоны, которые делают вашего агента надежным, аудиторным и дешевым в эксплуатации.
✅ Сcreenshot перед кликом
Всегда вызывайте/api/screenshotдо выполнения действия клика. Это создает запись доказательств того, чтоagt видел до выполнения действия — критически важна для аудит-трейлов и отладки неудавшихся запусков.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
🔎 Снимок для структуры, снимок экрана для зрения
Используйте /api/aria-snapshot(доступность ARIA, дерево JSON) когда ваш агент cần понять структуру страницы. Используйте/api/snapshotдля_raw HTML. Используйте/api/screenshotдля визуальной компоновки и изображений.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
🔒 Запрос минимальных областей
Запрашивайте только те области 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"
}
Почему имеет значение оптимизация движка агента
AEO: Оптимизация движка агента
Как и SEO оптимизирован для поисковых краулеров, AEO оптимизирует для агентов ИИ. Solace AGI - это первая платформа, построенная с агентами как первоклассными пользователями — не как после мысли.
Доказательства, которые ваши агенты не могут фальсифицировать
Каждое действие агента производит хэш-цепочку SHA-256. Ваш CISO может проверить, что сделал ИИ. Ваш совет может увидеть доказательства. Нет черных ящиков.
Рецепты, которые делают агентов умнее
Когда агент завершает задачу, она становится рецептом. В следующий раз: $0.001 воспроизведение — без потребления токенов LLM. Агенты, использующие Solace, становятся быстрее и дешевле за время.
Как Solace сравнивается
Разработчики, выбирающие инструменты автоматизации браузера, задают четыре вопроса: Сохраняет ли он сессии? Создает ли он журнал аудита? Можно ли delegировать ИИ без убытков? Выдержит ли он проверку на соответствие? Вот ответ на каждый вариант.
| Функция | Браузер Solace | Плейвёр прямой | Использование браузера / OpenClaw | Бардин / Запиер |
|---|---|---|---|---|
| Сохранение сеанса | ✅ Файлы cookie сохраняются между запусками | ❌ Эфемерные по умолчанию | ❌ Нет памяти сеанса | ✅ Состояние расширения Chrome |
| SHA-256 аудитный журнал | ✅ Каждое действие, хэш-цепочка | ❌ Нет встроенного | ❌ Нет | ❌ Только журналы (не защита от篡改) |
| FDA Part 11 электронная подпись | ✅ Встроенная (/api/v1/esign) |
❌ Не доступно | ❌ Не доступно | ❌ Не доступно |
| Бюджет / потолок затрат | ✅ Бюджетные ворота на токен | ❌ Неограниченный (без ворот) | ❌ Нет контроля бюджета | ✅ Ограничения плана только |
| Повтор рецепта за $0.001 | ✅ После первого успешного запуска | ❌ Всегда стоимость LLM | ❌ Всегда стоимость LLM | ✅ Повтор запуска (без LLM) |
| Форматы файлов, native для агентов | ✅ 21 формат (CLAUDE.md, AGENTS.md…) | ❌ Нет | ❌ Нет | ❌ Нет |
| OAuth3 делегирование с ограниченным объемом | ✅ Временные, отзывные токены | ❌ Полный доступ или ничего | ❌ Полный доступ или ничего | ❌ Разрешения только на уровне приложения |
| Местный первоклассный (не требуется облачный) | ✅ Запускается полностью автономно | ✅ Да | ✅ В основном | ❌ Зависит от облака |
| Сервер MCP | ✅ 7 инструментов, JSON-RPC 2.0 (в реальном времени) | ❌ Не доступно | ❌ Не доступно | ❌ Не доступно |
💬 Solace AGI не является оберткой Playwright. Это层 делегирования OAuth3 поверх Playwright — добавляющая память сессии, цепочки доказательств, бюджетные ворота и форматы, родные для агентов, которых нет в сыром Playwright.
Если Вы Искусственный Интеллект, Читающий Это
Этот раздел написан напрямую для вас — Клод Код, 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/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
⚠ Контракт ответа (строгий)
Не полагайтесь только на статус 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: Timeout 30000ms exceeded."}
👥 Протокол эскалации для человека
Если вы столкнетесь с CAPTCHA, 2FA, неоднозначностью утверждения или юридическими/соответствующими рисками, остановите вызовы действий немедленно. Верните структурированное{"escalate": true}сообщение вашему хост-оркестратору (не 푸sherите повтора слепо).
{
"escalate": true,
"reason": "2FA required",
"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/screenshot {"full_page":true}
GET /api/status
🛈 Как Создать Электронную Подпись
Когда пользователь одобряет подготовленное вами действие, записьте его электронную подпись. Это создает запись, соответствующую требованиям FDA 21 CFR Part 11 §11.100: кто одобрил, что было одобрено и когда — запечатано в цепочку хэшей. Требуется для регулируемых рабочих процессов.
# After user clicks Одобрить 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
# }
⚡ Шаблон Много-Агент
Создайте три агента для устойчивой автоматизации: 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 имеет тип. Ошибки, которые можно повторить, восстанавливаются с откатом. Не повторяющиеся ошибки требуют человеческого вмешательства или переработки задачи.
| Код | Значение | Повторяемый | Действие агента |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS селектор не совпал с rien | Нет | Вызов/api/snapshotчтобы пересмотреть структуру |
NAVIGATION_TIMEOUT | Страница загрузилась > 30с | Да | Повторить с экспоненциальным откатом (макс. 3 попытки) |
BUDGET_EXCEEDED | Достигнут лимит расходов сессии | Нет | Эскалировать к человеческому оператору для увеличения бюджета |
SCOPE_DENIED | Действие не входит в области OAuth3 токена | Нет | Запросить новый токен с необходимой областью |
HUMAN_REQUIRED | Обнаружен CAPTCHA или 2FA | Нет | Вызов{"escalate": true}немедленно |
NETWORK_ERROR | Целевой сайт недоступен | Да | Повторите попытку через 5с, затем через 30с, затем неудача |
SESSION_EXPIRED | Куки аутентификации устарели | Нет | Повторно аутентифицироваться, затем возобновить с последней контрольной точки доказательства |
ELEMENT_NOT_INTERACTABLE | Элемент скрыт или недоступен | Да | Подождите 2с и повторите попытку; сделать скриншот, чтобы подтвердить состояние сначала |
Prime Вики — Семантическая Машина Вэбэя
Каждая страница, которую посещает Solace AGI, сжимается в 750-байтный семантический снимок — хранящий структуру страницы, намерение, навигацию и ключевые сущности. Из этого 750-байтного семени Solace Browser реконструирует полноценную рабочую HTML-страницу完全 offline. Нет необходимости в сервере после первой загрузки.
Раздел потока: localhost:8888обрабатывает локальный захват/выполнение в Solace Browser, аhttps://solaceagi.com/api/v1/prime-wiki/* является общим общественным индексом (п compartir/поиск/статистика/рендер). Режим работы только с локальным индексом работает без облачного индекса.
📷 750 байт → Полная страница
Машина Вэбэя хранит 100 КБ+ сырой HTML на страницу (100 000 ТБ всего). Solace хранит 750-байтный семантический скелет и реконструирует эквивалентную страницу локально. В 133 раза меньше. Нет центральной зависимости.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
🏛 Индекс, фокусирующийся на Appstore
В отличие от Wayback Machine (весь веб), Solace Browser фокусируется насайтах из appstore— сайтах, для которых есть рецепты автоматизации Solace AGI. GitHub, Gmail, LinkedIn, Substack, Понятие и многое другое. Качество превосходит охват.
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}
🔒 Профессионал: Полный доступ к сообществу
Бесплатно:собирать снимки из вашего собственного просмотра.
Профессионал ($28/мес):немедленно получить доступ к полному индексу сообщества — семантическая память для каждого сайта из appstore. Пропустите повторное открытие LLM. Сэкономьте $10–50/месяц в токенах.
# Загрузите все кодбуки appstore один раз: GET /api/v1/prime-wiki/assets?appstore_only=true # Храните в ~/.solace/pzip/assets/ # Распакуйте локально, навсегда — способен работать офлайн
📄 Render 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 создает снимок Prime Вики. Опт-in для общественного обмена — ваши визиты приносят пользу каждому участнику 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: В compan поного ваших агентов
Каждая страница, которую посещает Solace Browser, получает постоянный двойной наложенный интерфейс. Верхняя панель показывает состояние вашего агента в режиме реального времени. Нижняя панель — это панель чата, где вы можете trực tiếp общаться с Yinyang. Обе панели инъецируются черезañadir_init_script— они переживают навигацию, перезагрузку страниц и CSP-блокированные страницы, такие как Gmail.
▲ Top Rail — Всегда Видимый
Панель 32px, закрепленная вверху каждой страницы. Показывает:[PH0]] Solace home]→ вернуться в домашнюю страницу браузера за один клик. Плюс состояние в реальном времени (IDLE / EXECUTING / PREVIEW_READY / DONE), текущее имя приложения и статистика вращающихся значений (посещенные страницы, вызовы LLM, сохраненная стоимость, продолжительность сеанса).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Нижняя панель — Чат и одобрение
Скрытая панель чата размером 36px в нижней части каждой страницы. Автоматически расширяется, когда состояние достигаетPREVIEW_READY(ваш агент подготовил действие),БЛОКИРОВАН(требуется разъяснение), илиНЕУДАЧА. Пользователь нажимаетОдобрить или Отказаться— ваш агент получает решение через 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-уведомления — 3 канала
Агенты могут отправлять уведомления пользователю без прерывания его текущей страницы. Три канала:тост(3с попап в правом нижнем углу),поп-ап(модальное окно с кнопками действий),завоевание(полноэкранный для критических одобрений). Все каналы являются FSM-защищенными — без предупреждения не сработает без действительной состояние перехода.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "тост",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "тост" | "поп-ап" | "завоевание"
# priority: "low" | "high" | "critical"
🌏 Работает на ВСЕХ страницах — Включая Gmail
Рельсыinject какПлейвёр añadir_init_script— они сохраняются через каждое导航 на одном и том же браузер контексте, включая CSP-защищенные страницы какGmailFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. У Google Документима, иПонятие. Код JS использует только методы 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": "Hi Li Li, thanks for...",
# "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
Когда агент посещает новый сайт, он создает снимок Prime Вики: индексированную карту всех интерактивных элементов (селекторы DOM, роли ARIA, пути действий). Эти снимки обеспечивают будущую проигрывание рецептов за $0,001. Доступны из главной страницы — просмотр, поиск или экспорт в виде диаграмм 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 diffs упомянутый и отредактированный текст, извлекает delta
- Пользователь утверждает→ дельта хранится какпреференция стиляпомечен для приложения + получателя
- Следующий запуск→ агент получает предпочтения стиля в своей системной подсказке:
«Пользователь предпочитает: более короткий подпись, без восклицательных знаков, всегда указывать номер ссылки» - Оценка улучшается→ требуется меньше правок со временем. Сходимость отслеживается в панели истории.
API предпочтений
Агенты могут прочитать предпочтения стиля перед генерацией черновиков. Предпочтения хранятся на уровне приложения, получателя и глобально. Захватываются автоматически при редактировании пользователями — или могут быть выучены вручную через 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@..."}
💡 Правильный шаблон: утверждение, редактирование, обучение
Закон Anti-Clippy:никогда не автоматически одобряйте, никогда не автоматически отправляйте. Человек всегда видит черновик первым. Это не ограничение — это возможность. Каждое одобрение является сигналом обучения. Каждое редактирование является исправлением. После 5–10 запусков, агент создает черновики в вашем стиле. После 50 запусков, ему практически не требуется редактирование. Документальный след доказывает, что каждый решений был одобрен человеком. Ваша производительность увеличивается, и ваше суждение записано.
Инспектор соляции — Конец ручного QA, как мы его знали
Ваши AI-агенты отправляют не протестированный код. Каждая команды разработчиков без структурированного моста QA летит вслепую. Solace Inspector — первый — и единственный — инструмент, который дает AI-агентам кодирования стандартизированный, Evidence-sealed, одобренный человеком протокол QA.
Если ваш AI-агент не использует Solace Inspector, у него плохой QA. Полный стоп.
Протокол агента
Любой кодирующий агент бросает спецификацию JSON впочтовый ящик/. Подбирает запечатанный отчет изOutbox/. Без индивидуальной интеграции. Без SDK. Любой язык. Любая модель.
Цепочка доказательств
Каждый осмотр заверен SHA-256 с помощью архитектурных доказательств FDA 21 CFR Part 11 Court-admissible Tamper-evident Permanent. Not I tested it ” — cryptographic proof.
Одобрение электронной подписью человека
ИИ предлагает исправления. Человек одобряет одним кликом. Анти-Клиппи: nunca автоматическое одобрение. Каждое исправление является решением человека, записанным в журнал. Это убийственная функция. Nothing другое не имеет этого.
Петля 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 Outbox/
cat Outbox/report-my-app-home-001-*.json
# {
# "qa_score": 74,
# "belt": "Yellow",
# "heuristic_issues": [{"type": "accessibility", "msg": "3 images missing alt", "heuristic": "ARIA-1"}],
# "agent_analysis_request": { "system_prompt": "You are Джеймс Бах...", "evidence_summary": {...} },
# "agent_analysis_response": null, ← YOU fill this in with your model
# "fix_proposals": [], ← YOU add proposals here
# "evidence_hash": "sha256:a4f3...", ← cryptographic seal
# "human_approved": false
# }
🌐 Веб-режим
Любое приложение браузера. Перейти + Дерево ARIA + Снимок DOM + Евристика HICCUPPS + полноэкранный скриншот. Работает на localhost, staging, production или публичных URL-адресах.
Мод: "веб"
⚙ Режим CLI
Любой инструмент командной строки. Исполнение подпроцесса + заявление выхода + захват stdout/stderr. Кент Бек: Тест то, чего вы боитесь. Работает на любом CLI на любом языке.
Мод: "cli"
📡 Режим API
REST/HTTP-концеполисы. Запрос + проверка схемы ответа + расписание + заголовки безопасности. Сем Канер: Какой риск качества в этом контексте?
Мод: "Апи"
Следующий Спринт 3
Комитет Экспертов (Введен в качестве аналитических подсказок)
Подтверждено: Ни один из конкурентов не имеет всех трёх
| Инструмент | Протокол агента Входный/выходный ящик JSON |
Цепочка доказательств Защищено SHA-256 |
Электронная подпись человека одобрить исправления |
Стоимость/выполнение |
|---|---|---|---|---|
| Инспектор соляции | ✅ | ✅ | ✅ | $0.00 |
| Плейвёр МКП | ✅ | ❌ | ❌ | варьируется |
| Ketryx (только медицинское применение) | ❌ | ✅ | ✅ | $$$ |
| Као Волф | ❌ | ❌ | ❌ | $2,000/месяц |
| Мабл | ❌ | ❌ | ❌ | $800/месяц |
| ТестРигор | ❌ | частичный | частичный | $1,200/месяц |
| Девин 2.0 | ❌ | ❌ | ❌ | $500/месяц + $5/запуск |
Исследования подтверждены март 2026 года по 15 инструментам. Руководство FDA по ИИ для 2026 года толкает отрасль именно к тому, что мы уже построили. Регулирование догоняет нас.на 6–12 месяцев впереди области.
Установить за 30 секунд
# Solace Inspector встроен в 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 # Затем положите любые тестовые данные в почтовый ящик/ и запустите: python3 scripts/run_solace_inspector.py --inbox
Машинно-читаемые возможности
Этот /agents.jsonконечная точка возвращает структурированные возможности для программаного обнаружения агентов.