Приклади

Ці приклади показують перебіг звичайної сесії: про що ви просите, до якого інструмента звертається асистент і що повертається. Ваш асистент сформулює це інакше, і це нормально — важлива послідовність кроків.

Ідентифікатори показано в тому вигляді, у якому вони надходять. Копіюйте їх без змін; вони не призначені для читання чи переформатування.

Приклад 1: від порожнього робочого простору до пекшота

Перше, що потрібно зробити в новому робочому просторі, — додати продукт. До того генерувати немає з чого.

Ви: «Маю три фотографії лляної сорочки. Додай їх до Qamera як один продукт із назвою „Лляна сорочка, екрю", а потім зроби пекшоти».

Асистент: викликає register_product із трьома адресами, name: "Лляна сорочка, екрю", productType: "сорочки"

Зареєстровано як один продукт, id 9f1c2b64-…. Платформа зараз аналізує фотографії — до завершення я не можу замовити генерування.

Асистент: викликає get_products і перевіряє статус

Статус DESCRIBED, отже, все готово.

Ви: «Десять пекшотів, на однорідному тлі».

Асистент: викликає get_presets, щоб побачити доступні стилі, а потім register_packshots із productId та count: 10

Замовлено. Ідентифікатор замовлення 4d8e1a07-…. Це витрачає кредити й виконується у фоні.

Ви: «Готово?»

Асистент: викликає check_generation_status з ідентифікатором замовлення

completed — десять із десяти завдань завершено, без помилок.

Асистент: викликає get_packshots із orderId, щоб повернувся результат лише цього замовлення

Десять пекшотів, ідентифікатори нижче. Переглянути їх?

На що звернути увагу. Асистент звузив get_packshots за orderId. Без цього список повернув би весь вміст робочого простору, починаючи з найновішого, і ви читали б також результати попередніх сесій.

Приклад 2: перегляд перед затвердженням

Списки дають асистентові ідентифікатори, а не зображення. Щоб скласти думку, він має відкрити кожне з них.

Ви: «Перегляньте пекшоти з цього замовлення і скажіть, які варто лишити».

Асистент: викликає get_packshots із orderId, а потім get_packshot_preview для кожного пекшота

Я переглянув усі десять. Сім чисті — продукт по центру, рівне тло, нічого не обрізано біля краю. У двох видно тінь уздовж нижнього краю. Один скадровано щільніше за решту, тож поруч з іншими на картці товару він виглядатиме недоречно.

Ви: «Затвердьте ці сім, решту відхиліть».

Асистент: викликає update_packshot для кожного, з voting: "APPROVED" або voting: "REJECTED"

Готово — сім затверджено, три відхилено. Відхилені лишаються в робочому просторі; скажіть слово, і я заархівую їх через status: "ARCHIVE".

На що звернути увагу. Асистент може висловлюватися лише про ті пекшоти, які справді відкрив через get_packshot_preview. Якщо він оцінює список, якого не переглядав, попросіть спершу показати попередні перегляди.

Про слова. Пекшоти оцінюють значеннями APPROVED / REJECTED. Зображення з фотосесій використовують accepted / rejected та інструмент update_image. Це два окремі словники, і асистент має вжити правильний для кожного типу матеріалу.

Приклад 3: коротке відео із зображення, яке вам подобається

Відео створюється з одного зображення, яке ви вже маєте, а не безпосередньо з продукту.

Ви: «Проведи фотосесію лляної сорочки — надворі, денне світло, чотири зображення, вертикально».

Асистент: викликає get_sceneries, а потім register_photo_shoot із productId, sceneryId, aspectRatio: "4:5", count: 4 та suggestions: "надворі, природне денне світло"

Замовлено, ідентифікатор замовлення b70f5c93-…. aspectRatio для фотосесії обов'язковий, тож я обрав 4:5 для вертикального кадру — скажіть, якщо волієте інший.

Ви: «Покажи результати».

Асистент: викликає get_images із orderId, а потім get_image_preview для кожного

Чотири зображення. На другому світло найкраще показує фактуру тканини.

Ви: «Зроби з нього коротке відео, повільне наближення».

Асистент: викликає register_video із generatedImageId та suggestion: "повільне наближення, продукт лишається в центрі"

Замовлено. Перевірю get_videos за кілька хвилин — відео триває довше, ніж знімки.

Ви: «Готово?»

Асистент: викликає get_videos

Готово, адреса файлу є у відповіді.

Як отримати від цього більше

• Називайте конкретні числа та формат. «Десять пекшотів» і «вертикально, 4:5» доходять до інструментів як параметри. «Кілька зображень» — ні.
• Просіть попередній перегляд перед оцінкою. Асистент, який не відкрив зображення, не може його оцінити.
• Вказуйте пресет, коли важлива узгодженість. Саме пресети роблять другу партію схожою на першу.
• Стежте за кредитами. Кожен крок register_… їх витрачає; перегляд, попередні перегляди та оцінювання — ні.
• Кажіть, про яке замовлення йдеться. Звуження за orderId — це різниця між результатами цієї сесії та всім, що ви коли-небудь генерували.