agent-control-center/docs/spec-series/11_Connector_SDK.md

Документ 11. Connector SDK

Назначение

Спецификация SDK для интеграции внешних систем с Agent Control Center.

1. Требования

Коннектор обязан:

• поддерживать Protocol v1;
• проходить регистрацию;
• отправлять heartbeat;
• публиковать события;
• поддерживать безопасную аутентификацию.

2. Жизненный цикл

Created → Registered → Online → Busy → Offline → Retired

3. Обязательные операции

• register()
• heartbeat()
• capabilities()
• execute()
• cancel()
• upload_artifact()
• download_artifact()
• publish_event()

4. Capability Discovery

Коннектор публикует:

• поддерживаемые инструменты;
• ограничения;
• максимальный размер данных;
• поддерживаемые версии протокола.

5. Безопасность

• TLS 1.3+
• OAuth2/API Key
• Подпись сообщений
• Проверка разрешений
• Ограничение частоты запросов

6. Обработка ошибок

Категории:

• Authentication
• Authorization
• Validation
• Network
• Timeout
• Internal

Повторная отправка допускается только для идемпотентных операций.

7. Совместимость

SDK обязан поддерживать семантическое версионирование и публиковать protocol_version.

8. Рекомендации

• Структурированное логирование
• Метрики Prometheus
• Health endpoint
• Graceful shutdown
• Автоматическое восстановление соединения

Следующий документ

12_Security.md