Manamboatra dingana ara-toekarena feno ho an'ny Shopify

Manamboatra dingana ara-toekarena feno ho an'ny Shopify

Ny fitandremana ny fivarotana e-commerce mahomby dia mitondra ny ampahany amin'ny fanamby. Mitaky fanamarihana tsy tapaka amin'ny fanavaozana ny antsipirihany amin'ny varotra, ny traikefa amin'ny mpanjifa ary ny fanavaozana ny sehatra.

Izany no ahafahan'ny automatisation miditra - tsy toy ny fahafahana fotsiny fa toy ny ilaina mba hitazonana ny fivarotana mihazakazaka mahomby sy amin'ny habeny. Na dia manolotra ekosystems ahitana apps sy drag-and-drop interface, matetika dia mitaky anao ny varotra fahazavana sy ny fanaraha-maso amin'ny fahafahana.

Hiverina ny fanaraha-maso

Aoka ny robots manahy ny zava-mahagaga zavatra!

Aoka ny robots manahy ny zava-mahagaga zavatra!

Indraindray na hariva dia hahatratra ny fetra ianao amin'ny fampiharana an-tserasera sy ny workflows manual ary manomboka mitady safidy. Ny iray amin'ireo safidy toy izany dia ny miala amin'ny fitaovana mifototra amin'ny GUI mankany amin'ny fandaharana pipelines izay manome fahafahana sy ny fitantanana tanteraka.

• Ny fananana tanteraka ny angon-drakitrao
• Fanatsarana mifanaraka amin'ny marika sy ny vokatrao
• Shareable Workflows: fivarotana maromaro dia afaka mampiasa ny asa mitovy amin'ny kely na tsy misy fiovana
• Finoana amin'ny dingana tsirairay amin'ny dingana

Ankehitriny, aoka isika hanadihady ny fomba azontsika atao ny mamorona pipeline CI ho an'ny fanampiana amin'ny fanamafisana ny olana voalaza etsy ambony. Amin'ny alalan'ny fanamafisana ny hevitra, dia hamorona pipeline izahay mba hanatsarana ny dingana asa amin'ny votoatin'ny vokatra. Ny pipeline dia hampiasa ny LLM mba hijery ny vokatra farany ao amin'ny fivarotana, hanatsarana ny lohateny, hanampy ny lohateny SEO sy ny famaritana, ary hiteraka fanamarihana ho an'ny ekipa hanamarinana.

Ny stack

Ity ny zavatra mahatonga ny workflow:

• Shopify - ny toerana misy ny vokatra
• GitHub Actions - ho an'ny orchestration sy ny automation
• ShopCTL — Ny fitaovana amin'ny fametrahana andian-dahatsoratra ho an'ny fanaraha-maso Shopify
• OpenAI API - hanova ny lohateny vokatra, mamorona votoaty SEO, ary manome soso-kevitra
• Python sy ny scripts Bash sasany - ho an'ny logic sy ny fanavaozana

Ny zavatra voalohany voalohany - ny fametrahana ny stack

Aoka isika hanomboka amin'ny fametrahana ny GitHub Actions workflow. Hitehirizana ny pipeline config ao amin'ny.github/workflows/Filazantsara. Mamorona rakitra antsoina hoeenrich-products.ymlao amin'ny directory workflows. Ity rakitra ity dia hampifanaraka ny asa ho an'ny vokatra-namana workflow.

# .github/workflows/enrich-products.yml

name: Shopify Product Enrichment

on:
  workflow_dispatch:

Nyworkflow_dispatchny zava-nitranga ao amin'ny GitHub Actions dia mamela anao hamoaka asa avy amin'ny GitHub interface na amin'ny alalan'ny API, na azonao ataoAtaovy azo antoka fa mihazakazaka automatique izanyAmin'ny fotoana manokana izany.

API Keys

Ilaintsika ny fanalahidy API vitsivitsy mba hanatanterahana ny fametrahana:OPENAI_API_KEYHo an'ny asa sySHOPIFY_ACCESS_TOKENMba hifandray amin'ny fivarotana.

Afaka mahazo ny OpenAI API key avy amin'nyNy kaontinao OpenAI,Ary nametraka izanyAo amin'ny GitHubNy fametrahana token fidirana amin'ny Shopify dia sarotra satria mila mamorona app dummy ianao mba hanao izany.Ny torolàlana ofisialyHahazo ny iray.

ShopCTL

Hampiasa ny aNy fitaovana Command-Linemba hamoaka sy hanatsarana ny vokatra. Aoka isika hamorona hetsika manokana izay azontsika ampiasaina amin'ny famantarana ao amin'ny pipeline. Mamorona rakitra atao hoesetup-shopctl.ymlao amin'ny lisitry ny asa ary manampy ny config manaraka.

# .github/workflows/actions/setup-shopctl.yml

name: Setup ShopCTL
description: Installs Go and ShopCTL CLI
runs:
  using: "composite"
  steps:
    - name: Set up Go
      uses: actions/setup-go@v5
      with:
        go-version: "1.24"

    - name: Install ShopCTL
      shell: bash
      run: |
        sudo apt-get update
        sudo apt-get install -y libx11-dev
        go install github.com/ankitpokhrel/shopctl/cmd/shopctl@main
        echo "$HOME/go/bin" >> "$GITHUB_PATH"

Ankoatra ny asa manokana, mila manampy fametrahana ho an'ny fivarotana miasa isika.shopctleo amin'ny fototry ny repo ary manampy ny config manaraka ao amin'ny rakitra antsoina hoe.shopconfig.ymlHanova ny zava-nitranga rehetra amin'nystore1miaraka amin'ny fivarotana Alias.

# shopctl/.shopcofig.yml

ver: v0
contexts:
    - alias: store1
      store: store1.myshopify.com
currentContext: store1

Ny famaranana ny pipeline

Ny loharano feno ho an'ny pipeline dia azo jerena eto.

Ny loharano feno ho an'ny pipeline dia azo jerena eto.

Ny pipeline dia manana dingana efatra, viz:Export -> Enrich -> Update -> Notify

Stage 1: Export Products

Ny dingana voalohany ao amin'ny pipeline dia ny fanondranana ny vokatra farany avy amin'ny fivarotana.export-productsAo amin'nyenrich-products.ymlNy antontan-taratasy efa natsangana teo aloha.

jobs:
  export-products:
    runs-on: ubuntu-latest
    env:
      SHOPIFY_ACCESS_TOKEN: ${{ secrets.SHOPIFY_ACCESS_TOKEN }} # The secret we set earlier
      SHOPIFY_CONFIG_HOME: ${{ github.workspace }} # This will tell shopctl to use current dir to look for .shopconfig
    outputs:
      has-data: ${{ steps.check.outputs.has_data }}

    steps:
      - name: Checkout repo
        uses: actions/checkout@v3

      - name: Setup ShopCTL
        uses: ./.github/workflows/actions/setup-shopctl

      - name: Export products
        run: |
          mkdir -p data

          # Export latest data (last 7 days) using the shopctl tool as latest_products.tar.gz
          shopctl export -r product="created_at:>=$(date -v -7d +%Y-%m-%d)" -o data/ -n latest_products -vvv

      - name: Check if export has data
        id: check
        run: |
          if [ -s data/latest_products.tar.gz ]; then
            echo "has_data=true" >> "$GITHUB_OUTPUT"
          else
            echo "has_data=false" >> "$GITHUB_OUTPUT"
            echo "No products found to process"
          fi

      - name: Upload exported products
        if: steps.check.outputs.has_data == 'true'
        uses: actions/upload-artifact@v4
        with:
          name: exported-products
          path: data/latest_products.tar.gz

Ny asa ambony dia hamoronaNy fivarotanaAmin'ny alàlan'ny fampiasana ny hetsika voafantina izay namorona teo aloha. Izy io dia hamoaka ny vokatra rehetra natsangana tao anatin'ny 7 andro farany ary hamoaka azy ireo ho toy ny zavakanto raha misy vokatra vaovao.

Stage 2a: Review Catalog

Hampiasa ny OpenAI API izahay mba hijerena ny sampana angon-drakitra vokatra ary hamantatra ny manaraka:

• Ny olana na ny tsy fitovian-kevitra amin'ny marika, karazana vokatra, na karazana vokatra
• Ny fampahalalana tsy misy na tsy mifanaraka amin'ny tahirin-kevitra
• Ny fahasamihafana eo amin'ny fametrahana ny vokatra na ny rafitra vary
• Duplicate na tena mitovy vokatra
• Fanamarihana ankapobeny amin'ny fanatsarana ny kalitaon'ny catalogue sy ny feno azy

review-catalog:
    needs: export-products
    runs-on: ubuntu-latest
    env:
      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

    steps:
      - name: Checkout repo
        uses: actions/checkout@v3

      - name: Download product export
        uses: actions/download-artifact@v4
        with:
          name: exported-products
          path: data/

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.13"

      - name: Install dependencies
        run: pip install openai

      - name: Run catalog review script
        run: |
          # Assuming your script is saved in scripts/review_catalog.py
          python scripts/review_catalog.py \
            data/latest_products.tar.gz \
            data/review_summary.md

      - name: Upload catalog summary
        uses: actions/upload-artifact@v4
        with:
          name: catalog-review-summary
          path: data/review_summary.md

      - name: Final summary
        run: echo "✅ Shopify product catalog review completed!"

Tsarovy nyneedsTe hanatanterahana izany aorian'ny fanondranana ny vokatra sy ny fametrahana azo avy amin'ny fitaovana. Mila mametraka Python ihany koa isika, satria ny famerenana script dia voasoratra amin'ny Python. Azonao ampiasaina amin'ny fiteny rehetra tianao eto. Ny script dia mamoronareview_summary.md, izay alefa ho toy ny fitaovana ao amin'ny dingana manaraka (ny ohatra etsy ambany).

## Identified Issues

### 1. Missing or Inconsistent Information:
- Some products have missing or inconsistent `productType` (e.g. `"gid://shopify/Product/8790718087392"`, `"gid://shopify/Product/879071795632

Ny sample script sy ny prompt dia mety hofound here.

Stage 2b: Enrich Products

Tahaka nyreview-catalogasa, manampy nyenrich-products Ny asaizay hitarika ny script mba hijery ny lohateny vokatra ary hiteraka lohateny SEO sy famaritana ho an'ny vokatra amin'ny fampiasana OpenAI. Ity asa ity dia mihazakazaka miaraka amin'ny fanadihadiana katalaogy asa ary miteraka CSV miaraka amin'ny antsipirihany momba ny metadata hanatsarana.

Ny sample script sy ny prompt dia mety hoHitanao eto.

Stage 3: Update Products

Rehefa vita ny metadata ao amin'ny dingana 2b, dia afaka manatsara ny vokatra amin'ny fampiasanaShopCTLHampiasa script bash isika fa tsy Python amin'ity dingana ity.

Ampiasao asa antsoina hoeupdate-productsAraka ny voalaza etsy ambany.

update-products:
    needs: enrich-products
    runs-on: ubuntu-latest
    env:
      SHOPIFY_ACCESS_TOKEN: ${{ secrets.SHOPIFY_ACCESS_TOKEN }}
      SHOPIFY_CONFIG_HOME: ${{ github.workspace }}

    steps:
      - name: Checkout repo
        uses: actions/checkout@v3

      - name: Setup ShopCTL
        uses: ./.github/workflows/actions/setup-shopctl

      - name: Download enriched products
        uses: actions/download-artifact@v4
        with:
          name: enriched-products
          path: data/

      - name: Apply updates using shopctl
        run: |
          mkdir -p logs
          touch logs/audit.txt

          while IFS=, read -r pid new_title seo_title seo_desc; do
            # Strip leading/trailing quotes
            seo_desc="${seo_desc%\"}"
            seo_desc="${seo_desc#\"}"

            # Use shopctl to update product details
            if output=$(shopctl product update "$pid" \
                --title "$new_title" \
                --seo-title "$seo_title" \
                --seo-desc "$seo_desc" 2>&1); then
                echo "$pid,success" >> logs/audit.txt
            else
              sanitized_error=$(echo "$output" | tr '\n' ' ' | sed 's/,/ /g')
              echo "$pid,failure,$sanitized_error" >> logs/audit.txt
            fi
          done < <(tail -n +2 data/enriched_products.csv)

        - name: Upload audit log
          uses: actions/upload-artifact@v4
          with:
            name: product-audit-log
            path: logs/audit.txt
  
        - name: Final summary
          run: echo "✅ Shopify product enrichment and updates completed!"

Ny asany dia tena tsotra; mampiasa script bash mba hamaky avy amin'ny CSV rakitra nateraky ny dingana teo aloha, fanavaozana ny vokatra amin'ny fampiasana ShopCTL, ary mamorona rakitra log.

Stage 4: Notify

Ankehitriny, ny zavatra sisa dia ny manambara ny olona mahaliana fa ny asa dia vita (na tsy nahavita) ary inona no niova. Azonao atao ny mandefa fampahafantarana Slack na mailaka ny antsipirihany.

notify:
    needs: [review-catalog, update-products]
    runs-on: ubuntu-latest

    steps:
      - name: Download audit log
        uses: actions/download-artifact@v4
        with:
          name: product-audit-log
          path: logs/

      - name: Download catalog review
        uses: actions/download-artifact@v4
        with:
          name: catalog-review-summary
          path: data/

      - name: Print audit summary
        run: |
          ls -lah logs/
          ls -lah data/
          echo "🧾 Shopify Product Update Audit"
          echo "-------------------------------"

          total=$(wc -l < logs/audit.txt)
          updated=$(grep -c ',success' logs/audit.txt || true)
          failed=$(grep -c ',failure' logs/audit.txt || true)

          echo "✅ Success: $updated"
          echo "❌ Failed: $failed"
          echo "📦 Total Processed: $total"
          echo ""
          echo "📋 Detailed Audit:"
          cat logs/audit.txt

      - name: Print catalog review summary
        run: |
          echo ""
          echo "🧠 Catalog Review Summary"
          echo "-------------------------"
          cat data/review_summary.md

Ny hametraka izany rehetra izany

Ny ohatra etsy ambony dia mampiseho ny fomba ahafahanao mampiasa fitaovana misy anao mba hamoronana zavatra tsy manam-paharoa sy mahery vaika, mifanaraka amin'ny toe-javatra fampiasana anao, raha tsy manome angon-drakitra momba ny fitehirizana ho an'ny fampiharana ivelany.

Na dia miala amin'ny zava-dehibe vitsivitsy amin'ny famokarana - toy ny fampiasana trano fivarotana ho an'ny fankatoavana ara-pananahana sy ny fanitsiana fahadisoana ara-drariny - dia manome anao hevitra momba ny fomba hanombohana.

Ny fandraisany

Ity tahan'ny herinaratra sy ny fanaraha-maso ity dia manolotra fahafahana tsy misy fetra - avy amin'ny fanandramana A / B amin'ny kopia vokatra, workflows fanamafisana amin'ny fiteny maro, fanandramana vidin'ny dynamic, sy ny fanadiovana fanadiovana ara-toekarena ho an'ny toro-hevitra manokana ary mihoatra.

Amin'ny dingana tsirairay eo amin'ny fitantanana anao, azonao atao ny manandrana hevitra vaovao, hifanaraka haingana amin'ny fiovan'ny tsena, ary mampitombo ny asanao raha toa ka mitombo ny raharaham-barotra.