Przykłady

Te przykłady pokazują przebieg typowej sesji: o co prosisz, po które narzędzie sięga asystent i co wraca. Twój asystent sformułuje to inaczej i nie ma w tym nic złego — liczy się kolejność kroków.

Identyfikatory pokazujemy w takiej postaci, w jakiej przychodzą. Kopiuj je bez zmian; nie są przeznaczone do czytania ani do przeformatowania.

Przykład 1: od pustego workspace'u do packshotu

Pierwsze, co trzeba zrobić w nowym workspace, to dodać produkt. Wcześniej nie ma z czego generować.

Ty: „Mam trzy zdjęcia lnianej koszuli. Dodaj je do Qamery jako jeden produkt o nazwie »Koszula lniana, ecru«, a potem zrób mi packshoty."

Asystent: wywołuje register_product z trzema adresami, name: "Koszula lniana, ecru", productType: "koszule"

Zarejestrowane jako jeden produkt, id 9f1c2b64-…. Platforma analizuje teraz zdjęcia — do czasu zakończenia nie mogę zamówić generowania.

Asystent: wywołuje get_products i sprawdza status

Status to DESCRIBED, więc jest gotowe.

Ty: „Dziesięć packshotów, na jednolitym tle."

Asystent: wywołuje get_presets, żeby zobaczyć dostępne style, a potem register_packshots z productId i count: 10

Zamówione. Identyfikator zamówienia 4d8e1a07-…. To kosztuje kredyty i wykonuje się w tle.

Ty: „Gotowe?"

Asystent: wywołuje check_generation_status z identyfikatorem zamówienia

completed — dziesięć z dziesięciu zadań zakończonych, bez błędów.

Asystent: wywołuje get_packshots z orderId, żeby wrócił tylko wynik tego zamówienia

Dziesięć packshotów, identyfikatory poniżej. Mam je przejrzeć?

Na co zwrócić uwagę. Asystent zawęził get_packshots przez orderId. Bez tego lista zwróciłaby całą zawartość workspace'u, od najnowszych, i czytałbyś także wyniki z wcześniejszych sesji.

Przykład 2: ocena przed zatwierdzeniem

Listy dają asystentowi identyfikatory, a nie zdjęcia. Żeby wyrobić sobie zdanie, musi otworzyć każde z nich.

Ty: „Przejrzyj packshoty z tego zamówienia i powiedz, które warto zostawić."

Asystent: wywołuje get_packshots z orderId, a potem get_packshot_preview dla każdego packshotu

Obejrzałem wszystkie dziesięć. Siedem jest czystych — produkt na środku, równe tło, nic nie jest ucięte przy krawędzi. Dwa mają widoczny cień przy dolnej krawędzi. Jeden jest skadrowany ciaśniej niż reszta, więc nie będzie dobrze wyglądał obok pozostałych na karcie produktu.

Ty: „Zatwierdź te siedem, resztę odrzuć."

Asystent: wywołuje update_packshot dla każdego, z voting: "APPROVED" albo voting: "REJECTED"

Gotowe — siedem zatwierdzonych, trzy odrzucone. Odrzucone zostają w workspace; powiedz słowo, a przeniosę je do archiwum przez status: "ARCHIVE".

Na co zwrócić uwagę. Asystent może wypowiadać się wyłącznie o packshotach, które faktycznie otworzył przez get_packshot_preview. Jeśli ocenia listę, której nie obejrzał, poproś, żeby najpierw wyświetlił podglądy.

Słowo o nazewnictwie. Packshoty ocenia się wartościami APPROVED / REJECTED. Zdjęcia z sesji zdjęciowych używają accepted / rejected i narzędzia update_image. To dwa osobne słowniki i asystent musi użyć właściwego dla danego rodzaju materiału.

Przykład 3: krótki film ze zdjęcia, które Ci się podoba

Film powstaje z jednego zdjęcia, które już masz, a nie bezpośrednio z produktu.

Ty: „Zrób sesję zdjęciową lnianej koszuli — plener, światło dzienne, cztery zdjęcia, pionowo."

Asystent: wywołuje get_sceneries, a potem register_photo_shoot z productId, sceneryId, aspectRatio: "4:5", count: 4 i suggestions: "plener, naturalne światło dzienne"

Zamówione, identyfikator zamówienia b70f5c93-…. aspectRatio jest przy sesji wymagany, więc wybrałem 4:5 dla kadru pionowego — daj znać, jeśli wolisz inny.

Ty: „Pokaż wyniki."

Asystent: wywołuje get_images z orderId, a potem get_image_preview dla każdego

Cztery zdjęcia. Na drugim światło najlepiej pokazuje strukturę tkaniny.

Ty: „Zrób z niego krótki film, powolne najechanie."

Asystent: wywołuje register_video z generatedImageId i suggestion: "powolne najechanie, produkt pozostaje na środku"

Zamówione. Sprawdzę get_videos za kilka minut — wideo trwa dłużej niż zdjęcia.

Ty: „Gotowe?"

Asystent: wywołuje get_videos

Gotowe, adres pliku jest w odpowiedzi.

Jak wyciągnąć z tego więcej

• Podawaj konkretne liczby i format. „Dziesięć packshotów" i „pionowo, 4:5" trafiają do narzędzi jako parametry. „Kilka zdjęć" nie.
• Poproś o podgląd przed oceną. Asystent, który nie otworzył zdjęcia, nie może go ocenić.
• Wskaż preset, gdy zależy Ci na spójności. To presety sprawiają, że druga partia wygląda jak pierwsza.
• Pilnuj kredytów. Każdy krok register_… je zużywa; przeglądanie, podglądy i ocenianie nie.
• Mów, o które zamówienie chodzi. Zawężenie przez orderId to różnica między wynikami tej sesji a wszystkim, co kiedykolwiek wygenerowałeś.