Vai al contenuto

🤖 Spiega con IA

Costruire con l’AI

Questa guida ti accompagna nella creazione di prodotti sulla piattaforma 4Geeks e nella loro integrazione con le nostre capacità AI — AI Agents e AI Studio — per creare flussi di lavoro intelligenti e automatizzati.

Creazione dei Prodotti

I prodotti in 4Geeks rappresentano i beni, servizi o piani di abbonamento che offri. Puoi creare e gestire i prodotti programmaticamente tramite l’API REST.

Autenticazione API

Tutte le richieste API richiedono la tua Live API Key passata tramite l’intestazione X-Api-Key:

X-Api-Key: sk_live_your_api_key_here

Ottieni le tue chiavi API dalla dashboard Impostazioni Piattaforma nella scheda API & Webhooks. Consulta Ottieni Chiavi API per i dettagli.

Creare un Prodotto

Invia una richiesta POST per creare un prodotto:

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true
  }'

import requests

response = requests.post(
    'https://api.4geeks.io/v1/products',
    headers={
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Premium Plan',
        'description': 'Full-featured premium subscription with priority support',
        'active': True
    }
)
print(response.json())

const response = await fetch('https://api.4geeks.io/v1/products', {
    method: 'POST',
    headers: {
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Premium Plan',
        description: 'Full-featured premium subscription with priority support',
        active: true
    })
});
const data = await response.json();
console.log(data);

La risposta include il prodotto creato con il suo ID:

{
    "id": "prod_abc123",
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true,
    "created_at": "2026-05-02T10:30:00Z"
}

Elencare i Prodotti

Recupera tutti i tuoi prodotti con paginazione:

curl -X GET 'https://api.4geeks.io/v1/products?limit=10&offset=0' \
  -H 'X-Api-Key: sk_live_your_api_key_here'

import requests

response = requests.get(
    'https://api.4geeks.io/v1/products',
    headers={'X-Api-Key': 'sk_live_your_api_key_here'},
    params={'limit': 10, 'offset': 0}
)
print(response.json())

Risposta:

{
    "items": [
        {
            "id": "prod_abc123",
            "name": "Premium Plan",
            "description": "Full-featured premium subscription with priority support",
            "active": true
        }
    ],
    "total_items": 1,
    "limit": 10,
    "offset": 0
}

Creare un Piano per un Prodotto

Per i prodotti basati su abbonamento, crea un piano collegato al tuo prodotto:

curl -X POST 'https://api.4geeks.io/v1/plans' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "prod_abc123",
    "amount": 4999,
    "currency": "USD",
    "interval": "month"
  }'

L’amount è in centesimi (4999 = $49.99). Intervalli supportati: month, year, week.

Integrazione dei Prodotti con gli AI Agents

Una volta creati i tuoi prodotti, puoi collegarli agli AI Agents di 4Geeks per automatizzare i flussi di lavoro di vendita, supporto e incassi.

Come Funziona

Gli AI Agents di 4Geeks utilizzano il catalogo prodotti e la documentazione come base di conoscenza. Quando un cliente interagisce con un agente, può:

  • Raccomandare prodotti in base alle esigenze del cliente
  • Rispondere alle domande su prezzi, funzionalitĂ  e disponibilitĂ 
  • Elaborare ordini e creare sessioni di checkout
  • Gestire ticket di supporto relativi a prodotti specifici

Passo-Passo: Collegare i Prodotti a un AI Sales Agent

1. Distribuire un AI Sales Agent

Naviga alla Console 4Geeks e clicca Deploy Agent. Seleziona AI Sales Agent e dagli un nome.

2. Impostare la Fonte di Dati di Addestramento

Nella configurazione dell’agente, inserisci l’URL della documentazione del tuo prodotto come Training Data Source. Questo può essere:

  • La pagina del catalogo prodotti
  • Una pagina dei prezzi
  • La documentazione API
  • Un file llms.txt pubblico (vedi sotto)

L’agente analizza questo URL e utilizza il contenuto per rispondere accuratamente alle domande dei clienti.

3. Definire l’Obiettivo dell’Agente

Imposta un obiettivo chiaro per l’agente:

Sell our software products. When a customer asks about features, recommend the
appropriate plan based on their needs. Always mention pricing in USD. Do not
offer discounts higher than 10% without escalation.

4. Collegare un Canale

Scegli come i clienti interagiranno con l’agente:

  • WhatsApp: Collega il tuo account Meta Business per i messaggi
  • Web Chat: Incorpora l’agente sul tuo sito web
  • Voice: Abilita interazioni basate su telefono

Consulta Come Creare un WhatsApp AI Agent per una guida dettagliata.

5. Testare e Andare in Produzione

L’agente viene eseguito prima in un ambiente sandbox. Testa interazioni come:

Customer: "What plans do you offer?"
Agent: "We have three plans: Basic ($19/mo), Pro ($49/mo), and Premium ($99/mo). 
        The Pro plan includes priority support and API access. Would you like to 
        know more about any specific plan?"

Customer: "I need API access for my team of 10."
Agent: "For a team of 10 with API access, I recommend the Pro plan at $49/mo per 
        seat. Would you like me to send you a checkout link to get started?"

Una volta soddisfatto, clicca Go Live per distribuire l’agente in produzione.

Flusso di Lavoro AI Agent + Prodotto

Ecco come funziona l’integrazione completa:

sequenceDiagram
    participant C as Customer
    participant A as AI Agent
    participant K as Knowledge Base
    participant P as 4Geeks API
    participant O as Checkout

    C->>A: "What products do you have?"
    A->>K: Query product catalog
    K-->>A: Return product data
    A-->>C: List products with pricing
    C->>A: "I want the Premium Plan"
    A->>P: Create checkout session
    P-->>A: Return checkout_url
    A-->>C: Send checkout link
    C->>O: Complete payment

AI Support Agent per le Query sui Prodotti

Distribuisci un AI Customer Support Agent per gestire le domande post-vendita sui prodotti:

  1. Imposta la Training Data Source sulla documentazione del prodotto e le FAQ
  2. Definisci l’obiettivo:
Answer customer questions about our products. Help with troubleshooting, 
billing inquiries, and feature explanations. Escalate to a human agent 
if the issue cannot be resolved within 3 interactions.
  1. Collega al tuo canale preferito (WhatsApp, web chat o voice)

L’agente di supporto può fare riferimento a prodotti specifici tramite ID e recuperare dati in tempo reale dal tuo catalogo.

Integrazione con AI Studio

Per funzionalitĂ  personalizzate relative ai prodotti che vanno oltre gli agenti predefiniti, utilizza 4Geeks AI Studio.

Cos’è AI Studio?

AI Studio fornisce un esperto Senior Architect umano potenziato dalla 4Geeks AI Factory — un’infrastruttura che orchestra LLM di prim livello (Claude, Gemini, GPT) per scrivere, testare e refactoring del codice fino a 5 volte piĂą velocemente.

Casi d’Uso per l’Integrazione dei Prodotti

  • Flussi di checkout personalizzati: Crea esperienze di pagamento su misura per i tuoi prodotti
  • Motore di raccomandazione prodotti: Crea un sistema di raccomandazione basato su AI
  • Descrizioni prodotto automatizzate: Genera e aggiorna contenuti dei prodotti su larga scala
  • Integrazioni personalizzate: Collega il tuo catalogo prodotti a strumenti di terze parti (CRM, ERP, analytics)

Iniziare

  1. Vai alla Console 4Geeks
  2. Descrivi i tuoi requisiti di integrazione prodotti
  3. Un Senior Architect viene assegnato al tuo progetto
  4. L’AI Factory accelera lo sviluppo con orchestrazione multi-modello
  5. Rivedi le pull request e distribuisci in produzione

Consulta la panoramica di AI Studio e il Private AI Gateway per maggiori dettagli.

Utilizzo di llms.txt per l’Integrazione AI

4Geeks pubblica un file llms.txt pubblico all’indirizzo:

https://docs.4geeks.io/llms.txt

Cos’è llms.txt?

llms.txt è un file standardizzato che fornisce agli strumenti AI e agli LLM una panoramica concisa e leggibile dalla macchina dell’API 4Geeks. Include:

  • URL base e dettagli di autenticazione
  • Tutti gli endpoint disponibili con metodi, percorsi e descrizioni
  • Formati di richiesta/risposta
  • Esempi di codice in piĂą lingue
  • Codici di errore e pattern

Come Utilizzarlo

Puoi indirizzare i tuoi AI Agents, applicazioni LLM personalizzate o strumenti di sviluppo AI a questo file in modo che comprendano la struttura dell’API 4Geeks senza configurazione manuale:

  1. Dati di Addestramento AI Agent: Aggiungi https://docs.4geeks.io/llms.txt come fonte di dati di addestramento per i tuoi AI Agents
  2. Contesto LLM: Includi il contenuto del file nei tuoi prompt di sistema quando costruisci applicazioni AI personalizzate
  3. Sviluppo Assistito da AI: Gli assistenti AI delle IDE (Cursor, Copilot, ecc.) possono fare riferimento a questo file per generare chiamate API corrette

Esempio: Utilizzare llms.txt in un Prompt di Sistema

You are an AI assistant that helps users integrate with the 4Geeks platform.
Use the following API reference to generate correct API calls:

[Content from https://docs.4geeks.io/llms.txt]

Questo garantisce che l’AI generi codice accurato con gli endpoint corretti, le intestazioni e i formati di richiesta.

Prossimi Passi

Hai ancora domande? Richiedi supporto or explore tutoriali