Method: projects.generateProductText

مجموعه‌ای از تکمیل‌ها/پاسخ‌های متن نامزد را از اطلاعات محصول ایجاد می‌کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

اختیاری. هر گونه تغییر ویرایشی برای داده های محصول تولید شده. به عنوان مثال Small را با "S" جایگزین کنید، در صورت وجود رنگ، آن را تغییر ندهید.

عنوان مثال

نمونه ای دست ساز از بهبود عنوان محصول. این نمونه ها برای بهبود کیفیت آن در اختیار هوش مصنوعی قرار گرفته است.

نمایندگی JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
فیلدها
productInfo

map (key: string, value: string)

مورد نیاز. نقشه ای که شامل تمام اطلاعات محصول موجود است. به عنوان مثال، {"title": "dress"، "description": "یک لباس قرمز"، "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 | قرمز

یک شی حاوی لیستی از "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

امتیاز کیفیت مرتبط با نسل. اکتشافی با توجه به سبک های پیاده سازی تیم فیدژن پیاده سازی شده است.

changeSummary

string

خلاصه ای از تمام تغییرات ایجاد شده.

فراداده ProductTextGeneration

نوع داده Wrapper برای هر ابرداده مرتبط با تولید متن.

نمایندگی JSON 
{
  "metadata": {
    object
  }
}
فیلدها
metadata

object ( Struct format)

ابرداده یک مفهوم بسیار سست است. داده‌ها در اینجا به عنوان نقشه مدل‌سازی می‌شوند تا نشان دهند که هیچ ساختار تضمینی برای خروجی پس از یک ارتباط ساده K:V وجود ندارد. اولین مورد استفاده، ردیابی کلمات اضافه/حذف/تغییر شده در نسل هاست.