Method: projects.generateProductText

Generuje zestaw proponowanych uzupełnień tekstu lub odpowiedzi na podstawie informacji o produkcie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. wyświetlić projekt, aby zadzwonić; Musi odnosić się do projektu wywołującego. Format: projects/{project-id}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Pola
titleExamples[]

object (TitleExample)

Opcjonalnie. Podaj kilka przygotowanych ręcznie przykładów ulepszeń tytułów, które są unikalne dla Twojego przypadku użycia. TiDe to ogólne narzędzie obsługujące wiele kategorii produktów, ale tożsamość Twojej marki może wymagać niestandardowych funkcji. Możesz to zrobić tutaj.
productInfo

object (ProductInfo)

Wymagany. Dostępne informacje o produkcie. Służy do trenowania modeli generatywnej AI.
outputSpec

object (OutputSpec)

Opcjonalnie. Parametry konfiguracji, które mają bezpośredni wpływ na generowane treści i sposób ich renderowania w odpowiedzi końcowej.

Treść odpowiedzi

Tekst wygenerowany dla podanego produktu.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Pola
attributes

map (key: string, value: string)

inne wygenerowane atrybuty.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Wygenerowany tytuł.
description

object (ProductTextGenerationSuggestion)

Wygenerowany opis.
metadata

object (ProductTextGenerationMetadata)

Dodatkowe informacje, które klienci mogą chcieć sprawdzić w związku z generowaniem.

ProductInfo

Dostępne informacje o produkcie. Służy do trenowania modeli generatywnej AI.

Zapis JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Pola
productAttributes

map (key: string, value: string)

Wymagany. mapowanie wszystkich dostępnych atrybutów produktu; Może to obejmować tytuł, opis, markę, płeć, kolor, rozmiar itp.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

Opcjonalnie. Obraz powiązany z produktem.

OutputSpec

Parametry konfiguracji, które mają bezpośredni wpływ na generowane treści i sposób ich renderowania w odpowiedzi końcowej.

Zapis JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Pola
workflowId

string

Opcjonalnie. Proces do wykonania w przypadku podanych danych o produktach. Przepływy pracy mogą wypełniać tytuł lub opis odpowiedzi albo oba te elementy.
tone

string

Opcjonalnie. Pożądany styl wygenerowanego tekstu, np. poważny lub swobodny.
editorialChanges

string

Opcjonalnie. Wszelkie zmiany redakcyjne w wygenerowanych danych o produkcie, np. zastąpienie słowa „Small” literą „S”, nie modyfikuj koloru, jeśli jest już podany.

TitleExample

Ręcznie przygotowany przykład ulepszenia nazwy produktu. Te przykłady są udostępniane AI, aby poprawić jej jakość.

Zapis JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Pola
productInfo

map (key: string, value: string)

Wymagany. Mapa zawierająca wszystkie istniejące informacje o produkcie, np. {"title": "sukienka", "description": "czerwona sukienka", "brand": "SukienkiDlaKażdego"} Wszelkie informacje, które możesz wykorzystać do wypełnienia pliku danych o produktach.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Wymagany. Mapa w tym samym formacie co productInfo, ale ze wszystkimi ulepszeniami, np. {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Na razie uporządkuj te atrybuty w kolejności, w jakiej mają się pojawiać w ostatecznym tytule. Na przykład powyższy przykład zostanie przekształcony w: Dresses4All dress | red

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Wymagany. Atrybuty lub przybliżone atrybuty, które składają się na tytuł. Na przykład w przypadku tytułu „Google GShoe M” format tytułu może mieć postać „marka | produkt | rozmiar”.
category

string

Wymagany. Kategoria produktu. Dzięki temu AI będzie wiedzieć, kiedy niektóre przykłady są bardziej trafne od innych.

ProductTextGenerationSuggestion

Tekst wygenerowany dla produktu, opcjonalnie z uwzględnieniem jego wyniku jakości.

Zapis JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Pola
text

string

wygenerowany tekst;
score

number

Wynik jakości powiązany z generowaniem. Heurystyka zaimplementowana zgodnie ze stylami implementacji zespołu ds. generowania plików danych.
changeSummary

string

Krótkie podsumowanie wszystkich wprowadzonych zmian.

ProductTextGenerationMetadata

Typ danych opakowujących dla wszystkich metadanych powiązanych z generowaniem tekstu.

Zapis JSON 
{
  "metadata": {
    object
  }
}
Pola
metadata

object (Struct format)

Metadane to dość ogólne pojęcie. Dane są tu modelowane jako mapa, aby wskazać, że poza prostym powiązaniem klucz-wartość nie ma gwarantowanej struktury danych wyjściowych. Pierwszy przypadek użycia to śledzenie słów dodanych, usuniętych lub zmienionych w generowanych treściach.