77 lines
2 KiB
Markdown
77 lines
2 KiB
Markdown
# Документ 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
|