Steg 2: anslut Gmail för batch-backfill

Konfigurera den historiska backfill-vägen som laddar e-post i veckovisa batchar vid manuell körning.

1. Öppna Manual Start Trigger för att tillåta manuella körningar för backfill.
2. I Initialize Metadata Table, ställ in Operation till executeQuery och behåll den angivna SQL:en för public.emails_metadata.
3. Öppna Generate Weekly Range och bekräfta att Mode är runOnceForEachItem med den angivna JS Code (redigera whenDidICreateMyGmailAccount = DateTime.fromISO('2013-11-01') vid behov).
4. I Split Weeks, ställ in Field To Split Out till weeks och Destination Field Name till after.
5. I Assign Date Window, ställ in after till {{ $json.after }} och before till {{ DateTime.fromISO($json.after).plus(1, 'week').toISODate() }}.
6. I Fetch Gmail Batch, ställ in Operation till getAll, Return All till true, och ställ in Received After till {{ $json.after }} samt Received Before till {{ $json.before }}.
7. Credential Required: anslut era Gmail OAuth2-autentiseringsuppgifter i Fetch Gmail Batch.

Steg 3: sätt upp fältmappning för e-post

Normalisera fält från Gmail-meddelanden till ett konsekvent schema för lagring och embeddings.

1. Öppna Map Email Fields och lägg till tilldelningarna exakt som visat.
2. Ställ in email_text till {{ $json.text }}.
3. Ställ in email_from till {{ $json.from?.text ?? '' }}, email_to till {{ $json.to?.text ?? '' }}, och email_cc till {{ $json.cc?.text ?? ''}}.
4. Ställ in date till {{ DateTime.fromISO($json.date).toISO() }}.
5. Ställ in email_id till {{ $json.id }} och thread_id till {{ $json.threadId }}.
6. Ställ in email_subject till {{ $json.subject }} och attachments till {{ Object.keys($binary).map(item => $binary[item].fileName).filter(item => !!item) }}.

Steg 4: konfigurera databaslagring och upsert

Spara normaliserad e-postmetadata i PostgreSQL och förbered poster för vektorinsättning.

1. Öppna Initialize Metadata Table och bekräfta att SQL:en skapar public.emails_metadata.
2. I Upsert Email Metadata, ställ in Operation till upsert.
3. Ställ in Schema till public och Table till emails_metadata.
4. Behåll Matching Columns inställt på email_id för att säkerställa idempotenta upserts.
5. Credential Required: anslut era Postgres-autentiseringsuppgifter i Initialize Metadata Table och Upsert Email Metadata.

Steg 5: sätt upp embeddings och vektorlagring

Dela upp e-posttexten i chunkar, ladda den i dokument, skapa embeddings och lagra dem i PGVector.

1. Öppna Recursive Text Chunker och ställ in Chunk Size till 2000 och Chunk Overlap till 50.
2. I Standard Data Loader, ställ in JSON Data till {{ $('Map Email Fields').item.json.email_text }} och behåll JSON Mode som expressionData.
3. I metadata för Standard Data Loader, ställ in emails_metadata.id till {{ $('Map Email Fields').item.json.email_id }} och emails_metadata.thread_id till {{ $('Map Email Fields').item.json.thread_id }}.
4. Öppna Ollama Embedding Engine och ställ in Model till nomic-embed-text:latest.
5. I Insert Vector Embeddings, ställ in Mode till insert och Table Name till emails_embeddings.
6. Credential Required: anslut era Postgres-autentiseringsuppgifter i Insert Vector Embeddings.

Embedding-autentiseringsuppgifter i OpenAI-stil ska läggas till i överordnad nod: Ollama Embedding Engine är ansluten till Insert Vector Embeddings som embedding-modell—säkerställ att autentiseringsuppgifter läggs till i Ollama Embedding Engine, inte i undernoderna.

Steg 6: konfigurera logik för manuell körning och platshållare

Styr loopbeteendet för manuella backfills och tillhandahåll en säker slutpunkt för workflowet.

1. Öppna Manual Run Check och ställ in villkoret att utvärdera {{ $('Manual Start Trigger').isExecuted }} (Boolean false).
2. Bekräfta att flödet från Manual Run Check går till No-Op Placeholder när den manuella triggern inte har körts.
3. Lämna No-Op Placeholder som den är för säker avslutning och felsökning.

⚠️ Vanlig fallgrop: Om den manuella triggern lämnas okörd under ett backfill-test kommer flödet att stanna vid No-Op Placeholder och veckoloopen kommer inte att fortsätta.

Steg 7: granska körflödet

Validera end-to-end-vägen så att data flödar från Gmail till Postgres och sedan in i PGVector.

1. Bekräfta Gmail Watch Trigger → Map Email Fields → Upsert Email Metadata → Insert Vector Embeddings → Manual Run Check → No-Op Placeholder.
2. Bekräfta den manuella backfill-vägen: Manual Start Trigger → Initialize Metadata Table → Generate Weekly Range → Split Weeks → Iterate Records → Assign Date Window → Fetch Gmail Batch → Map Email Fields.
3. Säkerställ att Upsert Email Metadata skickar utdata till både Insert Vector Embeddings och Iterate Records baserat på workflow-anslutningarna.

Steg 8: testa och aktivera ert workflow

Kör ett manuellt test, bekräfta lyckad lagring och aktivera sedan automatiseringen.

1. Klicka på Execute Workflow och trigga Manual Start Trigger manuellt för att testa backfill-vägen.
2. Verifiera att Initialize Metadata Table skapar tabellen och att Upsert Email Metadata skriver poster.
3. Bekräfta att Insert Vector Embeddings infogar rader i emails_embeddings och att embeddings genereras.
4. Skicka ett nytt Gmail till den övervakade inkorgen och verifiera att Gmail Watch Trigger startar live-vägen.
5. När testerna passerar, växla workflowet till Active för att köra kontinuerligt.