7. Integrare piattaforme di coding e agenti

Ultimo aggiornamento: 27 agosto 2026

L'API Logicc può essere utilizzata come punto di accesso centrale ai modelli per assistenti di codifica esterni e piattaforme di agenti. La rispettiva applicazione fornisce l'interfaccia utente e gli strumenti locali. L’accesso ai modelli, la loro attivazione e il monitoraggio dei consumi sono gestiti tramite la chiave API Logicc.

Beta: L'API Logicc e le integrazioni di terze parti descritte sono in una fase di test ed espansione continua. Gli aggiornamenti della piattaforma possono modificare la configurazione, la disponibilità del modello e la funzionalità. Verificare un'integrazione prima dell'uso produttivo con il modello e il flusso di lavoro previsti.

Seleziona la piattaforma

Le sottopagine contengono la configurazione completa per ciascuna piattaforma.

Controllo rapido prima della configurazione

1. Imposta la chiave API

macOS, Linux o WSL:

export LOGICC_API_KEY="LA_TUA_CHIAVE_API_LOGICC"

Windows PowerShell:

$env:LOGICC_API_KEY = "LA_TUA_CHIAVE_API_LOGICC"

2. Controlla i modelli abilitati

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Utilizza solo gli ID modello restituiti da questa risposta. Il listino prezzi generale non costituisce conferma automatica di attivazione.

3. Controlla il budget

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Budget, consumi e budget residuo sono mantenuti in euro.

Flusso di dati

Piattaforma locale di coding o agenti
        ↓
API Logicc e gateway Logicc
        ↓
Provider di modelli abilitato
        ↓
Risposta alla piattaforma

L'interfaccia, le cartelle di progetto locali e gli strumenti del terminale autorizzati funzionano sempre sul dispositivo utilizzato. Il modello linguistico non viene eseguito localmente. Le richieste e i frammenti di file o di codice selezionati per un'attività vengono trasferiti tramite l'API Logicc al provider di modelli configurato per la chiave API.

Formati API

Codex richiede il protocollo Responses per i propri provider di modelli. Claude Code è progettato per i modelli Claude. OpenCode può utilizzare entrambi i formati OpenAI.

Matrice di compatibilità

Per l’elenco completo degli ID e dei prezzi, consulta 2. Modelli e prezzi. GET /v1/models rimane il riferimento per la singola chiave API.

Controllare i costi

Le piattaforme agenti possono eseguire numerose query di modello, passaggi di strumenti e iterazioni automatiche per un'attività. Il consumo può quindi essere notevolmente superiore rispetto a una singola richiesta di chat. I modelli GPT più grandi e Claude Opus costano molto di più rispetto ai modelli più piccoli.

Raccomandazioni:

• Per le attività di routine, utilizzare inizialmente un modello più economico.
• Seleziona modelli potenti specifici per attività complesse.
• Controllare regolarmente i consumi e il budget rimanente.
• Utilizza chiavi API, budget e limiti di tariffa separati per i team.

I prezzi dei modelli sono indicati in dollari USA per milione di token. Budget, consumi, budget residuo e fatturazione sono gestiti in euro.

Sicurezza e privacy

Le chiavi API non possono essere archiviate in repository Git, codice frontend, app distribuite pubblicamente o file di configurazione condivisi. Per un utilizzo a lungo termine, consigliamo un gestore di password, un Secret Manager o un Credential Helper.

La piattaforma di terze parti può inviare telemetria tecnica, controlli di aggiornamento o informazioni diagnostiche al proprio fornitore indipendentemente dalla chiamata del modello. Ricerca Web, plug-in, server MCP e connettori possono creare flussi di dati aggiuntivi. Prima di utilizzare dati riservati, verificare:

• Quali file e cartelle può leggere la piattaforma?
• Quali comandi può eseguire?
• Quale telemetria è attivata?
• Quali plugin, MCP server e connettori sono collegati?
• Quale percorso del modello è attivato per la chiave API?

Sono determinanti le condizioni di protezione dei dati e di riservatezza concordate per l'account Logicc e il rispettivo percorso del fornitore. La scelta di un'interfaccia locale non significa che l'elaborazione del modello avvenga localmente.

Risoluzione generale dei problemi

Più integrazioni

Roo Code, Aider e altre estensioni VS Code o JetBrains possono generalmente funzionare se supportano il proprio URL di base, l'autenticazione Bearer e l'ID modello. Queste integrazioni non sono approvate a tutti i livelli. La chiamata degli strumenti, lo streaming, il ragionamento e le operazioni sui file devono essere testati per la combinazione specifica.

Le applicazioni lato server personalizzate forniscono il massimo controllo su autorizzazioni, registrazione, mappatura degli utenti, limiti di velocità e gestione degli errori.

Supporto

Se avete domande scrivete a [email protected] con oggetto API. Si prega di inviare:

• Piattaforma e versione
• ID modello e formato API
• Stato HTTP e testo completo dell'errore
• Momento dell'errore
• Nessuna chiave API o contenuto riservato

Ulteriori informazioni:

• Centro assistenza Logicc: https://help.logicc.com/docs
• Roo Code: https://docs.roocode.com/providers/openai-compatible
• Aider: https://aider.chat/docs/llms/openai-compat.html