Поиск быстрых ответов
Описание
Ищет существующие быстрые ответы Amazon Q в Connect в базе знаний Amazon Q в Connect.
См. также: Документацию API AWS
search-quick-responses это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлечь данные из результатов следующих выражений запросов: results
Синтаксис
search-quick-responses
--knowledge-base-id <value>
--search-expression <value>
[--attributes <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--knowledge-base-id (строка)
--search-expression (структура)
Выражение поиска для запроса быстрого ответа.
queries -> (список)
Выражения запроса быстрого ответа.
(структура)
Поля быстрого ответа для запроса быстрых ответов по ним.
Ниже приведен список поддерживаемых имен полей.
- content
- name
- description
- shortcutKey
name -> (строка)
values -> (список)
Значения атрибута для поиска быстрых ответов по ним.
(строка)
operator -> (строка)
allowFuzziness -> (логическое значение)
priority -> (строка)
filters -> (список)
Настройка правил фильтрации, применяемых к результатам запроса быстрого ответа.
(структура)
Поля быстрого ответа для фильтрации результатов запроса быстрого ответа по ним.
Ниже приведен список поддерживаемых имен полей.
- name
- description
- shortcutKey
- isActive
- channels
- language
- contentType
- createdTime
- lastModifiedTime
- lastModifiedBy
- groupingConfiguration.criteria
- groupingConfiguration.values
name -> (строка)
values -> (список)
Значения поля атрибута для фильтрации быстрого ответа по ним.
(строка)
operator -> (строка)
includeNoExistence -> (логическое значение)
orderOnField -> (структура)
Поля атрибутов быстрого ответа, по которым сортируются результаты запроса.
name -> (строка)
order -> (строка)
Синтаксис JSON:
{
"queries": [
{
"name": "string",
"values": ["string", ...],
"operator": "CONTAINS"|"CONTAINS_AND_PREFIX",
"allowFuzziness": true|false,
"priority": "HIGH"|"MEDIUM"|"LOW"
}
...
],
"filters": [
{
"name": "string",
"values": ["string", ...],
"operator": "EQUALS"|"PREFIX",
"includeNoExistence": true|false
}
...
],
"orderOnField": {
"name": "string",
"order": "ASC"|"DESC"
}
}
--attributes (массив)
Определяемые пользователем атрибуты контактов Amazon Connect, которые будут разрешены при возврате результатов поиска.
key -> (строка)
value -> (строка)
Упрощенный синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное значение JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания точки начала постраничного отображения. Это NextToken из ранее обрезанного ответа.
Примеры использования см. в разделе Постраничность в Руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлечению меньшего количества элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничность в Руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов, которые должны быть возвращены в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для продолжения постраничного отображения укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.
Примеры использования см. в разделе Постраничность в Руководстве пользователя AWS Command Line Interface.
--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
- table
- yaml
- yaml-stream
--query (строка)
Выражение JMESPath для использования в фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--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.
Вывод
результаты -> (список)
Результаты поиска быстрого ответа.
(структура)
Результат поиска быстрого ответа.
quickResponseArn -> (строка)
quickResponseId -> (строка)
knowledgeBaseArn -> (строка)
knowledgeBaseId -> (строка)
name -> (строка)
contentType -> (строка)
Тип носителя контента быстрого ответа.
- Используйте
application/x.quickresponse;format=plainдля быстрого ответа, написанного простым текстом. - Используйте
application/x.quickresponse;format=markdownдля быстрого ответа, написанного в формате richtext.
status -> (строка)
contents -> (структура)
Содержание быстрого ответа.
plainText -> (структура помеченного союза)
Контейнер контента быстрого ответа.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть установлен:content.content -> (строка)
markdown -> (структура помеченного союза)
Контейнер контента быстрого ответа.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть установлен:content.content -> (строка)
createdTime -> (метка времени)
lastModifiedTime -> (метка времени)
isActive -> (булево)
description -> (строка)
groupingConfiguration -> (структура)
Конфигурационная информация для групп пользователей, которым доступен быстрый ответ.
criteria -> (строка)
Критерии, используемые для группировки пользователей Amazon Q в Connect.
Следующий список содержит поддерживаемые значения критериев.
-
RoutingProfileArn: Группировка пользователей по их ARN профиля маршрутизации Amazon Connect. Пользователь должен иметь разрешения SearchRoutingProfile и DescribeRoutingProfile при установке этого значения критерия.
values -> (список)
Список значений, определяющих различные группы пользователей Amazon Q в Connect.
- При установке
criteriaна значениеRoutingProfileArn, необходимо предоставить список ARN профилей маршрутизации Amazon Connect в качестве значений этого параметра.
(строка)
shortcutKey -> (строка)
lastModifiedBy -> (строка)
channels -> (список)
Каналы связи Amazon Connect, для которых применяется этот быстрый ответ. Поддерживаемые типы каналов связи включают Chat.
(строка)
language -> (строка)
attributesNotInterpolated -> (список)
Пользовательские атрибуты контакта, которые не разрешаются при возвращении результата поиска.
(строка)
attributesInterpolated -> (список)
Пользовательские атрибуты контакта, которые разрешаются при возвращении результата поиска.
(строка)
tags -> (карта)
Теги для организации, отслеживания или контроля доступа к этому ресурсу.
key -> (строка)
value -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.