Модель безопасности
Добронамеренность агента не угадывается по словам. LocalOS ограничивает риск через реестр клиентов, права доступа, песочницу, подтверждения, лимиты запросов, поиск злоупотреблений и журнал действий.
Сначала песочница
Новые агентские клиенты должны начинать с демо-данных, без реальных публикаций, сообщений клиентам, рабочих финансов, внешних ключей доступа и разрушительных действий.
beta/internal
Минимальные права доступа
Первые права доступа: audit:read, services:draft, reviews:draft, content:draft, finance:read, partners:read, approvals:create и publish:request.
beta/internal
Граница подтверждения
Публикации, платежи, удаления, массовые изменения, отправка сообщений и действия во внешних системах не выполняются напрямую. Агент только создаёт запрос на подтверждение.
beta/internal
Поиск злоупотреблений
Флаги: перебор business_id, доступ к чужому бизнесу, ошибки авторизации, попытки без нужных прав, аномальный экспорт, обход подтверждения и несоответствие заявленного сценария поведению.
planned
Журнал действий
Каждый агентский вызов должен оставлять след: клиент, бизнес, действие, риск, краткое описание входа и результата, approval_id, статус, IP, user_agent и created_at.
beta/internal
Как подключить агента
# 1. Прочитать контракт Agent API curl -s "https://localos.pro/api/agent-api/openapi.json" # 2. Проверить политику безопасности curl -s "https://localos.pro/api/agent-api/security/policy" # 3. Запустить самопроверку в песочнице curl -s -X POST "https://localos.pro/api/agent-api/self-test" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"purpose":"подключение в песочнице","checks":["auth","scopes","ledger"]}' # 4. Создать безопасный тестовый запрос на подтверждение curl -s -X POST "https://localos.pro/api/agent-api/approvals/request" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"action_type":"test_publish_review_reply","capability":"reviews.reply.publish","risk_level":"high","requested_scope":"publish:request","input_summary":{"source":"быстрый старт в песочнице"},"proposed_output":"Только тестовый запрос на подтверждение."}' # 5. Запросить рабочий доступ после проверки в песочнице curl -s -X POST "https://localos.pro/api/agent-api/clients/promotion/request" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"requested_scopes":["audit:read","reviews:draft","approvals:create"],"use_case":"Читать аудиты и готовить черновики ответов на отзывы под подтверждением человека.","contact":"ops@example.com"}'