Глава 5: Механизм Обнаружения

5.1 Обзор

Discovery Mechanism определяет, как потребители навыков находят и получают Skill Descriptors в децентрализованной сети. Протокол предоставляет три взаимодополняющих пути обнаружения.

5.2 Обнаружение через Well-Known URI

GET https://{domain}/.well-known/skill-sharing

Формат Ответа: Индекс Навыков

{
  "protocol": { "version": "1.0.0" },
  "provider": { "name": "Example Corp", "url": "https://example.com" },
  "skills": [
    { "id": "com.example.translate-v1", "name": "Universal Translator", "capability_type": "api", "description": "Высококачественный сервис перевода текста", "descriptor_url": "https://example.com/skills/translate/descriptor.json", "access": "restricted", "version": "2.1.0" }
  ]
}

Поля Индекса Навыков

Поле	Тип	Обязательно	Описание
protocol	ProtocolVersion	Да	Версия протокола
provider	object	Да	Информация о провайдере
skills	SkillIndexEntry[]	Да	Список навыков

5.3 Обнаружение по Прямому URL

GET https://example.com/skills/translate/descriptor.json

5.4 Обнаружение через Реестр (Опционально)

GET {registry_url}/skills?type={capability_type}

5.5 Контроль Доступа и Обнаружение

Политика Доступа	Неаутентифицированное обнаружение	Аутентифицированное обнаружение	Вызов
public	✓ Видимо	✓ Видимо	Без аутентификации
restricted	✓ Видимо	✓ Видимо	Требуется аутентификация
private	✗ Не видимо	✓ Видимо	Требуется аутентификация

5.6 Фильтрация по Типу Возможности

GET /.well-known/skill-sharing?type=api

5.7 Уникальность Идентификатора Навыка

Формат: {reverse_domain}.{skill_name}-v{major_version}

Примеры: com.example.translate-v1, org.openai.gpt4-v1