Spec-Zone.ru › AWS CLI v2

[ aws . qbusiness ]

create-retriever

Описание

Добавляет извлекатель в ваше приложение Amazon Q Business.

См. также: Документацию API AWS

Синтаксис

  create-retriever
--application-id <value>
--type <value>
--display-name <value>
--configuration <value>
[--role-arn <value>]
[--client-token <value>]
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--application-id (строка)

Идентификатор вашего приложения Amazon Q Business.

--type (строка)

Тип извлекателя, который вы используете.

Возможные значения:

  • NATIVE_INDEX
  • KENDRA_INDEX

--display-name (строка)

Имя вашего извлекателя.

--configuration (структура помеченного объединения)

Предоставляет информацию о конфигурации извлекателя, используемого для вашего приложения Amazon Q Business.

Примечание

Это структура помеченного объединения. Может быть задан только один из следующих ключей верхнего уровня: nativeIndexConfiguration, kendraIndexConfiguration.

nativeIndexConfiguration -> (структура)

Предоставляет информацию о конфигурации индекса Amazon Q Business, используемого в качестве извлекателя для вашего приложения Amazon Q Business.

indexId -> (строка)

Идентификатор индекса Amazon Q Business.

boostingOverride -> (массив)

Переопределяет значения по умолчанию, используемые Amazon Q Business для усиления документов, относящихся к поддерживаемым типам данных атрибутов.

key -> (строка)

value -> (структура помеченного объединения)

Предоставляет информацию об усилении поддерживаемых типов атрибутов документов Amazon Q Business. Когда поисковый запрос пользователя соответствует атрибутам документов, которые были усилены, Amazon Q Business приоритизирует предоставление ответов из контента, соответствующего усиленным атрибутам документов.

Примечание

Для использования атрибутов типа STRING и STRING_LIST для усиления на консоли и в API, они должны быть включены для поиска с помощью объекта DocumentAttributeConfiguration API UpdateIndex. Если вы не включили поиск по этим атрибутам, вы не сможете усилить атрибуты этих типов данных ни на консоли, ни в API.

Для получения дополнительной информации о том, как работает усиление атрибутов документов в Amazon Q Business, см. Усиление с помощью атрибутов документов.

Примечание

Это структура помеченного объединения. Может быть задан только один из следующих ключей верхнего уровня: numberConfiguration, stringConfiguration, dateConfiguration, stringListConfiguration.

numberConfiguration -> (структура)

Предоставляет информацию об усилении атрибутов документов типа NUMBER.

boostingLevel -> (строка)

Указывает время действия усиления, в секундах, для атрибута документа типа NUMBER.

boostingType -> (строка)

Указывает, на сколько усиливается атрибут документа.

stringConfiguration -> (структура)

Предоставляет информацию об усилении атрибутов документов типа STRING.

boostingLevel -> (строка)

Указывает, на сколько усиливается атрибут документа.

attributeValueBoosting -> (массив)

Указывает определенные значения атрибута документа типа STRING, которые усиливаются.

key -> (строка)

value -> (строка)

dateConfiguration -> (структура)

Предоставляет информацию об усилении атрибутов документов типа DATE.

boostingLevel -> (строка)

Указывает, на сколько усиливается атрибут документа.

boostingDurationInSeconds -> (целое число)

Указывает время действия усиления, в секундах, для атрибута документа типа DATE.

stringListConfiguration -> (структура)

Предоставляет информацию об усилении атрибутов документов типа STRING_LIST.

boostingLevel -> (строка)

Указывает, на сколько усиливается атрибут документа.

kendraIndexConfiguration -> (структура)

Предоставляет информацию о конфигурации индекса Amazon Kendra, используемого в качестве извлекателя для вашего приложения Amazon Q Business.

indexId -> (строка)

Идентификатор индекса Amazon Kendra.

Синтаксис JSON:

{
  "nativeIndexConfiguration": {
    "indexId": "string",
    "boostingOverride": {"string": {
          "numberConfiguration": {
            "boostingLevel": "NONE"|"LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH",
            "boostingType": "PRIORITIZE_LARGER_VALUES"|"PRIORITIZE_SMALLER_VALUES"
          },
          "stringConfiguration": {
            "boostingLevel": "NONE"|"LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH",
            "attributeValueBoosting": {"string": "LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH"
              ...}
          },
          "dateConfiguration": {
            "boostingLevel": "NONE"|"LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH",
            "boostingDurationInSeconds": long
          },
          "stringListConfiguration": {
            "boostingLevel": "NONE"|"LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH"
          }
        }
      ...}
  },
  "kendraIndexConfiguration": {
    "indexId": "string"
  }
}

--role-arn (строка)

ARN роли IAM, используемой Amazon Q Business для доступа к учетным данным проверки подлинности, хранящимся в секрете Secrets Manager.

--client-token (строка)

Токен, который вы предоставляете для идентификации запроса на создание извлекателя приложения Amazon Q Business.

--tags (список)

Список пар ключ-значение, которые идентифицируют или категоризируют извлекатель. Вы также можете использовать теги для управления доступом к извлекателю. Ключи и значения тегов могут содержать буквы, цифры, пробелы Unicode и следующие символы: _ . : / = + - @.

(структура)

Список пар ключ/значение, которые идентифицируют индекс, FAQ или источник данных. Ключи и значения тегов могут содержать буквы, цифры, пробелы Unicode и следующие символы: _ . : / = + - @.

key -> (строка)

Ключ тега. Ключи нечувствительны к регистру и должны быть уникальными для приложения Amazon Q Business или источника данных.

value -> (строка)

Значение, связанное с тегом. Значение может быть пустой строкой, но не может быть null.

Упрощенный синтаксис:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное значение JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или с значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, это выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверит входные данные команды и вернет пример выходного JSON для этой команды. Сгенерированный каркас JSON нестабилен между версиями AWS CLI и не гарантируется обратная совместимость в сгенерированном каркасе JSON.

Глобальные параметры

--debug (булево)

Включить отладочную запись журнала.

--endpoint-url (строка)

Переопределить значение URL по умолчанию для команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с услугами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • таблица
  • yaml
  • yaml-потоковый

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить вывод цвета.

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр предоставлен.

--ca-bundle (строка)

Файл пакета сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пагинатор cli для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров ввода CLI.

Вывод

retrieverId -> (строка)

Идентификатор используемого извлекателя.

retrieverArn -> (строка)

Amazon Resource Name (ARN) роли IAM, связанной с извлекателем.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API