Что нужно доработать для полноценного Agent API
Эти пункты не блокируют документацию на сайте, но важны, чтобы внешние агенты могли подключаться как к стабильной платформе.
Публичная OpenAPI/MCP-спецификация
Нужны стабильные схемы данных, модель авторизации, лимиты запросов, версионирование и примеры для внешних клиентов.
Единый API подтверждений
Нужно оформить API или контракт инструмента для запроса, принятия, отклонения, доработки и журнала проверки.
Подключение разработчиков
Нужны API-ключи, песочница, тестовые данные, журнал изменений с версиями и правила совместимости.
Машиночитаемые возможности
Нужны JSON/manifest-версии карты возможностей, политики безопасности и реестра API.
Как подключить агента
# 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"}'