Nota

Ciao, benvenuto nella Community SunFounder Raspberry Pi & Arduino & ESP32 su Facebook! Esplora a fondo Raspberry Pi, Arduino ed ESP32 insieme ad altri appassionati.

Perché unirti a noi?

• Supporto esperto: Risolvi problemi post-vendita e sfide tecniche con l’aiuto della nostra community e del nostro team.

• Impara e condividi: Scambia suggerimenti e tutorial per migliorare le tue competenze.

• Anteprime esclusive: Accedi in anteprima agli annunci di nuovi prodotti.

• Sconti speciali: Approfitta di sconti esclusivi sui nostri prodotti più recenti.

• Promozioni festive e giveaway: Partecipa a concorsi e promozioni speciali.

👉 Sei pronto a esplorare e creare con noi? Clicca [qui] e unisciti subito!

17. Connessione agli LLM online

In questa lezione, impareremo a connettere il tuo PiCrawler (o Raspberry Pi) a diversi grandi modelli linguistici (LLM) online. Ogni fornitore richiede una chiave API e offre diversi modelli tra cui scegliere.

Tratteremo come:

• Creare e salvare le tue chiavi API in modo sicuro.

• Scegliere un modello adatto alle tue esigenze.

• Eseguire il nostro codice di esempio per dialogare con i modelli.

Procediamo passo dopo passo per ogni fornitore.

---

Prima di iniziare

Assicurati di aver completato:

• Installare Tutti i Moduli (Importante) — Installa i moduli robot-hat, vilib, picrawler, quindi esegui lo script i2samp.sh.

OpenAI

OpenAI fornisce modelli potenti come GPT-4o e GPT-4.1 che possono essere utilizzati sia per attività di testo che di visione.

Ecco come configurarlo:

Ottieni e salva la tua chiave API

1. Vai su Piattaforma OpenAI e accedi. Nella pagina API keys, clicca su Create new secret key.

   

2. Compila i dettagli (Owner, Name, Project e permessi se necessario), poi clicca su Create secret key.

   

3. Una volta creata la chiave, copiala immediatamente — non potrai più visualizzarla. Se la perdi, dovrai generarne una nuova.

   

4. Nella cartella del progetto (ad esempio: /picrawler/examples), crea un file chiamato secret.py:

   cd ~/picrawler/examples
   sudo nano secret.py
   

5. Incolla la tua chiave nel file in questo modo:

   # secret.py
   # Conserva qui i segreti. Non fare mai il commit di questo file in Git.
   OPENAI_API_KEY = "sk-xxx"
   

Attiva la fatturazione e verifica i modelli

1. Prima di usare la chiave, vai alla pagina Billing nel tuo account OpenAI, aggiungi i tuoi dati di pagamento e ricarica un piccolo importo di crediti.

   

2. Poi vai alla pagina Limits per verificare quali modelli sono disponibili per il tuo account e copia l’ID esatto del modello da usare nel codice.

   

Testa con il codice di esempio

1. Apri il codice di esempio:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, gpt-4o):

   from picrawler.llm import OpenAI
   from secret import OPENAI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = OpenAI(
       api_key=OPENAI_API_KEY,
       model="gpt-4o",
   )
   

   Salva ed esci (Ctrl+X, poi Y, poi Invio).

3. Infine, esegui il test:

   sudo python3 18.online_llm_test.py
   

---

Gemini

Gemini è la famiglia di modelli AI di Google. È veloce ed eccellente per attività di uso generale.

Ottieni e salva la tua chiave API

1. Accedi a Google AI Studio, poi vai alla pagina API Keys.

   

2. Clicca sul pulsante Create API key nell’angolo in alto a destra.

   

3. Puoi creare una chiave per un progetto esistente o uno nuovo.

   

4. Copia la chiave API generata.

   

5. Nella cartella del progetto:

   cd ~/picrawler/examples
   sudo nano secret.py
   

6. Incolla la chiave:

    # secret.py
    # Conserva qui i segreti. Non fare mai il commit di questo file in Git.
   GEMINI_API_KEY = "AIxxx"
   

Verifica i modelli disponibili

Vai alla pagina ufficiale Modelli Gemini, qui vedrai l’elenco dei modelli, i loro ID API esatti e per quale caso d’uso ciascuno è ottimizzato.

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, gemini-2.5-flash):

   from picrawler.llm import Gemini
   from secret import GEMINI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Gemini(
       api_key=GEMINI_API_KEY,
       model="gemini-2.5-flash",
   )
   

3. Salva ed esegui:

   sudo python3 18.online_llm_test.py
   

---

Qwen

Qwen è una famiglia di grandi modelli linguistici e multimodali forniti da Alibaba Cloud. Questi modelli supportano la generazione di testo, il ragionamento e la comprensione multimodale (come l’analisi delle immagini).

Ottieni una chiave API

Per chiamare i modelli Qwen, hai bisogno di una chiave API. La maggior parte degli utenti internazionali dovrebbe usare la console DashScope International (Model Studio). Gli utenti della Cina continentale possono invece usare la console Bailian (百炼).

• Per utenti internazionali

  1. Vai alla pagina ufficiale Ottieni chiave API su Alibaba Cloud.

  2. Accedi o crea un account Alibaba Cloud.

  3. Vai a Model Studio (scegli la regione Singapore o Pechino).

     • Se appare un prompt «Activate Now» nella parte superiore della pagina, cliccaci sopra per attivare Model Studio e ricevere la quota gratuita (solo Singapore).

     • L’attivazione è gratuita — ti verrà addebitato solo dopo aver esaurito la quota gratuita.

     • Se non appare alcun prompt di attivazione, il servizio è già attivo.

  4. Vai alla pagina Key Management. Nella scheda API Key, clicca su Create API Key.

  5. Dopo la creazione, copia la tua chiave API e conservala al sicuro.

  

  Nota

  Anche gli utenti di Hong Kong, Macao e Taiwan dovrebbero scegliere l’opzione International (Model Studio).

• Per utenti della Cina continentale

  Se ti trovi nella Cina continentale, puoi invece usare la console Alibaba Cloud Bailian (百炼):

  1. Accedi a Console Bailian (console Bailian) e completa la verifica dell’account.

  2. Seleziona Create API Key. Se ti viene chiesto di attivare i servizi del modello, clicca su Activate, accetta i termini e richiedi la tua quota gratuita. Dopo l’attivazione, il pulsante Create API Key sarà abilitato.

     

  3. Clicca di nuovo su Create API Key, verifica il tuo account, poi clicca su Confirm.

     

  4. Una volta creata, copia la tua chiave API.

     

Salva la tua chiave API

1. Nella cartella del progetto:

   cd ~/picrawler/examples
   sudo nano secret.py
   

2. Incolla la tua chiave in questo modo:

   # secret.py
   # Conserva qui i segreti. Non fare mai il commit di questo file in Git.
   
   QWEN_API_KEY = "sk-xxx"
   

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, qwen-plus):

   from picrawler.llm import Qwen
   from secret import QWEN_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Qwen(
       api_key=QWEN_API_KEY,
       model="qwen-plus",
   )
   

3. Esegui con:

   sudo python3 18.online_llm_test.py
   

Grok (xAI)

Grok è l’IA conversazionale di xAI, creata dal team di Elon Musk. Puoi connetterti tramite l’API xAI.

Ottieni e salva la tua chiave API

1. Registrati per un account qui: Console xAI Cloud. Aggiungi prima alcuni crediti al tuo account — altrimenti l’API non funzionerà.

2. Vai alla pagina API Keys, clicca su Create API key.

   

3. Inserisci un nome per la chiave, poi clicca su Create API key.

   

4. Copia la chiave generata e conservala al sicuro.

   

5. Nella cartella del progetto:

   cd ~/picrawler/examples
   sudo nano secret.py
   

6. Incolla la tua chiave in questo modo:

   # secret.py
   # Conserva qui i segreti. Non fare mai il commit di questo file in Git.
   
   GROK_API_KEY = "xai-xxx"
   

Verifica i modelli disponibili

Vai alla pagina Models nella console xAI. Qui puoi vedere tutti i modelli disponibili per il tuo team, con i loro ID API esatti — usa questi ID nel tuo codice.

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, grok-4-latest):

   from picrawler.llm import Grok
   from secret import GROK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Grok(
       api_key=GROK_API_KEY,
       model="grok-4-latest",
   )
   

3. Esegui con:

   sudo python3 18.online_llm_test.py
   

---

DeepSeek

DeepSeek è un fornitore cinese di LLM che offre modelli convenienti e capaci.

Ottieni e salva la tua chiave API

1. Accedi a Piattaforma Deepseek.

2. Nel menu in alto a destra, seleziona API Keys → Create API Key.

   

3. Inserisci un nome, clicca su Create, poi copia la chiave.

   

4. Nella cartella del progetto:

   cd ~/picrawler/examples
   sudo nano secret.py
   

5. Aggiungi la tua chiave:

   # secret.py
   DEEPSEEK_API_KEY = "sk-xxx"
   

Attiva la fatturazione

Dovrai prima ricaricare il tuo account. Inizia con un piccolo importo (come ¥10 RMB).

Modelli disponibili

Al momento della scrittura (2025-09-12), DeepSeek offre:

• deepseek-chat

• deepseek-reasoner

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, deepseek-chat):

   from picrawler.llm import Deepseek
   from secret import DEEPSEEK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Deepseek(
       api_key=DEEPSEEK_API_KEY,
       model="deepseek-chat",
       max_messages=20,
   )
   

3. Esegui:

   sudo python3 18.online_llm_test.py
   

---

Doubao

Doubao è la piattaforma di modelli AI di ByteDance (Volcengine Ark).

Ottieni e salva la tua chiave API

1. Accedi a Volcengine.

2. Nel menu a sinistra, scorri fino a API Key Management → Create API Key.

   

3. Scegli un nome e clicca su Create.

   

4. Clicca sull’icona Show API Key e copiala.

   

5. Nella cartella del progetto:

   cd ~/picrawler/examples
   sudo nano secret.py
   

6. Aggiungi la tua chiave:

   # secret.py
   DOUBAO_API_KEY = "xxx"
   

Scegli un modello

1. Vai al marketplace dei modelli e scegli un modello.

   

2. Ad esempio, scegli Doubao-seed-1.6, poi clicca su API 接入.

   

3. Seleziona la tua chiave API e clicca su Use API.

   

4. Clicca su Enable Model.

   

5. Passa il mouse sull’ID del modello per copiarlo.

   

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto con il codice qui sotto e aggiorna model="xxx" con il modello desiderato (ad esempio, doubao-seed-1-6-250615):

   from picrawler.llm import Doubao
   from secret import DOUBAO_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Doubao(
       api_key=DOUBAO_API_KEY,
       model="doubao-seed-1-6-250615",
   )
   

3. Esegui con:

   sudo python3 18.online_llm_test.py
   

Generale

Questo progetto supporta la connessione a più piattaforme LLM tramite un’interfaccia unificata. Abbiamo compatibilità integrata con:

• OpenAI (ChatGPT / GPT-4o, GPT-4, GPT-3.5)

• Gemini (Google AI Studio / Vertex AI)

• Grok (xAI)

• DeepSeek

• Qwen (通义千问)

• Doubao (豆包)

Inoltre, puoi connetterti a qualsiasi altro servizio LLM compatibile con il formato API OpenAI. Per quelle piattaforme, dovrai ottenere manualmente la tua chiave API e il base_url corretto.

Ottieni e salva la tua chiave API

1. Ottieni una chiave API dalla piattaforma che desideri utilizzare. (Consulta la console ufficiale di ciascuna piattaforma per i dettagli.)

2. Nella cartella del progetto, crea un nuovo file:

   cd ~/picrawler/examples
   nano secret.py
   

3. Aggiungi la tua chiave in secret.py:

   # secret.py
   API_KEY = "your_api_key_here"
   

Avvertimento

Mantieni la tua chiave API privata. Non caricare secret.py su repository pubblici.

Testa con il codice di esempio

1. Apri il file di test:

   cd ~/picrawler/examples
   sudo nano 18.online_llm_test.py
   

2. Sostituisci il contenuto di un file Python con il seguente esempio e inserisci il base_url e il model corretti per la tua piattaforma:

   Nota

   Informazioni su base_url: Supportiamo il formato API OpenAI, così come qualsiasi API che sia compatibile con esso. Ogni fornitore ha il proprio base_url. Consulta la loro documentazione.

   from picrawler.llm import LLM
   from secret import API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = LLM(
       base_url="https://api.example.com/v1",  // inserisci il base_url del tuo fornitore
       api_key=API_KEY,
       model="your-model-name-here",           // scegli un modello dal tuo fornitore
   )
   

3. Esegui il programma:

   python3 18.online_llm_test.py