Method: projects.generateProductText

Формирует набор возможных текстовых дополнений/ответов на основе информации о продукте.

HTTP-запрос

POST https://productstudio.googleapis.com/v1/{parent=projects/*}:generateProductText

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Проект для совершения звонка. Должен ссылаться на проект звонящего. Формат: projects/{project-id} .

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Поля
titleExamples[]

object ( TitleExample )

Необязательно. Предоставьте несколько примеров улучшений заголовков, созданных вручную и соответствующих вашему варианту использования. TiDe — это универсальный инструмент для работы с несколькими категориями товаров, но для вашего бренда может потребоваться индивидуальная функциональность. Не стесняйтесь указать это здесь.

productInfo

object ( ProductInfo )

Обязательно. Доступная информация о продукте. Используется для информирования моделей genAI.

outputSpec

object ( OutputSpec )

Необязательные. Параметры конфигурации, которые напрямую влияют на то, какой контент генерируется и как он отображается в конечном ответе.

Тело ответа

Текст, сгенерированный для предоставленного продукта.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Поля
attributes

map (key: string, value: string)

Любые другие сгенерированные атрибуты

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

title

object ( ProductTextGenerationSuggestion )

Сгенерированное название.

description

object ( ProductTextGenerationSuggestion )

Сгенерированное описание.

metadata

object ( ProductTextGenerationMetadata )

Дополнительная информация, которую клиенты могут захотеть проверить в отношении генерации.

Информация о продукте

Доступная информация о продукте. Используется для создания моделей genAI.

JSON-представление 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Поля
productAttributes

map (key: string, value: string)

Обязательно. Сопоставление всех доступных атрибутов товара. Это может включать название, описание, бренд, пол, цвет, размер и т. д.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

productImage

object ( Image )

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

OutputSpec

Параметры конфигурации, которые напрямую влияют на то, какой контент генерируется и как этот контент отображается в конечном ответе.

JSON-представление 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Поля
workflowId

string

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

tone

string

Необязательно. Желаемый тон выводимого текста. Например, серьёзный, неформальный.

editorialChanges

string

Необязательно. Любые редакционные изменения в сгенерированных данных о продукте, например, замените «S» на «S». Не изменяйте цвет, если он уже есть.

TitleExample

Пример улучшения названия продукта, созданный вручную. Эти примеры предоставляются ИИ для улучшения его качества.

JSON-представление 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Поля
productInfo

map (key: string, value: string)

Обязательно. Карта, содержащая всю существующую информацию о товарах. Например, {"title": "dress", "description": "A red dress", "brand": "Dresses4All"}. Любая информация, которую вы можете использовать для заполнения своего фида товаров.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

finalProductInfo

map (key: string, value: string)

Обязательно. Карта в том же формате, что и productInfo, но со всеми улучшениями. Например, {"brand": "Dresses4All", "product": "dress", "color": "red", ...}. Теперь расположите эти атрибуты в том порядке, в котором они должны отображаться в конечном заголовке. Например, вышеприведённый вариант будет выглядеть так: Dresses4All dress | red.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

titleFormat

string

Обязательно. Атрибуты или приблизительные атрибуты, составляющие заголовок. Например, заголовок «Google GShoe M». Формат заголовка может быть следующим: «бренд | продукт | размер».

category

string

Обязательно. Категория товара. Это помогает ИИ понять, когда одни примеры более релевантны, чем другие.

ProductTextGenerationSuggestion

Текст, сгенерированный для продукта, по желанию включающий оценку его качества.

JSON-представление 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Поля
text

string

Текст сгенерирован

score

number

Показатель качества, связанный с генерацией. Эвристика реализована в соответствии со стилями реализации команды Feedgen.

changeSummary

string

Краткое описание всех внесенных изменений.

ProductTextGenerationMetadata

Тип данных-оболочка для любых метаданных, связанных с генерацией текста.

JSON-представление 
{
  "metadata": {
    object
  }
}
Поля
metadata

object ( Struct format)

Метаданные — довольно расплывчатое понятие. Здесь данные моделируются как карта, чтобы показать, что нет гарантированной структуры выходных данных после простой ассоциации K:V. Первый вариант использования — отслеживание слов, добавленных/удалённых/изменённых в поколениях.