Steg 2: anslut Google Sheets

Flera Google Sheets-noder hanterar produktköer, bearbetningsstatus, försäljningsloggning och felloggar.

1. I Retrieve Sheet Rows A väljer ni Document [YOUR_ID] och Sheet Products, och behåller filtret Status inställt på Ready for AI Description.
2. I Retrieve Sheet Rows B väljer ni Document [YOUR_ID] och Sheet ProcessingState.
3. I Append Sheet Row B bekräftar ni att den lägger till rader i Sheet Products med mappade fält som Product ID {{$json['Product ID']}} och Image url {{$json['Image URL']}}.
4. I Update Sheet Row A behåller ni Operation inställt på update och mappar batch number till {{$json['batch number']}} och page_info_next till {{$json.page_info}}.
5. I Update Sheet Row Main säkerställer ni att Operation är update och att Matching Columns inkluderar Product ID.
6. Konfigurera Append Sales Row och Append Zero Sales Row så att de skriver till shopify_daily_sales med Date inställt på {{ DateTime.now().setZone('Australia/Melbourne').minus({days: 1}).toISODate() }} och Total Sales till {{$json.sum_current_price}} eller =0.
7. Konfigurera Log Error to Sheet så att den lägger till i Error_log med timestamp inställt på {{$now}} och Reason of Error inställt på {{$fromAI('Reason_of_Error', ``, 'string')}}.
8. Inloggningsuppgifter krävs: Anslut era googleSheetsOAuth2Api-inloggningsuppgifter till alla Google Sheets-noder (7+ noder hanterar produktdata, status, försäljningsspårning och felloggar).

Steg 3: anslut Shopify och hantering av paginering

Shopify-produkter och ordrar hämtas via HTTP-förfrågningar, där pagineringen bearbetas och lagras för batch-spårning.

1. I Retrieve Shopify Products ställer ni in URL till https://peter-sheppard.myshopify.com/admin/api/2024-04/products.json och frågeparametrarna limit till 200 och page_info till {{$json.page_info_next}}.
2. Inloggningsuppgifter krävs: Anslut era shopifyAccessTokenApi-inloggningsuppgifter till Retrieve Shopify Products.
3. I Parse Pagination Data behåller ni JavaScript-koden som den är för att extrahera page_info_next från Link-headern.
4. I Pagination Check säkerställer ni att villkoret kontrollerar att {{$json.has_next_page}} är true.
5. I Map Batch Fields ställer ni in batch number till {{$('Retrieve Sheet Rows B').item.json['batch number'] + 1}} och page_info till {{$json.page_info}}.

Retrieve Shopify Products skickar utdata parallellt till både Filter Eligible Products och Parse Pagination Data.

Steg 4: konfigurera produktfiltrering och vision-analys

Det här avsnittet filtrerar kvalificerade produkter, validerar ID:n och extraherar visuella attribut från bilder.

1. I Filter Eligible Products behåller ni JavaScript-filterlogiken som kräver giltiga bilder, tom body_html och taggen currSeas:SS2025.
2. I Validate Product ID bekräftar ni att villkoret kontrollerar att {{$json['Product ID']}} inte är tomt.
3. I Cap Items A ställer ni in Max Items till 10 för att begränsa belastningen på AI-bearbetningen.
4. I Image Attribute Review behåller ni Resource inställt på image och Image URLs inställt på {{$json['Image url']}}.
5. Inloggningsuppgifter krävs: Anslut era openAiApi-inloggningsuppgifter till Image Attribute Review.
6. I Map Vision Fields mappar ni content till {{$json.content}} och produktfälten från Cap Items A såsom Product ID {{$('Cap Items A').item.json['Product ID']}}.

Steg 5: konfigurera AI-copywriting och parsning

Copywriting-agenten genererar strukturerad JSON med hjälp av en språkmodell, minne och verktygsintegrationer.

1. I Shopify Copywriting Agent behåller ni Text-prompten enligt konfiguration och säkerställer att alternativet hasOutputParser är aktiverat.
2. OpenRouter Chat Engine är ansluten som språkmodell för Shopify Copywriting Agent — inloggningsuppgifter krävs: Anslut era openRouterApi-inloggningsuppgifter i OpenRouter Chat Engine.
3. Structured Result Parser är ansluten som output parser för Shopify Copywriting Agent — säkerställ att den använder JSON-schemaexemplet för fält som product_id och generated_description.
4. OpenRouter Chat Engine B är ansluten som språkmodell för Structured Result Parser — inloggningsuppgifter krävs: Anslut era openRouterApi-inloggningsuppgifter i OpenRouter Chat Engine B.
5. Perplexity Query Tool är kopplat till Shopify Copywriting Agent för research om leverantörens ursprung — inloggningsuppgifter krävs: Anslut era perplexityApi-inloggningsuppgifter i Perplexity Query Tool (lägg till inloggningsuppgifter i verktygsnodens överordnade agentkontext).
6. Conversation Memory B tillhandahåller minne för Shopify Copywriting Agent; inga inloggningsuppgifter krävs, men behåll Session Key som {{$now.minute}}.
7. I Update Sheet Row Main säkerställer ni att mappningarna använder parsade utdatafält som {{$json.output.generated_description}} och matchar på Product ID.

Steg 6: konfigurera flödet för försäljningsspårning

Den här grenen hämtar betalda ordrar för föregående dag, summerar totaler och loggar resultat till Google Sheets.

1. I Order API Request behåller ni URL inställt på https://re3-shop.myshopify.com/admin/api/2024-04/orders.json och frågeparametrar för föregående dag med {{$now.setZone('Australia/Melbourne').minus({days: 1}).startOf('day')}} och {{$now.setZone('Australia/Melbourne').minus({days: 1}).set({ hour: 23, minute: 59, second: 59, millisecond: 999 })}}.
2. Inloggningsuppgifter krävs: Anslut era shopifyAccessTokenApi-inloggningsuppgifter till Order API Request.
3. I Orders Present Check behåller ni villkoret som verifierar att {{$json.orders}} inte är tomt.
4. Om ordrar finns delar Split Orders List upp arrayen med fieldToSplitOut inställt på orders, och därefter mappar Map Order Fields current_price till {{$json.current_total_price}}.
5. Summarize Totals aggregerar current_price med Aggregation inställt på sum, och därefter skriver Append Sales Row dagens total.
6. Om inga ordrar finns loggar Append Zero Sales Row ett Total Sales-värde på =0.

Steg 7: lägg till felhantering

Fel fångas, analyseras av en agent och loggas i ett Google Sheet.

1. Säkerställ att Error Event Trigger är kopplad till Failure Analysis Agent för att fånga körningsfel.
2. OpenRouter Chat Engine C är ansluten som språkmodell för Failure Analysis Agent — inloggningsuppgifter krävs: Anslut era openRouterApi-inloggningsuppgifter i OpenRouter Chat Engine C.
3. Perplexity Query Tool B är kopplat som verktyg för Failure Analysis Agent — inloggningsuppgifter krävs: Anslut era perplexityApi-inloggningsuppgifter i Perplexity Query Tool B (lägg till inloggningsuppgifter i verktygsnodens överordnade agentkontext).
4. Log Error to Sheet är också kopplad som ett verktyg till Failure Analysis Agent — inloggningsuppgifter krävs: Anslut era googleSheetsOAuth2Api-inloggningsuppgifter till Log Error to Sheet (inloggningsuppgifterna hör till verktygsnoden, men dess utdata styrs av agenten).
5. Basic Memory Cache tillhandahåller minne till Failure Analysis Agent; behåll Session Key inställt på {{$now.minute}}.

Steg 8: testa och aktivera ert arbetsflöde

Kör kontrollerade tester för att bekräfta att varje gren exekverar korrekt innan ni aktiverar schemalagda triggers.

1. Klicka på Execute Workflow på Manual Run Trigger för att testa produktbeskrivningsflödet, och bekräfta sedan att rader uppdateras av Update Sheet Row Main med en Status på generated.
2. Kör tillfälligt Scheduled Trigger B manuellt för att verifiera att Append Sales Row skriver ett Total Sales-värde och korrekt datum.
3. Framkalla ett fel (t.ex. inaktivera en credential) för att bekräfta att Error Event Trigger loggar till Log Error to Sheet.
4. När testerna passerar växlar ni arbetsflödet till Active för att aktivera schemalagda körningar för Five Minute Cron, Scheduled Trigger A och Scheduled Trigger B.