Spec-Zone.ru › AWS CLI v2

[ aws . qconnect ]

создать-версию-агента-ai

Описание

Создает версию агента AI в Amazon Q in Connect.

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

Синтаксис

  create-ai-agent-version
--assistant-id <value>
--ai-agent-id <value>
[--modified-time <value>]
[--client-token <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]

Параметры

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

Идентификатор помощника Amazon Q in Connect. Может быть ID или ARN. URL не могут содержать ARN.

--ai-agent-id (строка)

Идентификатор агента AI Amazon Q in Connect.

--modified-time (отметка времени)

Время изменения агента AI должно отслеживаться для создания версии. Этот параметр должен быть указан, чтобы избежать создания версии, когда одновременное обновление базового агента AI возможно. Значение должно быть modifiedTime, возвращенным из запроса на создание или обновление агента AI, чтобы создание версии могло завершиться неудачей, если после указанного времени изменения было произведено обновление агента AI.

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы гарантировать идемпотентность запроса. Если не указан, Amazon Web Services SDK заполняет это поле. Более подробную информацию об идемпотентности см. в разделе Обеспечение безопасности повторных попыток с помощью идемпотентных API.

--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
  • текст
  • таблица
  • 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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

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

Данные версии агента ИИ.

assistantId -> (строка)

Идентификатор помощника Amazon Q в Connect. Может быть либо идентификатором, либо ARN. В URL-адресах не может содержаться ARN.

assistantArn -> (строка)

Amazon Resource Name (ARN) помощника Amazon Q в Connect.

aiAgentId -> (строка)

Идентификатор агента ИИ.

aiAgentArn -> (строка)

Amazon Resource Name (ARN) агента ИИ.

name -> (строка)

Имя агента ИИ.

type -> (строка)

Тип агента ИИ.

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

Настройка агента ИИ.

Примечание

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

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

Настройка агентов ИИ типа MANUAL_SEARCH.

answerGenerationAIPromptId -> (строка)

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

answerGenerationAIGuardrailId -> (строка)

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

associationConfigurations -> (список)

Настройки ассоциаций для переопределения поведения этого агента ИИ.

(структура)

Настройка ассоциации помощника Amazon Q в Connect.

associationId -> (строка)

Идентификатор ассоциации для этой конфигурации ассоциации.

associationType -> (строка)

Тип ассоциации для этой конфигурации ассоциации.

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

Данные конфигурации ассоциации помощника Amazon Q в Connect.

Примечание

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

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

Данные конфигурации ассоциации типа KNOWLEDGE_BASE помощника Amazon Q в Connect.

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

Объект, который можно использовать для указания условий тегов.

Примечание

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

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

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

andConditions -> (список)

Список условий, которые применяются вместе с условием AND.

(структура)

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

orConditions -> (список)

Список условий, которые применяются вместе с условием OR.

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

Список условий, которые применяются вместе с условием OR.

Примечание

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

andConditions -> (список)

Список условий, которые применяются вместе с условием AND.

(структура)

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

Максимальное количество результатов, возвращаемых за страницу.

overrideKnowledgeBaseSearchType -> (строка)

Тип поиска, используемый по отношению к базе знаний для этого запроса. Значения могут быть SEMANTIC, использующим векторные вложения, или HYBRID, использующим векторные вложения и обычный текст

locale -> (строка)

Локаль, определяющая язык и регион, влияющие на язык ответа QueryAssistant.

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

Настройка агентов ИИ типа ANSWER_RECOMMENDATION.

intentLabelingGenerationAIPromptId -> (строка)

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

queryReformulationAIPromptId -> (строка)

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

answerGenerationAIPromptId -> (строка)

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

answerGenerationAIGuardrailId -> (строка)

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

associationConfigurations -> (список)

Настройки ассоциаций для переопределения поведения этого агента ИИ.

(структура)

Настройка ассоциации помощника Amazon Q в Connect.

associationId -> (строка)

Идентификатор ассоциации для этой конфигурации ассоциации.

associationType -> (строка)

Тип ассоциации для этой конфигурации ассоциации.

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

Данные конфигурации ассоциации помощника Amazon Q в Connect.

Примечание

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

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

Данные конфигурации ассоциации типа KNOWLEDGE_BASE помощника Amazon Q в Connect.

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

Объект, который можно использовать для указания условий тегов.

Примечание

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

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

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

andConditions -> (список)

Список условий, которые применяются вместе с условием AND.

(структура)

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

orConditions -> (список)

Список условий, которые применяются вместе с условием OR.

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

Список условий, которые применяются вместе с условием OR.

Примечание

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

andConditions -> (список)

Список условий, которые применяются вместе с условием AND.

(структура)

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

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

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

Максимальное количество результатов, возвращаемых за страницу.

overrideKnowledgeBaseSearchType -> (строка)

Тип поиска, используемый по отношению к базе знаний для этого запроса. Значения могут быть SEMANTIC, использующим векторные вложения, или HYBRID, использующим векторные вложения и обычный текст

locale -> (строка)

Локаль, определяющая язык и регион, влияющие на язык ответа QueryAssistant.

Примечание

Изменение этой локали на любое значение, отличное от en_US, en_GB или en_AU, отключит рекомендации, основанные на транскриптах контактов для помощи агенту, поскольку эта функция не поддерживается на нескольких языках.

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

Настройка агентов ИИ типа SELF_SERVICE.

selfServicePreProcessingAIPromptId -> (строка)

Идентификатор запроса ИИ для предварительной обработки самообслуживания, используемый агентом ИИ SELF_SERVICE.

selfServiceAnswerGenerationAIPromptId -> (строка)

Идентификатор запроса ИИ для генерации ответов самообслуживания, используемый агентом ИИ SELF_SERVICE.

selfServiceAIGuardrailId -> (строка)

Идентификатор направляющих ИИ, используемый агентом ИИ SELF_SERVICE.

associationConfigurations -> (список)

Настройки ассоциаций для переопределения поведения этого агента ИИ.

(структура)

Настройка ассоциации Amazon Q в Connect Assistant.

associationId -> (строка)

Идентификатор ассоциации для этой конфигурации ассоциации.

associationType -> (строка)

Тип ассоциации для этой конфигурации ассоциации.

associationConfigurationData -> (структура помеченного союза)

Данные конфигурации ассоциации Amazon Q в Connect Assistant.

Примечание

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

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

Данные конфигурации ассоциации Amazon Q в Connect Assistant типа KNOWLEDGE_BASE.

contentTagFilter -> (структура помеченного союза)

Объект, который можно использовать для указания условий тегов.

Примечание

Это структура помеченного союза. Только один из следующих ключей верхнего уровня может быть установлен: tagCondition, andConditions, orConditions.

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

Условие узла-листа, которое можно использовать для указания условия тега.

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

andConditions -> (список)

Список условий, которые будут применены вместе с условием AND.

(структура)

Условие узла-листа, которое можно использовать для указания условия тега.

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

orConditions -> (список)

Список условий, которые будут применены вместе с условием OR.

(структура помеченного союза)

Список условий, которые будут применены вместе с условием OR.

Примечание

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

andConditions -> (список)

Список условий, которые будут применены вместе с условием AND.

(структура)

Условие узла-листа, которое можно использовать для указания условия тега.

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

Условие узла-листа, которое можно использовать для указания условия тега.

key -> (строка)

Ключ тега в условии тега.

value -> (строка)

Значение тега в условии тега.

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

Максимальное количество результатов, возвращаемых за страницу.

overrideKnowledgeBaseSearchType -> (строка)

Тип поиска, используемый для поиска в базе знаний для этого запроса. Значения могут быть SEMANTIC, использующим векторные вложения, или HYBRID, использующим векторные вложения и обычный текст.

modifiedTime -> (метка времени)

Время последнего изменения агента ИИ.

description -> (строка)

Описание агента ИИ.

visibilityStatus -> (строка)

Статус видимости агента ИИ.

tags -> (карта)

Теги, используемые для организации, отслеживания или управления доступом к этому ресурсу.

key -> (строка)

value -> (строка)

origin -> (строка)

Указывает источник агента ИИ. SYSTEM для агента ИИ по умолчанию, созданного Q in Connect, или CUSTOMER для агента ИИ, созданного с помощью API-интерфейсов создания агентов ИИ.

status -> (строка)

Статус агента ИИ.

versionNumber -> (длинное целое число)

Номер версии агента ИИ.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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