From 05f6d9d3055c2def56263cc0f15b3e099f469ec2 Mon Sep 17 00:00:00 2001 From: AgentePotente Date: Tue, 10 Mar 2026 18:36:58 +0100 Subject: [PATCH] agency-orchestrator: supporto estrazione company profile da documento MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Aggiunta Modalità B di onboarding: accettazione documenti (PDF, DOCX, MD, PPTX, TXT) - Estrazione automatica di tutti i campi del questionario da documenti esistenti - Procedura di validazione e conferma dati estratti - Gestione intelligente campi mancanti con assunzioni documentate - Vantaggi: no questionari per il cliente, uso materiali esistenti, più professionale --- agency-orchestrator/SKILL.md | 80 ++++++++++++++++++++++++++++++++---- 1 file changed, 72 insertions(+), 8 deletions(-) diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index ea9c8b2..73b688b 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -1,6 +1,6 @@ --- name: agency-orchestrator -description: "Coordinare agenti, gestire decisioni e qualità per i 5 workflow della suite. Usare quando: (1) avviare nuovo progetto/cliente, (2) attivare uno dei workflow (Analisi, Posizionamento Strategico, Sito Web Aziendale, Landing Page di Prodotto, Strategia Social), (3) coordinare output di più agenti, (4) gestire decisioni, (5) eseguire QA trasversale. Output: Decision log, QA notes, stato progetto." +description: "Coordinare agenti, gestire decisioni e qualità per i 5 workflow della suite. Usare quando: (1) avviare nuovo progetto/cliente, (2) attivare uno dei workflow (Analisi, Posizionamento Strategico, Sito Web Aziendale, Landing Page di Prodotto, Strategia Social), (3) coordinare output di più agenti, (4) gestire decisioni, (5) eseguire QA trasversale. Accetta in input sia questionario di onboarding sia documento company profile (estrazione automatica). Output: Decision log, QA notes, stato progetto." --- # Agency Orchestrator — Coordinamento Multi-Agente @@ -30,9 +30,13 @@ Questa skill coordina 5 workflow principali: --- -## Input — Questionario di Onboarding Cliente +## Input — Due Modalità di Onboarding -Raccogliere queste informazioni prima di avviare il workflow end-to-end: +Questa skill accetta **due modalità di input** per avviare il workflow: + +### Modalità A: Questionario di Onboarding (Tradizionale) + +Raccogliere queste informazioni tramite domande dirette al cliente: ### 1. Informazioni Base Cliente @@ -86,6 +90,59 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: | **Agenti necessari** | array | strategy, design, ux-copy, web-developer | Skills da attivare | | **Priorità** | string | "Veloce" o "Dettagliato" | Approccio preferito | +### Modalità B: Documento Company Profile (Estrazione Automatica) + +In alternativa al questionario, l'orchestratore può accettare un **documento esistente** che descrive il company profile del cliente. + +**Formati supportati:** +- Markdown (`.md`) +- PDF (`.pdf`) +- Documenti Word (`.docx`) +- Presentazioni (`.pptx`) +- Testo strutturato (`.txt`) + +**Informazioni da estrarre automaticamente:** + +L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rilevanti mappandole ai campi del questionario: + +| Campo da Estrazione | Cosa Cercare nel Documento | +|---------------------|---------------------------| +| **Nome cliente/azienda** | Ragione sociale, nome progetto, intestazioni | +| **Settore/Industry** | Descrizioni business, categorie merceologiche | +| **Sito web attuale** | URL, link, riferimenti web | +| **Social esistenti** | Menzioni di piattaforme social, handle, link | +| **Contatto principale** | Email, telefono, persone di riferimento | +| **Obiettivi** | Goal strategici, KPI, target di business | +| **Timeline/Budget** | Deadline, budget, vincoli temporali | +| **Target/Audience** | ICP, buyer personas, segmenti di mercato | +| **Competitor** | Nomi competitor, analisi competitive | +| **Differentiatori** | USP, punti di forza, vantaggi competitivi | +| **Servizi/Prodotti** | Catalogo offerte, prodotti flagship, pricing | +| **Tone of Voice** | Linee guida comunicazione, stile brand | +| **Brand Colors/Assets** | Palette colori, linee guida visive | +| **Vincoli/Note** | Restrizioni, preferenze, requisiti speciali | + +**Procedura di Estrazione:** + +1. **Ricevi documento:** L'utente fornisce path o carica il file +2. **Leggi documento:** Usa `read` o strumenti appropriati per il formato +3. **Estrai informazioni:** Mappa contenuti ai campi del questionario +4. **Valida estrazione:** Verifica che tutti i campi critici siano presenti +5. **Proponi riepilogo:** Mostra all'utente i dati estratti in formato strutturato +6. **Chiedi conferma:** "Ho estratto questi dati dal documento. Procedo o vuoi correggere qualcosa?" +7. **Dopo conferma:** Prosegui con Fase 1 (Setup Progetto) + +**Gestione campi mancanti:** +- Se un campo non è trovabile nel documento, fai un'assunzione ragionevole basata sul contesto +- Documenta tutte le assunzioni in `clients/{client}/ops/decisions.md` +- Segnala all'utente i campi con assunzioni per eventuale correzione + +**Vantaggi Modalità B:** +- ✅ Risparmia tempo al cliente (nessun questionario da compilare) +- ✅ Sfrutta documentazione esistente (business plan, pitch deck, website copy) +- ✅ Maggiore accuratezza (dati già validati e strutturati) +- ✅ Professionalità (lavora con materiali ufficiali del cliente) + --- ## Processo @@ -96,12 +153,16 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: **Azioni:** -1. **Proposta path cliente:** +1. **Ricevi input (Modalità A o B):** + - **Modalità A (Questionario):** Usa dati compilati dal cliente + - **Modalità B (Documento):** Estrai informazioni automaticamente (vedi sezione sopra) + +2. **Proposta path cliente:** - Proponi: `clients/{nome_cliente_lowercase}/` - Esempio: `clients/demo_co_srl/` - **Chiedi conferma esplicita** prima di procedere -2. **Dopo conferma, crea struttura cartelle:** +3. **Dopo conferma, crea struttura cartelle:** ``` clients/{client}/ ├── knowledge/ (company profile, audience, brand) @@ -113,15 +174,18 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: └── published/ (content pubblicato, versionato) ``` -3. **Leggi `references/quality_bar.md`** per standard di qualità +4. **Leggi `references/quality_bar.md`** per standard di qualità -4. **Registra assunzioni in `clients/{client}/ops/decisions.md`** +5. **Registra assunzioni in `clients/{client}/ops/decisions.md`** + - Include dati estratti (se Modalità B) o compilati (se Modalità A) + - Documenta eventuali assunzioni su campi mancanti -5. **Avvia workflow selezionato** coordinando gli agenti necessari +6. **Avvia workflow selezionato** coordinando gli agenti necessari **Regole:** - ✅ **Non bloccare per input mancanti:** fai assunzioni ragionevoli e documentale - ✅ **Tracciabilità:** ogni decisione va nel decision log +- ✅ **Modalità B:** Se estrazione da documento, valida che i dati siano coerenti prima di procedere ---