0
전체 감사 추적과 함께.
한 줄을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, 또는 .cursorrules8
14
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
16
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.
모든 주요 인공지능 코딩 에이전트 지원
29
OpenAI 코덱스
다음에 따라 떨어져AGENTS.md. OpenAI 코덱스 및 ChatGPT 에이전트는 이 파일을 읽어 사용 가능한 도구 및 기능을 이해합니다.
윈드서핑
다음에 따라 떨어져.윈드서핑 규칙. 윈드서핑 (Codeium) 이 커서와 정확히 같은 포맷으로 Solace AGI와 상호 작용합니다. 헛점 ZERO.
깃허브 코파일럿
.into.github/copilot-지침.md. Copilot will suggest Solace AGI API 호출을 브라우저 작업에 대해 제안합니다.
도우미
시스템 프롬프트로 전달되ewith--system-prompt solace-도우미.md. 도우미는 모든 웹 상호작용을 자동으로 Solace Browser를 통해 라우팅합니다.
Dev.dev Dev.dev Continue.dev
추가하여.continue/config.json컨텍스트 제공자입니다. Continue는 Solace Browser 자동화를 VS Code와 JetBrains에서 기본 도구로 제공합니다.
클라인
다음에 따라 떨어져.clinerules/ 這個字母是 這個字母是디렉토리입니다. 클라인은 세션 시작시 프로젝트 규칙을 읽어들이고, Solace 기능이 모든 대화에 자동으로 로드됩니다.
루코드
위치.roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/. 루코드 (formerly Roo-클라인) inherits Solace Browser capabilities alongside its agentic coding modes.
구글의 Gemini CLI
추가GEMINI.md프로젝트 루트에 있습니다. Google의 오픈소스 에이전트 CLI는 Claude의 것을 읽는 것과 동일한 방식으로 Solace 지시문을 읽습니다.CLAUDE.md.
구글 줄리스
Jules는 처리합니다AGENTS.mdGitHub 문제에 대해 행동을 취하기 전에. Solace 지시문은 Jules가 리포지토리에서 관련된 웹 작업을 처리할 때 자동으로 나타납니다.
Zed 편집기
규칙을 다음과 같은 곳에 배치하세요.rules 這個規則是 這個規則是프로젝트 루트에(rules) 배치하세요. Zed의 AI 패널은 이를 네이티브로 읽음 — Solace AGI가 Zed AI 어시스턴트에게 즉시 사용 가능해집니다.
제트브레인 AI
추가.idea/ai-가이드라인.md. 제트브레인 AI 어시스턴트는 이 파일을 인텔리J, 파이참, 웹스톰, 모든 제트브레인 IDE에서 읽습니다.
타브니네
다음으로 구성을 통해.tabnine/personalization 這個問題是如何解決的 這個問題是如何解決的. 타브니네의 개인화 파일을 통해 팀의 Toolchain — Solace Browser 자동화를 포함하여 — 가르 칠 수 있습니다.
AI를 복제하십시오.
추가하여.replit을 복제합니다.을 복제합니다.파일의[ai]섹션. AI를 복제하십시오.가 이곳에서 프로젝트 컨텍스트를 읽어옵니다 — Solace AGI가 모든 Replit 작업공간에서 사용할 수 있습니다.
데빈
위치.devin/플레이북/. 데빈은 장기 작업을 시작하기 전에 프로젝트 playbook를 읽습니다 — Solace Browser 도구가 모든 웹 워크플로에서 사용할 수 있습니다.
공장 드로이드
공장 읽기AGENTS.md 그리고 .factory/ 這個字母是 .factory/ 這個字母是 .factory/ 這個字母是 .factory/configs. Droid 에이전트는 소프트웨어 개발 워크플로를 자동화할 때 Solace AGI 기능을 상속합니다.
키로 코드 K
추가.kilocode/rules/ .kilocode/ .kilocode/. 키로 코드 K는 클라인과 동일한 프로젝트 규칙 패턴을 따르며 Solace Inspector가 모든 에이전트 코딩 세션에 대해 로드됩니다.
CLAUDE.md 스니펫 안의 내용
모든 통합 파일은 AI 에이전트가 Solace를 사용하는 방법을 가르칩니다. 여기는 클로드 코드 스니펫 — 프로젝트에 복사하여 에이전트가 즉시 모든 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 ## 25 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를 실행합니다.":"...","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 25 (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
## 25 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를 실행합니다.":"...","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 25 (never console.log spam)
5. E-sign every user-approved action
전체 파일:150Paper 41: One App Database — Firestore + Code-Served Catalogagents.json 보기 (기계 판독 가능)
3개의 API 호출로_hello world
154
156
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.
| 엔드포인트 | 메서드 | 작업 내용 | OAuth3 スコープ |
|---|---|---|---|
/api/navigate | POST | 브라우저에서 URL 로드 | 브라우저.나비게이트 |
/api/click | POST | 178 | 브라우저.클릭 |
/api/fill | POST | 181 | browser.fill을 작성합니다.을 작성합니다. |
/api/screenshot | POST | 현재 페이지를 PNG로 캡처(artifact/에 저장) | 브라우저.스크린샷 |
/api/evaluate | POST | JavaScript 실행(표현식키), 결과 반환 | browser.evaluate를 평가합니다.를 평가합니다. |
/api/snapshot | POST | 페이지의 raw HTML을 캡처 | 브라우저.스냅샷 |
/api/aria-snapshot | GET | ARIA 접근성 트리(구조화된 JSON) | 브라우저.스냅샷 |
/api/dom-snapshot | GET | 보장된 구조 체크를 위한 DOM 스냅샷 트리 | 브라우저.스냅샷 |
/api/page-snapshot | GET | 결합 페이지 스냅샷 (ARIA + DOM + 메타데이터) | 브라우저.스냅샷 |
/api/health | GET | 런타임 준비 상태에 대한 생존 프로브 | (없음) |
/api/status | GET | 205 | (없음) |
/api/part11/status | GET | Part 11 캡처 상태, 세션 ID, 작성된 바이트, 마지막 오류 | (없음) |
/api/part11/config | POST | Part 11 캡처 모드 및 감사 디렉토리 구성 | part11.configure를 구성합니다.를 구성합니다. |
/agents.json | GET | 기계가 읽을 수 있는 기능 매니페스트 | (없음) |
213
모델 컨텍스트 프로토콜은 클로드 코드 및 다른 MCP 호환 도구가 Solace Browser와 네이티브 도구로 연결할 수 있도록 해줍니다. — curl 명령이 필요하지 않습니다. 현재 7개의 도구가 사용 가능합니다: navigate, click, fill, screenshot, snapshot, evaluate, aria_snapshot. Solace AGI, Solace Browser, OAuth3, Software 5.0, Solace Inspector, FDA Part 11, ALCOA+, SOC2, AES-256-GCM, Together.ai, OpenRouter, SHA-256, HITL, BYOK
✅ 로컬 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"
}
226
8 MCP 도구s 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. |
Your Agent와 함께하는 Solace
248
📷 페이지 보기
풀해상도에서 페이지를 스크린샷_capture DOM 스냅샷 및 ARIA 접근성 트리. 에이전트는 구조화된 시각적 + 의미 데이터를 얻습니다. — 더 이상 원시 HTML이 아닙니다.
📄 구조화된 데이터 추출
실행 /api/evaluateJavaScript를 실행하고 구조화된 JSON을 반환합니다. 테이블, 가격, 양식 값 또는 페이지 데이터를 직접 에이전트 contexto로 추출합니다.
🔒 범위 지정된 권한
필요한 사항만 요청하십시오. 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. browser.fill을 작성합니다.을 작성합니다.), 시간 경계 및 취소 가능합니다. 설계에 의해 기본적으로 닫힙니다.
📋 자동 증거
모든 에이전트 동작은 자동으로 로깅, 해시-체인 및 봉인됩니다. 에이전트는 하나의 로깅 코드 라인도 작성하지 않고 감사 트레일을 생성합니다.
♾ 레시피 메모리
260
💸 예산 집행
세션 당 지출 한도를 설정합니다. 전달"예산_usd":0.05토큰 요청에 넣고 Solace가 예산이 충족되면 에이전트를 강제 종료하여 비용이 넘는 경우를 방지합니다.
🔎 증거 검색
과거 실행을 검색합니다./api/evidence/search. 에이전트는 이전 세션에서 무슨 일이 발생했는지 조회할 수 있습니다. "마지막 실행 후 보지 않은 이메일 분류"와 같은 증분 작업에 유용합니다.
🌎 세션 지속성
브라우저 세션은 에이전트 호출 사이에서 유지됩니다. 한 번 로그인하고 세션을 재사용하세요. 재인증 오버헤드가 없습니다. 쿠키, 로컬 저장소 및 인증 토큰이 작업 전반에 걸쳐 유지됩니다.
⚡ 병렬 탭
여러 브라우저 컨텍스트를 동시에 열 수 있습니다. 에이전트는 10 페이지를 동시에 스크레이핑하고 결과를 비교하고 발견을 병합할 수 있습니다. 모두 독립적인 증거 경로로 제공됩니다.
🤖 멀티 에이전트 스워름
여러 개의 독립적인 Solace Browser 인스턴스를 생성할 수 있습니다. 스카웃 에이전트가 탐색하고; 코더 에이전트가 실행합니다; 회의론자 에이전트가 확인합니다. 각 인스턴스에는 자신의 세션, 예산 및 증거 체인이 있습니다. 모든 스케줄러(cron, Cloud Run, GitHub Actions)에서 오케스트레이션 할 수 있습니다.
🛈 전자 서명 & FDA Part 11
모든 승인된 동작은 전자 서명할 수 있습니다: 사용자가 “나는 (Phuc) 이 동작을 검토하고 승인했습니다 [타임스탬프]”를 기록합니다. 서명은 SHA-256으로 해시 체인에 봉인됩니다. FDA 21 CFR Part 11 §11.100 전자 서명 규정 준수.
에이전트 베스트 프랙티스
에이전트를 안정적이고 감사 가능하며 실행 비용이 저렴하게 만드는 패턴입니다.
✅ 클릭하기 전에 스크린샷
항상 호출/api/screenshot클릭 동작 전에 호출하세요. 이 작업은 에이전트가 동작하기 전에 보았던 내용의 증거 레코드를 생성하여 감사 트레일과 실패한 실행의 디버깅에 중요한 역할을 합니다.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
🔎 구조를 위한 스냅샷, 비전을 위한 스크린샷
사용 /api/aria-snapshot(접근성 트리, JSON) 에이전트가 페이지 구조를 이해해야 할 경우에 사용하세요. raw HTML용으로/api/snapshot사용/api/screenshot287
GET /api/aria-snapshot # ARIA JSON 트리 반환 POST /api/snapshot # raw HTML 반환 POST /api/screenshot # PNG 파일 경로 반환
🔒 최소한의 범위 요청
필요한 작업에 대한 오-earth3 범위만 요청하십시오. 읽기 전용 연구 작업은 절대로browser.fill을 작성합니다.을 작성합니다.범위를 가리지 말아야합니다. 좁은 범위는 우연한 부작용을 방지하고 준수 감사에 만족합니다.
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"}
💸 모든 세션에 예산을 설정하십시오
에이전트가 예산 상한 없이 실행되지 않도록 하십시오. 전달예산_usd301
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_...
🌎 인증된 사이트에서 세션 재사용
로그인 한 번으로 세션 토큰을 저장하고 전달하"session_id" 這個字幕是"session_id"306
POST /api/navigate {
"url": "https://app.example.com/inbox",
"session_id" 這個字幕是"session_id": "sess_abc123"
}
에이전트-네이티브가 중요한 이유
AEO: 에이전트 엔진 최적화
검색 크롤러를 위한 SEO와 마찬가지로, AEO는 AI 에이전트를 최적화합니다. Solace AGI는 에이전트를 첫 번째 사용자로 설계한 최초의 플랫폼입니다 — 후회하는 것이 아닙니다.
에이전트가 속일 수 없는 증거
에이전트의 모든 동작은 SHA-256 해시 체인 리시트를 생성합니다. 보안 책임자는 AI가 무엇을 했는지 감사할 수 있습니다. 이사회는 증거를 볼 수 있습니다. 블랙박스가 없습니다.
313
에이전트가 작업을 완료하면 레시피가 됩니다. 다음 번에: $0.001 재생 — LLM 토큰 소비되지 않음. Solace를 사용하는 에이전트는 시간이 지남에 따라 더 빠르고 더 저렴해집니다.
Solace의 비교
316
| 기능 | [PH0]] 브라우저 | 극작가 직관 | 브라우저 사용 / OpenClaw | 바르딘 / 자피어 |
|---|---|---|---|---|
| 세션 지속성 | ✅ 쿠키가 실행 간 생존 | ❌ 기본적으로 임시입니다 | ❌ 세션 메모리 없음 | ✅ 크롬 확장 상태 |
| SHA-256 감사 추적 | ✅ 모든 동작, 해시 체인 | ❌ 내장 없음 | ❌ 없음 | ❌ 로그만 (위조 증명 없음) |
| FDA Part 11 전자 서명 | ✅ 내장 (/api/v1/esign) |
❌ 사용 안됨 | ❌ 사용 안됨 | ❌ 사용 안됨 |
| 예산 / 비용 상한 | ✅ 토큰별 비용 게이트 | ❌ 무제한 (게이트 없음) | ❌ 예산 제어가 없음 | ✅ 계획 제한만 |
| 레시피 리플레이 비용 $0.001 | ✅ 첫 번째 성공적인 실행 후 | ❌ 항상 LLM 비용 | ❌ 항상 LLM 비용 | ✅ Zap 리플레이 (LLM 없음) |
| 에이전트 네이티브 파일 형식 | ✅ 21개 형식 (CLAUDE.md, AGENTS.md…) | ❌ 없음 | ❌ 없음 | ❌ 없음 |
| 348 | ✅ 시간 제한, 취소 가능한 토큰 | ❌ 완전 접근 또는 없음 | ❌ 완전 접근 또는 없음 | ❌ 앱 수준 권한만 |
| 로컬 우선 (클라우드 필요 없음) | ✅ 완전 오프라인으로 실행 | ✅ 예 | ✅ 대부분 | ❌ 클라우드 종속 |
| MCP 서버 | ✅ 7개 도구, JSON-RPC 2.0 (실시간) | ❌ 사용 안됨 | ❌ 사용 안됨 | ❌ 사용 안됨 |
💬 Solace AGI는 Playwright 래퍼가 아닙니다. Playwright 위에 OAuth3 위임 레이어입니다. - 세션 메모리, 증거 체인, 예산 게이트, 에이전트 네이티브 형식을 추가하며 원시 Playwright에는 없는 기능입니다.
이 페이지를 읽는 AI 에이전트입니다
이 섹션은 클로드 코드, Codex, 커서, Copilot 등 이 페이지에 도착한 모든 AI 에이전트를 직접위한 것입니다. 여기에는 정확히 필요한 정보가 가장 유용한 형식으로 작성되어 있습니다.
362
Solace Browser가 실행 중인 경우 (localhost:8888364
Solace가 사용 가능한지 확인:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
367
기능 사양을 프로그래밍 방식으로 가져옵니다. 이는 엔드포인트 이름 및 지원 방법의 정보 출처로 사용합니다. 표준 경로는 /agents.json ( /api/agents.json 아님)입니다.
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonagents.json 보기 ↗
371
비전이 가능한 에이전트라면, 이 패턴을 추천합니다: 네비게이트, 스크린샷, 이미지 분석, 클릭 대상 결정, 실행, 다시 스크린샷으로 확인. 시각적 확인 없이 동작 성공 여부를 가정하지 마십시오.
POST /api/navigate {"url": "..."} POST /api/screenshot {} # 분석 이 POST /api/click {"selector":"#x"} POST /api/screenshot {} # 결과 확인
374
375{"error": ...}Body를 반환합니다. 에이전트는 JSON을 파싱하고 성공 == true일 때만 진행해야 합니다.
# Robust 규칙: # 1) JSON 응답 파싱 # 2) 응답.success가 true가 아니라면 -> 단계 실패 # 3) 경고 메모에 응답 오류 포함 {"success": true, "url": "https://example.com", "status": 200} {"error": "Page.fill: Timeout 30000ms exceeded."}
👥 사람 심각 프로토콜
CAPTCHA, 2FA, 승인 모호성 또는 법적/준수 위험이 발생하면 즉시 작업 호출을 중지합니다. 구조화된 {"escalate": true}382
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
💸 안전한 실행 루프
결정론적 루프를 사용하십시오: 건강, 탐색, 검사, 행동, 검증, 체크포인트. 포함/api/page-snapshot을 얻으십시오387
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
🛈 전자 서명 기록 만들기 방법
390
# After user clicks 승인 in the bottom rail:
POST /api/v1/esign/token
{
"user_id": "phuc@example.com",
"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
# }
다중 에이전트 패턴
복원력 있는 자동화를 위한 3개의 에이전트를 생성합니다: Scout (navigate + screenshot, 읽기 전용, L1 모델) → Solver (click + fill + evaluate, L3 모델) → Skeptic (출력을 증거와 비교, L1 모델). 세 에이전트 모두가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":["브라우저.나비게이트","브라우저.클릭","browser.fill을 작성합니다."],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["브라우저.스냅샷","evidence.read"],"ttl_seconds":60}
# All share: {"run_id를 실행합니다.": "run-abc123"}
에이전트 오류 참조
모든 Solace 오류는 유형화되어 있습니다. 재시도 가능한 오류는 재시도 후 복구됩니다. 재시도 불가능한 오류는 인간의 개입이나 작업 재설계가 필요합니다.
| 코드 | 의미 | 재시도 가능 | 에이전트 동작 |
|---|---|---|---|
SELECTOR_NOT_FOUND | 404 | 아니오 | 호출/api/snapshot구조를 다시 발견하기 위해 |
NAVIGATION_TIMEOUT | 페이지 로딩에 30초 이상 소요됨 | 예 | 지수 백오프을 이용한 재시도 (최대 3번 시도) |
BUDGET_EXCEEDED | 세션 지출 제한에 도달 | 아니오 | 414 |
SCOPE_DENIED | OAuth3 토큰 범위 내에 작업이 없음 | 아니오 | 417 |
HUMAN_REQUIRED | CAPTCHA 또는 2FA 감지 | 아니오 | 호출{"escalate": true}즉시 |
NETWORK_ERROR | 대상 사이트에 도달할 수 없음 | 예 | 423 |
SESSION_EXPIRED | 인증 쿠키 만료 | 아니오 | 재인증 후 마지막 증거 확인점에서 다시 시작 |
ELEMENT_NOT_INTERACTABLE | 요소 숨김 또는 비활성화 | 예 | 2초 대기 후 재시도; 먼저 상태 확인을 위해 스크린샷 |
프라임 위키 — 의미 있는 Wayback Machine
431 첫 다운로드 후 서버가 필요하지 않습니다.
플로우 분할: localhost:8888로컬 캡처/실행을 Solace Browser에서 처리하며,https://solaceagi.com/api/v1/prime-wiki/* 는 공유 커뮤니티 인덱스입니다(push/pull/검색/통계/렌더링). 로컬 전용 모드는 클라우드 인덱스 없이 작동합니다.
📷 750 bytes → 전체 페이지
438
439
🏛 앱스토어 중심 인덱스
웨이백 머신(Wayback Machine, 전체 웹)과 달리 Solace AGI는앱스토어 사이트— Solace 자동화 레시피가 있는 사이트에 중점을 둡니다. 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}
🔒 Pro: 풀 커뮤니티 액세스
무료:자신의 브라우징에서 스냅샷을 수집합니다.
Pro ($28/월):전체 커뮤니티 인덱스에 즉시 액세스 — 모든 앱스토어 사이트의 의미 기억. LLM 다시 발견 건너뛰기. 토큰으로 매월 $10–50 절약합니다.
# 다운로드 모든 앱스토어 코드북 한번에: GET /api/v1/prime-wiki/assets?appstore_only=true # 저장소 ~/.solace/pzip/assets/에 저장: # 로컬 압축 해제, 영원히 — 오프라인 가능
📄 렌더링 API — 서버 측 재구성
인덱싱된 페이지를 직접 API에서 재구성 함. 임베디드 Prime Mermaid FSM 상태 다이어그램이 포함 된 전체 HTML을 반환함._PREVIEW, 스크린샷 및 레시피 디버깅에 유용함.
# 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
🌎 페이지 자산 기여
455
# 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": "..."}
☯ 음양: 에이전트의 온페이지 컴패니언
458add_init_script を追加する を追加する— 탐색, 페이지 리로드, 및 Gmail과 같은 CSP 잠금 페이지에서도 유지됩니다.
▲ Top Rail — 항상 표시됨
모든 페이지 상단에 고정된 32px 바. 표시:[PH0]] Solace 가정→ 브라우저 홈으로 한 번클릭. 플러스 실시간 상태 (아이들 / 실행 중 / 미리 보기 준비 / 완료470
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "실행 중",
"app_name": "Gmail Triage"}
▼ 하단 레일 — 채팅 및 승인
473미리 보기 준비(에이전트가 작업을 준비함),BLOCKED(클래리피케이션이 필요함), 또는FAILED. 사용자가승인 또는 거부482
# WebSocket for real-time agent ↔ Yinyang:
ws://localhost:8888/ws/yinyang
# Push preview for user approval:
{"type": "bottom_rail_update",
"payload": {
"state": "미리 보기 준비",
"preview_text": "Reply to Li Li about...",
"show_approve_reject": true,
"run_id를 실행합니다.": "run-abc123"
}}
🔔 푸시 알림 — 3 채널
에이전트는 현재 페이지를 중단하지 않고 사용자에게 알림을 보낼 수 있습니다. 세 채널:토스트(하단 우측 3초 팝업),팝업(액션 버튼이 있는 모달)인수491
POST /api/yinyang/notify {"type": "push_alert", "channel": "토스트", "message": "Gmail 분-li 완료: 12 개 정리", "priority": "low"} # channel: "토스트" | "팝업" | "인수" # priority: "low" | "high" | "critical"
🌏 모든 페이지에서 작동합니다. — Gmail을 포함하여
레일은 다음과 같이 주입됩니다.극작가 add_init_script を追加する— 동일한 브라우저 콘텍스트에서 모든 네비게이션에 걸쳐 지속됩니다. CSP 잠긴 페이지와 같은Gmail은 Gmail입니다.Free gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. 구글 문서, 그리고개념이 있습니다.JS는 DOM 메소드만 사용합니다 (no).HTML 내장Yinyang은 항상 눈에 띄고, 항상 도달 할 수 있습니다.
Yinyang 채팅 API
사용자가 바닥 레일에서 직접 Yinyang에게 입력할 수 있습니다. 에이전트는 WebSocket을 통해 메시지를 수신하고 응답할 수 있습니다. 이 기능은 명확한 요청, 모호한 승인 또는 태스크 구성 변경에 사용합니다. 모든 메시지는 Part 11 증거 추적에 로깅됩니다.
POST /api/yinyang/chat
Authorization: Bearer <api_key>
{"message": "User says: skip newsletters",
"context": {"run_id를 실행합니다.": "run-abc123"}}
# → {"reply": "Got it. Skipping newsletters..."}
507
508
509
510
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-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 증거
522
GET /api/v1/evidence/{run_id를 실행합니다.}
# {"run_id를 실행합니다.": "run-abc",
# "screenshots": [
# {"step": 1, "url": "...", "sha256": "..."},
# {"step": 2, "url": "...", "sha256": "..."}
# ],
# "seal": {"hash": "sha256:...",
# "signed_at": "..."}}
📄 프라임 위키 스냅샷
에이전트가 새로운 사이트를 방문하면 프라임 위키 스냅샷을 생성합니다. 이는 모든 상호 작용 요소에 대한 색인화된 맵입니다(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는 델타를529530
📝 작동 원리
- 에이전트가 초안을 작성합니다→ 받은 편지함에
534 - 사용자가 초안을 편집합니다→ Solace Browser는 원본과 편집된 텍스트를 비교하고 델타를 추출합니다
- 사용자가 승인합니다→ 델타는 스타일 선호도로 저장됩니다스타일 선호도애플리케이션 및 수신자에 태그 첨부
- 다음 실행→ 에이전트는 시스템 프롬프트에서 스타일 선호도를 받습니다:
“사용자 선호도: 짧은 종료, 느낌표 없음, 참조 번호 항상 언급” - 점수 개선→ 편집 필요 횟수 시간이 지남에 따라 감소함._history 패널에서 수렴 추적.
📊 선호도 API
에이전트는 초안을 생성하기 전에 스타일 선호도를 읽을 수 있습니다. 선호도는 애플리케이션당, 수신자당, 전역적으로 저장됩니다. 사용자가 편집하는 경우 자동으로 캡처되거나 API를 통해 수동으로 가르칠 수 있습니다.
# 초안 작성 전에 선호도 읽기: GET /api/v1/preferences?app=gmail-inbox-triage # {"global": ["concise, 3 sentences max"], # "recipient:li.li@...": [ # "mention reference number", # "no exclamation marks" # ]} # 사용자 편집 자동 캡처: 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 법:551. 인간이 항상 초안을 먼저 본다. 이것은 제한이 아니다 — 이것은 특징이다. 각 승인은 학습 신호이다. 각 편집은 수정이다. 5-10 번의 실행 후, 에이전트는 당신의 목소리로 초안을 작성한다. 50 번의 실행 후, 편집이 거의 필요 없다. 증거 추적은 모든 결정이 인간이 승인했음을 증명한다. 당신의 생산성은 증가하고, 당신의 판단은 기록에 남아 있다.
솔라스 검사 —_manual QA_의 종말
555
556
에이전트 프로토콜
어떤 코딩 에이전트도 JSON 규격을 떨어 뜨린다이나함/. 봉인된 보고서를 받습니다오웃박스/562
증거 체인
모든 검사에는 FDA 21 CFR 11부 건축 증거와 함께 SHA-256로 봉쇄되어 있습니다. 법정 허용. 조작-증명. 영구.
휴먼 전자서명 승인
569
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
# }
🌐 웹 모드
589
모드: "웹"
⚙ CLI 모드
명령 줄 도구. 부 프로세스 실행 + 출력 코드 주장 + stdout/stderr 캡처. 켄트 베크: 무엇을 두려워하는지 테스트하십시오. 모든 CLI에서 어떤 언어로 작동합니다.
모드: "cli"
📡 API 모드
REST/HTTP 엔드포인트. 요청 + 응답 스키마 검증 + 시팅 + 보안 헤더. 제임스 바치 제임스: 이 맥락에서 품질 위험이 무엇입니까?
모드: "api"
597
전문가 위원회 (분석 요청으로 주입)
614
| 도구 | 에이전트 프로토콜 수신함/송신함 JSON |
증거 체인 SHA-256 봉인 |
인간 전자 서명 수정 승인 |
비용/실행 |
|---|---|---|---|---|
| 솔라스 검사 | ✅ | ✅ | ✅ | $0.00 |
| 극작가 MCP | ✅ | ❌ | ❌ | 변동 |
| Ketryx (의료 전용) | ❌ | ✅ | ✅ | $$$ |
| QA 울프 | ❌ | ❌ | ❌ | $2,000/월 |
| 马布尔 | ❌ | ❌ | ❌ | $800/월 |
| 테스트리곤 | ❌ | 일부 | 일부 | $1,200/월 |
| 데빈 2.0 | ❌ | ❌ | ❌ | $500/월 + $5/실행 |
연구 검증 2026년 3월, 15개의 도구를 통해. FDA의 2026년 AI 가이드는 이미 우리가 구축한 내용을 정확하게 추진하고 있습니다. 규제가 우리에게 따라잡고 있습니다.분야보다 6–12 개월 앞서 있습니다.
기계가 읽을 수 있는 기능
엔드포인트는 /agents.json프로그램이 에이전트를 발견할 수 있도록 구조화된 기능을 반환합니다.