mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-07 01:08:58 +00:00
fix(docs): locale translations for nav elements and headings
This commit is contained in:
Adam
@@ -9,11 +9,11 @@ OpenCode supporta [Agent Client Protocol](https://agentclientprotocol.com) (ACP)
|
||||
Per una lista di editor e tool che supportano ACP, vedi l'[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now).
|
||||
:::
|
||||
|
||||
ACP e un protocollo aperto che standardizza la comunicazione tra editor di codice e agenti di coding AI.
|
||||
ACP e è un protocollo aperto che standardizza la comunicazione tra editor di codice e agenti di coding AI.
|
||||
|
||||
---
|
||||
|
||||
## Configure
|
||||
## Configurazione
|
||||
|
||||
Per usare OpenCode via ACP, configura l'editor in modo che esegua il comando `opencode acp`.
|
||||
|
||||
@@ -140,7 +140,7 @@ Questa config imposta CodeCompanion per usare OpenCode come agente ACP per la ch
|
||||
|
||||
Se devi passare variabili d'ambiente (come `OPENCODE_API_KEY`), vedi [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) nella documentazione di CodeCompanion.nvim.
|
||||
|
||||
## Support
|
||||
## Supporto
|
||||
|
||||
OpenCode funziona via ACP come nel terminale. Tutte le funzionalita sono supportate:
|
||||
:::note
|
||||
|
||||
@@ -21,7 +21,7 @@ In OpenCode esistono due tipi di agenti: agenti primari e subagenti.
|
||||
|
||||
### Agenti primari
|
||||
|
||||
Gli agenti primari sono gli assistenti principali con cui interagisci direttamente. Puoi scorrerli usando il tasto **Tab** o la scorciatoia `switch_agent` configurata. Questi agenti gestiscono la conversazione principale. L'accesso agli strumenti si configura tramite i permessi: per esempio, Build ha tutti gli strumenti abilitati, mentre Plan e' limitato.
|
||||
Gli agenti primari sono gli assistenti principali con cui interagisci direttamente. Puoi scorrerli usando il tasto **Tab** o la scorciatoia `switch_agent` configurata. Questi agenti gestiscono la conversazione principale. L'accesso agli strumenti si configura tramite i permessi: per esempio, Build ha tutti gli strumenti abilitati, mentre Plan è limitato.
|
||||
|
||||
:::tip
|
||||
Puoi usare **Tab** per passare tra gli agenti primari durante una sessione.
|
||||
@@ -45,65 +45,65 @@ OpenCode include due agenti primari integrati e due subagenti integrati.
|
||||
|
||||
---
|
||||
|
||||
### Usa build
|
||||
### Build
|
||||
|
||||
_Mode_: `primary`
|
||||
|
||||
Build e' l'agente primario **predefinito** con tutti gli strumenti abilitati. E' l'agente standard per lavoro di sviluppo quando ti serve pieno accesso a operazioni sui file e comandi di sistema.
|
||||
Build è l'agente primario **predefinito** con tutti gli strumenti abilitati. È l'agente standard per lavoro di sviluppo quando ti serve pieno accesso a operazioni sui file e comandi di sistema.
|
||||
|
||||
---
|
||||
|
||||
### Usa plan
|
||||
### Plan
|
||||
|
||||
_Mode_: `primary`
|
||||
|
||||
Un agente limitato pensato per pianificazione e analisi. Usiamo un sistema di permessi per darti piu' controllo e prevenire modifiche non intenzionali.
|
||||
Un agente limitato pensato per pianificazione e analisi. Usiamo un sistema di permessi per darti più controllo e prevenire modifiche non intenzionali.
|
||||
Di default, tutte le seguenti sono impostate a `ask`:
|
||||
|
||||
- `file edits`: tutte le scritture, patch ed edit
|
||||
- `bash`: tutti i comandi bash
|
||||
|
||||
Questo agente e' utile quando vuoi che l'LLM analizzi il codice, suggerisca modifiche o crei piani senza effettuare alcuna modifica reale al codebase.
|
||||
Questo agente è utile quando vuoi che l'LLM analizzi il codice, suggerisca modifiche o crei piani senza effettuare alcuna modifica reale al codebase.
|
||||
|
||||
---
|
||||
|
||||
### Usa general
|
||||
### General
|
||||
|
||||
_Mode_: `subagent`
|
||||
|
||||
Un agente general-purpose per ricercare domande complesse ed eseguire task multi-step. Ha accesso completo agli strumenti (tranne todo), quindi puo' modificare file quando serve. Usalo per eseguire piu' unita' di lavoro in parallelo.
|
||||
Un agente general-purpose per ricercare domande complesse ed eseguire task multi-step. Ha accesso completo agli strumenti (tranne todo), quindi può modificare file quando serve. Usalo per eseguire più unità di lavoro in parallelo.
|
||||
|
||||
---
|
||||
|
||||
### Usa explore
|
||||
### Explore
|
||||
|
||||
_Mode_: `subagent`
|
||||
|
||||
Un agente rapido in sola lettura per esplorare codebase. Non puo' modificare file. Usalo quando devi trovare rapidamente file tramite pattern, cercare nel codice per keyword o rispondere a domande sul codebase.
|
||||
Un agente rapido in sola lettura per esplorare codebase. Non può modificare file. Usalo quando devi trovare rapidamente file tramite pattern, cercare nel codice per keyword o rispondere a domande sul codebase.
|
||||
|
||||
---
|
||||
|
||||
### Usa compaction
|
||||
### Compaction
|
||||
|
||||
_Mode_: `primary`
|
||||
|
||||
Agente di sistema nascosto che compatta contesti lunghi in un riassunto piu' piccolo. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI.
|
||||
Agente di sistema nascosto che compatta contesti lunghi in un riassunto più piccolo. Viene eseguito automaticamente quando serve e non è selezionabile nella UI.
|
||||
|
||||
---
|
||||
|
||||
### Usa title
|
||||
### Title
|
||||
|
||||
_Mode_: `primary`
|
||||
|
||||
Agente di sistema nascosto che genera titoli brevi per le sessioni. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI.
|
||||
Agente di sistema nascosto che genera titoli brevi per le sessioni. Viene eseguito automaticamente quando serve e non è selezionabile nella UI.
|
||||
|
||||
---
|
||||
|
||||
### Usa summary
|
||||
### Summary
|
||||
|
||||
_Mode_: `primary`
|
||||
|
||||
Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI.
|
||||
Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automaticamente quando serve e non è selezionabile nella UI.
|
||||
|
||||
---
|
||||
|
||||
@@ -113,21 +113,20 @@ Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automa
|
||||
|
||||
2. I subagenti possono essere invocati:
|
||||
- **Automaticamente** dagli agenti primari per task specializzati in base alle loro descrizioni.
|
||||
- Manualmente **menzionando con @** un subagente nel tuo messaggio. Per esempio.
|
||||
- Manualmente **menzionando con @** un subagente nel tuo messaggio. Per esempio:
|
||||
|
||||
```txt frame="none"
|
||||
@general help me search for this function
|
||||
```
|
||||
|
||||
3. **Navigazione tra sessioni**: quando i subagenti creano le loro child session, puoi navigare tra la sessione padre e tutte le sessioni figlie usando:
|
||||
3. **Navigazione tra sessioni**: quando i subagenti creano le loro child session, puoi navigare tra la sessione padre e tutte le sessioni figlie usando:
|
||||
- **\<Leader>+Right** (o la scorciatoia `session_child_cycle` configurata) per ciclare in avanti tra parent → child1 → child2 → ... → parent
|
||||
- **\<Leader>+Left** (o la scorciatoia `session_child_cycle_reverse` configurata) per ciclare indietro tra parent ← child1 ← child2 ← ... ← parent
|
||||
|
||||
Questo ti permette di passare senza soluzione di continuita' tra la conversazione principale e il lavoro specializzato dei subagenti.
|
||||
Questo ti permette di passare senza soluzione di continuità tra la conversazione principale e il lavoro specializzato dei subagenti.
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
## Configurazione
|
||||
|
||||
Puoi personalizzare gli agenti integrati o crearne di tuoi tramite configurazione. Gli agenti possono essere configurati in due modi:
|
||||
|
||||
@@ -229,15 +228,15 @@ Usa l'opzione `description` per fornire una breve descrizione di cosa fa l'agent
|
||||
}
|
||||
```
|
||||
|
||||
Questa e' un'opzione di configurazione **obbligatoria**.
|
||||
Questa è un'opzione di configurazione **obbligatoria**.
|
||||
|
||||
---
|
||||
|
||||
### Temperatura
|
||||
|
||||
Controlla casualita' e creativita' delle risposte dell'LLM con la config `temperature`.
|
||||
Controlla casualità e creatività delle risposte dell'LLM con la config `temperature`.
|
||||
|
||||
Valori bassi rendono le risposte piu' focalizzate e deterministiche, mentre valori alti aumentano creativita' e variabilita'.
|
||||
Valori bassi rendono le risposte più focalizzate e deterministiche, mentre valori alti aumentano creatività e variabilità.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -255,8 +254,8 @@ Valori bassi rendono le risposte piu' focalizzate e deterministiche, mentre valo
|
||||
I valori di temperature tipicamente vanno da 0.0 a 1.0:
|
||||
|
||||
- **0.0-0.2**: risposte molto focalizzate e deterministiche, ideali per analisi del codice e pianificazione
|
||||
- **0.3-0.5**: risposte bilanciate con un po' di creativita', adatte a task generali di sviluppo
|
||||
- **0.6-1.0**: risposte piu' creative e varie, utili per brainstorming ed esplorazione
|
||||
- **0.3-0.5**: risposte bilanciate con un po' di creatività, adatte a task generali di sviluppo
|
||||
- **0.6-1.0**: risposte più creative e varie, utili per brainstorming ed esplorazione
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -282,9 +281,9 @@ Se non specifichi una temperature, OpenCode usa i default specifici del modello;
|
||||
|
||||
### Passi massimi
|
||||
|
||||
Controlla il numero massimo di iterazioni agentiche che un agente puo' eseguire prima di essere forzato a rispondere solo con testo. Questo permette a chi vuole controllare i costi di impostare un limite alle azioni agentiche.
|
||||
Controlla il numero massimo di iterazioni agentiche che un agente può eseguire prima di essere forzato a rispondere solo con testo. Questo permette a chi vuole controllare i costi di impostare un limite alle azioni agentiche.
|
||||
|
||||
Se non e' impostato, l'agente continuera' a iterare finche' il modello sceglie di fermarsi o l'utente interrompe la sessione.
|
||||
Se non è impostato, l'agente continuerà a iterare finché il modello sceglie di fermarsi o l'utente interrompe la sessione.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -301,12 +300,12 @@ Se non e' impostato, l'agente continuera' a iterare finche' il modello sceglie d
|
||||
Quando viene raggiunto il limite, l'agente riceve un system prompt speciale che lo istruisce a rispondere con un riassunto del lavoro svolto e con i task rimanenti consigliati.
|
||||
|
||||
:::caution
|
||||
Il campo legacy `maxSteps` e' deprecato. Usa `steps`.
|
||||
Il campo legacy `maxSteps` è deprecato. Usa `steps`.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
### Disabilita
|
||||
### Disabilitazione
|
||||
|
||||
Imposta a `true` per disabilitare l'agente.
|
||||
|
||||
@@ -336,13 +335,13 @@ Specifica un file di system prompt personalizzato per questo agente tramite la c
|
||||
}
|
||||
```
|
||||
|
||||
Questo path e' relativo alla posizione del file di configurazione. Quindi funziona sia per la config globale di OpenCode sia per la config specifica del progetto.
|
||||
Questo path è relativo alla posizione del file di configurazione. Quindi funziona sia per la config globale di OpenCode sia per la config specifica del progetto.
|
||||
|
||||
---
|
||||
|
||||
### Modello
|
||||
|
||||
Usa la config `model` per sovrascrivere il modello per questo agente. Utile per usare modelli diversi ottimizzati per task diversi. Per esempio, un modello piu' veloce per la pianificazione e uno piu' capace per l'implementazione.
|
||||
Usa la config `model` per sovrascrivere il modello per questo agente. Utile per usare modelli diversi ottimizzati per task diversi. Per esempio, un modello più veloce per la pianificazione e uno più capace per l'implementazione.
|
||||
|
||||
:::tip
|
||||
Se non specifichi un modello, gli agenti primari usano il [modello configurato globalmente](/docs/config#models), mentre i subagenti useranno il modello dell'agente primario che li ha invocati.
|
||||
@@ -388,7 +387,7 @@ Controlla quali strumenti sono disponibili per questo agente tramite la config `
|
||||
La configurazione specifica dell'agente sovrascrive la configurazione globale.
|
||||
:::
|
||||
|
||||
Puoi anche usare wildcard per controllare piu' strumenti in una volta. Per esempio, per disabilitare tutti gli strumenti di un server MCP:
|
||||
Puoi anche usare wildcard per controllare più strumenti in una volta. Per esempio, per disabilitare tutti gli strumenti di un server MCP:
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -405,13 +404,13 @@ Puoi anche usare wildcard per controllare piu' strumenti in una volta. Per esemp
|
||||
}
|
||||
```
|
||||
|
||||
[Scopri di piu' sugli strumenti](/docs/tools).
|
||||
[Scopri di più sugli strumenti](/docs/tools).
|
||||
|
||||
---
|
||||
|
||||
### Permessi
|
||||
|
||||
Puoi configurare i permessi per gestire quali azioni un agente puo' eseguire. Attualmente, i permessi per gli strumenti `edit`, `bash` e `webfetch` possono essere configurati come:
|
||||
Puoi configurare i permessi per gestire quali azioni un agente può eseguire. Attualmente, i permessi per gli strumenti `edit`, `bash` e `webfetch` possono essere configurati come:
|
||||
|
||||
- `"ask"` — chiede approvazione prima di eseguire lo strumento
|
||||
- `"allow"` — consente tutte le operazioni senza approvazione
|
||||
@@ -481,7 +480,7 @@ Puoi impostare permessi per comandi bash specifici.
|
||||
}
|
||||
```
|
||||
|
||||
Questo puo' usare un glob pattern.
|
||||
Questo può usare un glob pattern.
|
||||
|
||||
```json title="opencode.json" {7}
|
||||
{
|
||||
@@ -517,13 +516,13 @@ Dato che l'ultima regola che corrisponde ha la precedenza, metti prima la wildca
|
||||
}
|
||||
```
|
||||
|
||||
[Scopri di piu' sui permessi](/docs/permissions).
|
||||
[Scopri di più sui permessi](/docs/permissions).
|
||||
|
||||
---
|
||||
|
||||
### Modalita'
|
||||
### Modalità
|
||||
|
||||
Controlla la modalita' dell'agente con la config `mode`. L'opzione `mode` determina come l'agente puo' essere usato.
|
||||
Controlla la modalità dell'agente con la config `mode`. L'opzione `mode` determina come l'agente può essere usato.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -535,7 +534,7 @@ Controlla la modalita' dell'agente con la config `mode`. L'opzione `mode` determ
|
||||
}
|
||||
```
|
||||
|
||||
`mode` puo' essere `primary`, `subagent` o `all`. Se `mode` non e' specificato, il default e' `all`.
|
||||
`mode` può essere `primary`, `subagent` o `all`. Se `mode` non è specificato, il default è `all`.
|
||||
|
||||
---
|
||||
|
||||
@@ -554,7 +553,7 @@ Nascondi un subagente dal menu autocomplete di `@` con `hidden: true`. Utile per
|
||||
}
|
||||
```
|
||||
|
||||
Questo influisce solo sulla visibilita' per l'utente nel menu autocomplete. Gli agenti nascosti possono comunque essere invocati dal modello tramite lo strumento Task se i permessi lo consentono.
|
||||
Questo influisce solo sulla visibilità per l'utente nel menu autocomplete. Gli agenti nascosti possono comunque essere invocati dal modello tramite lo strumento Task se i permessi lo consentono.
|
||||
|
||||
:::note
|
||||
Si applica solo ad agenti con `mode: subagent`.
|
||||
@@ -564,7 +563,7 @@ Si applica solo ad agenti con `mode: subagent`.
|
||||
|
||||
### Permessi Task
|
||||
|
||||
Controlla quali subagenti un agente puo' invocare tramite lo strumento Task con `permission.task`. Usa glob pattern per un matching flessibile.
|
||||
Controlla quali subagenti un agente può invocare tramite lo strumento Task con `permission.task`. Usa glob pattern per un matching flessibile.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -583,10 +582,10 @@ Controlla quali subagenti un agente puo' invocare tramite lo strumento Task con
|
||||
}
|
||||
```
|
||||
|
||||
Quando e' impostato a `deny`, il subagente viene rimosso interamente dalla descrizione dello strumento Task, quindi il modello non provera' a invocarlo.
|
||||
Quando è impostato a `deny`, il subagente viene rimosso interamente dalla descrizione dello strumento Task, quindi il modello non proverà a invocarlo.
|
||||
|
||||
:::tip
|
||||
Le regole vengono valutate in ordine e **vince l'ultima regola che corrisponde**. Nell'esempio sopra, `orchestrator-planner` corrisponde sia a `*` (deny) sia a `orchestrator-*` (allow), ma dato che `orchestrator-*` viene dopo `*`, il risultato e' `allow`.
|
||||
Le regole vengono valutate in ordine e **vince l'ultima regola che corrisponde**. Nell'esempio sopra, `orchestrator-planner` corrisponde sia a `*` (deny) sia a `orchestrator-*` (allow), ma dato che `orchestrator-*` viene dopo `*`, il risultato è `allow`.
|
||||
:::
|
||||
|
||||
:::tip
|
||||
@@ -618,7 +617,7 @@ Usa un colore hex valido (ad es. `#FF5733`) o un colore tema: `primary`, `second
|
||||
|
||||
### Top P
|
||||
|
||||
Controlla la diversita' delle risposte con l'opzione `top_p`. Alternativa alla temperature per controllare la casualita'.
|
||||
Controlla la diversità delle risposte con l'opzione `top_p`. Alternativa alla temperature per controllare la casualità.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -630,13 +629,13 @@ Controlla la diversita' delle risposte con l'opzione `top_p`. Alternativa alla t
|
||||
}
|
||||
```
|
||||
|
||||
I valori vanno da 0.0 a 1.0. Valori piu' bassi sono piu' focalizzati, valori piu' alti piu' diversi.
|
||||
I valori vanno da 0.0 a 1.0. Valori più bassi sono più focalizzati, valori più alti più diversi.
|
||||
|
||||
---
|
||||
|
||||
### Opzioni aggiuntive
|
||||
|
||||
Qualsiasi altra opzione che specifichi nella configurazione dell'agente verra' **passata direttamente** al provider come opzione del modello. Questo ti permette di usare feature e parametri specifici del provider.
|
||||
Qualsiasi altra opzione che specifichi nella configurazione dell'agente verrà **passata direttamente** al provider come opzione del modello. Questo ti permette di usare feature e parametri specifici del provider.
|
||||
|
||||
Per esempio, con i modelli di reasoning di OpenAI, puoi controllare lo sforzo di ragionamento:
|
||||
|
||||
@@ -661,7 +660,7 @@ Esegui `opencode models` per vedere la lista dei modelli disponibili.
|
||||
|
||||
---
|
||||
|
||||
## Crea agenti
|
||||
## Creazione agenti
|
||||
|
||||
Puoi creare nuovi agenti usando il comando seguente:
|
||||
|
||||
@@ -674,7 +673,7 @@ Questo comando interattivo:
|
||||
1. Chiede dove salvare l'agente: globale o specifico del progetto.
|
||||
2. Chiede una descrizione di cosa dovrebbe fare l'agente.
|
||||
3. Genera un system prompt appropriato e un identificatore.
|
||||
4. Ti fa selezionare a quali strumenti l'agente puo' accedere.
|
||||
4. Ti fa selezionare a quali strumenti l'agente può accedere.
|
||||
5. Infine, crea un file markdown con la configurazione dell'agente.
|
||||
|
||||
---
|
||||
@@ -685,7 +684,7 @@ Ecco alcuni casi d'uso comuni per agenti diversi.
|
||||
|
||||
- **Build agent**: sviluppo completo con tutti gli strumenti abilitati
|
||||
- **Plan agent**: analisi e pianificazione senza apportare modifiche
|
||||
- **Review agent**: code review con accesso in sola lettura piu' strumenti documentazione
|
||||
- **Review agent**: code review con accesso in sola lettura più strumenti documentazione
|
||||
- **Debug agent**: focalizzato sull'investigazione con strumenti bash e read abilitati
|
||||
- **Docs agent**: scrittura documentazione con operazioni sui file ma senza comandi di sistema
|
||||
|
||||
|
||||
@@ -60,7 +60,7 @@ opencode agent [command]
|
||||
|
||||
### attach
|
||||
|
||||
Collega un terminale a un backend server di OpenCode gia' in esecuzione avviato tramite i comandi `serve` o `web`.
|
||||
Collega un terminale a un backend server di OpenCode già in esecuzione avviato tramite i comandi `serve` o `web`.
|
||||
|
||||
```bash
|
||||
opencode attach [url]
|
||||
@@ -173,7 +173,7 @@ Installa l'agente GitHub nel tuo repository.
|
||||
opencode github install
|
||||
```
|
||||
|
||||
Questo configura il workflow GitHub Actions necessario e ti guida nel processo di configurazione. [Scopri di piu'](/docs/github).
|
||||
Questo configura il workflow GitHub Actions necessario e ti guida nel processo di configurazione. [Scopri di più](/docs/github).
|
||||
|
||||
---
|
||||
|
||||
@@ -240,7 +240,7 @@ Autentica con un server MCP con OAuth abilitato.
|
||||
opencode mcp auth [name]
|
||||
```
|
||||
|
||||
Se non fornisci un nome server, ti verra' chiesto di selezionare tra i server OAuth-capable disponibili.
|
||||
Se non fornisci un nome server, ti verrà chiesto di selezionare tra i server OAuth-capable disponibili.
|
||||
|
||||
Puoi anche elencare i server OAuth-capable e il loro stato di autenticazione.
|
||||
|
||||
@@ -286,7 +286,7 @@ opencode models [provider]
|
||||
|
||||
Questo comando mostra tutti i modelli disponibili tra i provider configurati nel formato `provider/model`.
|
||||
|
||||
E' utile per capire l'esatto nome del modello da usare nella [config](/docs/config/).
|
||||
È utile per capire l'esatto nome del modello da usare nella [config](/docs/config/).
|
||||
|
||||
Puoi anche passare opzionalmente un ID provider per filtrare i modelli a quel provider.
|
||||
|
||||
@@ -296,12 +296,12 @@ opencode models anthropic
|
||||
|
||||
#### Flag
|
||||
|
||||
| Flag | Descrizione |
|
||||
| ----------- | --------------------------------------------------- |
|
||||
| `--refresh` | Aggiorna la cache modelli da models.dev |
|
||||
| `--verbose` | Output piu' verboso (include metadati come i costi) |
|
||||
| Flag | Descrizione |
|
||||
| ----------- | -------------------------------------------------- |
|
||||
| `--refresh` | Aggiorna la cache modelli da models.dev |
|
||||
| `--verbose` | Output più verboso (include metadati come i costi) |
|
||||
|
||||
Usa `--refresh` per aggiornare l'elenco modelli in cache. E' utile quando nuovi modelli vengono aggiunti a un provider e vuoi vederli in OpenCode.
|
||||
Usa `--refresh` per aggiornare l'elenco modelli in cache. È utile quando nuovi modelli vengono aggiunti a un provider e vuoi vederli in OpenCode.
|
||||
|
||||
```bash
|
||||
opencode models --refresh
|
||||
@@ -311,19 +311,19 @@ opencode models --refresh
|
||||
|
||||
### run
|
||||
|
||||
Esegui opencode in modalita' non interattiva passando un prompt direttamente.
|
||||
Esegui opencode in modalità non interattiva passando un prompt direttamente.
|
||||
|
||||
```bash
|
||||
opencode run [message..]
|
||||
```
|
||||
|
||||
E' utile per scripting, automazione o quando vuoi una risposta rapida senza avviare la TUI completa. Per esempio.
|
||||
È utile per scripting, automazione o quando vuoi una risposta rapida senza avviare la TUI completa. Per esempio:
|
||||
|
||||
```bash "opencode run"
|
||||
opencode run Explain the use of context in Go
|
||||
```
|
||||
|
||||
Puoi anche collegarti a una istanza `opencode serve` gia' in esecuzione per evitare i cold boot dei server MCP ad ogni esecuzione:
|
||||
Puoi anche collegarti a una istanza `opencode serve` già in esecuzione per evitare i cold boot dei server MCP ad ogni esecuzione:
|
||||
|
||||
```bash
|
||||
# Avvia un server headless in un terminale
|
||||
@@ -360,7 +360,7 @@ Avvia un server OpenCode headless per accesso via API. Vedi le [server docs](/do
|
||||
opencode serve
|
||||
```
|
||||
|
||||
Avvia un server HTTP che espone accesso API alle funzionalita' di opencode senza la TUI. Imposta `OPENCODE_SERVER_PASSWORD` per abilitare HTTP basic auth (username di default `opencode`).
|
||||
Avvia un server HTTP che espone accesso API alle funzionalità di opencode senza la TUI. Imposta `OPENCODE_SERVER_PASSWORD` per abilitare HTTP basic auth (username di default `opencode`).
|
||||
|
||||
#### Flag
|
||||
|
||||
@@ -395,7 +395,7 @@ opencode session list
|
||||
|
||||
| Flag | Breve | Descrizione |
|
||||
| ------------- | ----- | ------------------------------------ |
|
||||
| `--max-count` | `-n` | Limita alle N sessioni piu' recenti |
|
||||
| `--max-count` | `-n` | Limita alle N sessioni più recenti |
|
||||
| `--format` | | Formato output: table o json (table) |
|
||||
|
||||
---
|
||||
@@ -427,7 +427,7 @@ Esporta i dati di sessione come JSON.
|
||||
opencode export [sessionID]
|
||||
```
|
||||
|
||||
Se non fornisci un ID sessione, ti verra' chiesto di selezionare tra le sessioni disponibili.
|
||||
Se non fornisci un ID sessione, ti verrà chiesto di selezionare tra le sessioni disponibili.
|
||||
|
||||
---
|
||||
|
||||
@@ -551,7 +551,7 @@ La CLI di opencode accetta i seguenti flag globali.
|
||||
|
||||
## Variabili d'ambiente
|
||||
|
||||
OpenCode puo' essere configurato tramite variabili d'ambiente.
|
||||
OpenCode può essere configurato tramite variabili d'ambiente.
|
||||
|
||||
| Variabile | Tipo | Descrizione |
|
||||
| ------------------------------------- | ------- | ----------------------------------------------------------- |
|
||||
@@ -584,20 +584,20 @@ OpenCode puo' essere configurato tramite variabili d'ambiente.
|
||||
|
||||
### Sperimentale
|
||||
|
||||
Queste variabili d'ambiente abilitano funzionalita' sperimentali che potrebbero cambiare o essere rimosse.
|
||||
Queste variabili d'ambiente abilitano funzionalità sperimentali che potrebbero cambiare o essere rimosse.
|
||||
|
||||
| Variabile | Tipo | Descrizione |
|
||||
| ----------------------------------------------- | ------- | ------------------------------------------- |
|
||||
| `OPENCODE_EXPERIMENTAL` | boolean | Abilita tutte le funzionalita' sperimentali |
|
||||
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Abilita icon discovery |
|
||||
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Disabilita copy on select nella TUI |
|
||||
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Timeout di default per comandi bash in ms |
|
||||
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Massimo token di output per risposte LLM |
|
||||
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Abilita file watcher per l'intera dir |
|
||||
| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Abilita formatter oxfmt |
|
||||
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Abilita strumento LSP sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Disabilita file watcher |
|
||||
| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Abilita funzionalita' Exa sperimentali |
|
||||
| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Abilita type checking LSP sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Abilita markdown sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Abilita plan mode |
|
||||
| Variabile | Tipo | Descrizione |
|
||||
| ----------------------------------------------- | ------- | ------------------------------------------ |
|
||||
| `OPENCODE_EXPERIMENTAL` | boolean | Abilita tutte le funzionalità sperimentali |
|
||||
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Abilita icon discovery |
|
||||
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Disabilita copy on select nella TUI |
|
||||
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Timeout di default per comandi bash in ms |
|
||||
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Massimo token di output per risposte LLM |
|
||||
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Abilita file watcher per l'intera dir |
|
||||
| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Abilita formatter oxfmt |
|
||||
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Abilita strumento LSP sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Disabilita file watcher |
|
||||
| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Abilita funzionalità Exa sperimentali |
|
||||
| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Abilita type checking LSP sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Abilita markdown sperimentale |
|
||||
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Abilita plan mode |
|
||||
|
||||
@@ -13,7 +13,7 @@ I comandi personalizzati si aggiungono a quelli integrati come `/init`, `/undo`,
|
||||
|
||||
---
|
||||
|
||||
## Crea file di comando
|
||||
## Creazione file di comando
|
||||
|
||||
Crea file markdown nella directory `commands/` per definire comandi personalizzati.
|
||||
|
||||
@@ -40,7 +40,7 @@ Usa il comando digitando `/` seguito dal nome del comando.
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
## Configurazione
|
||||
|
||||
Puoi aggiungere comandi personalizzati tramite la config di OpenCode o creando file markdown nella directory `commands/`.
|
||||
|
||||
@@ -217,7 +217,7 @@ Vediamo le opzioni di configurazione nel dettaglio.
|
||||
|
||||
---
|
||||
|
||||
### Modello di prompt
|
||||
### Template del prompt
|
||||
|
||||
L'opzione `template` definisce il prompt che verra inviato all'LLM quando il comando viene eseguito.
|
||||
|
||||
@@ -311,7 +311,7 @@ Questa e un'opzione di config **opzionale**.
|
||||
|
||||
---
|
||||
|
||||
## Integrati
|
||||
## Comandi integrati
|
||||
|
||||
opencode include diversi comandi integrati come `/init`, `/undo`, `/redo`, `/share`, `/help`; [scopri di piu](/docs/tui#commands).
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Config
|
||||
description: Usa la config JSON di OpenCode.
|
||||
title: Configurazione
|
||||
description: Usa la configurazione JSON di OpenCode.
|
||||
---
|
||||
|
||||
Puoi configurare OpenCode usando un file di configurazione JSON.
|
||||
@@ -56,7 +56,7 @@ Le directory `.opencode` e `~/.config/opencode` usano **nomi al plurale** per le
|
||||
|
||||
---
|
||||
|
||||
### Remota
|
||||
### Configurazione remota
|
||||
|
||||
Le organizzazioni possono fornire una configurazione predefinita tramite l'endpoint `.well-known/opencode`. Viene recuperata automaticamente quando ti autentichi con un provider che lo supporta.
|
||||
|
||||
@@ -92,7 +92,7 @@ Puoi abilitare server specifici nella tua configurazione locale:
|
||||
|
||||
---
|
||||
|
||||
### Globale
|
||||
### Configurazione globale
|
||||
|
||||
Metti la configurazione globale di OpenCode in `~/.config/opencode/opencode.json`. Usa la configurazione globale per preferenze valide per l'utente (ad es. temi, provider o keybind).
|
||||
|
||||
@@ -100,7 +100,7 @@ La configurazione globale sovrascrive i default remoti dell'organizzazione.
|
||||
|
||||
---
|
||||
|
||||
### Per progetto
|
||||
### Configurazione di progetto
|
||||
|
||||
Aggiungi `opencode.json` nella root del progetto. La configurazione di progetto ha la precedenza piu alta tra i file standard: sovrascrive sia la configurazione globale sia quella remota.
|
||||
|
||||
@@ -556,8 +556,7 @@ Puoi configurare le istruzioni per il modello che stai usando tramite l'opzione
|
||||
}
|
||||
```
|
||||
|
||||
Accetta un array di percorsi e pattern glob verso file di istruzioni. [Scopri di piu
|
||||
sulle regole](/docs/rules).
|
||||
Accetta un array di percorsi e pattern glob verso file di istruzioni. [Scopri di piu sulle regole](/docs/rules).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ Gli strumenti personalizzati sono funzioni che crei e che l'LLM puo chiamare dur
|
||||
|
||||
---
|
||||
|
||||
## Crea uno strumento
|
||||
## Creazione di uno strumento
|
||||
|
||||
Gli strumenti sono definiti come file **TypeScript** o **JavaScript**. Tuttavia, la definizione dello strumento puo invocare script scritti in **qualsiasi linguaggio**: TypeScript o JavaScript vengono usati solo per la definizione in se.
|
||||
|
||||
@@ -45,7 +45,7 @@ Il **nome del file** diventa il **nome dello strumento**. L'esempio sopra crea l
|
||||
|
||||
---
|
||||
|
||||
#### Multiple tools per file
|
||||
#### Strumenti multipli per file
|
||||
|
||||
Puoi anche esportare piu strumenti da un singolo file. Ogni export diventa **uno strumento separato** con nome **`<filename>_<exportname>`**:
|
||||
|
||||
@@ -133,7 +133,7 @@ Usa `context.worktree` per la root del worktree git.
|
||||
|
||||
## Esempi
|
||||
|
||||
### Scrivi uno strumento in Python
|
||||
### Scrivere uno strumento in Python
|
||||
|
||||
Puoi scrivere gli strumenti in qualunque linguaggio. Ecco un esempio che somma due numeri usando Python.
|
||||
|
||||
|
||||
@@ -19,13 +19,13 @@ Per iniziare con OpenCode Enterprise:
|
||||
|
||||
---
|
||||
|
||||
## Trial
|
||||
## Prova
|
||||
|
||||
OpenCode e open source e non memorizza alcun tuo codice o dato di contesto, quindi i tuoi sviluppatori possono semplicemente [iniziare](/docs/) e fare una prova.
|
||||
|
||||
---
|
||||
|
||||
### Data handling
|
||||
### Gestione dati
|
||||
|
||||
**OpenCode non memorizza il tuo codice o i tuoi dati di contesto.** Tutta l'elaborazione avviene in locale o tramite chiamate API dirette al tuo provider AI.
|
||||
|
||||
@@ -35,7 +35,7 @@ L'unica eccezione e la funzione opzionale `/share`.
|
||||
|
||||
---
|
||||
|
||||
#### Sharing conversations
|
||||
#### Condivisione conversazioni
|
||||
|
||||
Se un utente abilita la funzione `/share`, la conversazione e i dati associati vengono inviati al servizio che usiamo per ospitare queste pagine di condivisione su opencode.ai.
|
||||
|
||||
@@ -50,29 +50,29 @@ Ti consigliamo di disabilitarla durante la prova.
|
||||
}
|
||||
```
|
||||
|
||||
[Learn more about sharing](/docs/share).
|
||||
[Scopri di più sulla condivisione](/docs/share).
|
||||
|
||||
---
|
||||
|
||||
### Code ownership
|
||||
### Proprietà del codice
|
||||
|
||||
**Sei proprietario di tutto il codice prodotto da OpenCode.** Non ci sono restrizioni di licenza o rivendicazioni di proprieta.
|
||||
|
||||
---
|
||||
|
||||
## Pricing
|
||||
## Prezzi
|
||||
|
||||
Usiamo un modello per-seat per OpenCode Enterprise. Se hai un tuo gateway LLM, non addebitiamo i token usati. Per maggiori dettagli su prezzi e opzioni di implementazione, **<a href={email}>contattaci</a>**.
|
||||
|
||||
---
|
||||
|
||||
## Deployment
|
||||
## Distribuzione
|
||||
|
||||
Quando hai completato la prova e sei pronto a usare OpenCode nella tua organizzazione, puoi **<a href={email}>contattarci</a>** per discutere prezzi e opzioni di implementazione.
|
||||
|
||||
---
|
||||
|
||||
### Central Config
|
||||
### Configurazione centralizzata
|
||||
|
||||
Possiamo configurare OpenCode per usare un'unica config centralizzata per tutta l'organizzazione.
|
||||
|
||||
@@ -80,7 +80,7 @@ Questa config centralizzata puo integrarsi col provider SSO e garantisce che tut
|
||||
|
||||
---
|
||||
|
||||
### SSO integration
|
||||
### Integrazione SSO
|
||||
|
||||
Tramite la config centralizzata, OpenCode puo integrarsi col provider SSO della tua organizzazione per l'autenticazione.
|
||||
|
||||
@@ -88,7 +88,7 @@ Questo consente a OpenCode di ottenere credenziali per il gateway AI interno tra
|
||||
|
||||
---
|
||||
|
||||
### Internal AI gateway
|
||||
### Gateway AI interno
|
||||
|
||||
Con la config centralizzata, OpenCode puo anche essere configurato per usare solo il tuo gateway AI interno.
|
||||
|
||||
@@ -96,7 +96,7 @@ Puoi anche disabilitare tutti gli altri provider AI, assicurandoti che tutte le
|
||||
|
||||
---
|
||||
|
||||
### Self-hosting
|
||||
### Hosting autonomo
|
||||
|
||||
Anche se consigliamo di disabilitare le pagine di condivisione per assicurarti che i dati non escano mai dall'organizzazione, possiamo anche aiutarti a ospitarle sulla tua infrastruttura.
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ OpenCode formatta automaticamente i file dopo che vengono scritti o modificati u
|
||||
|
||||
---
|
||||
|
||||
## Built-in
|
||||
## Integrati
|
||||
|
||||
OpenCode include diversi formattatori integrati per linguaggi e framework popolari. Qui sotto trovi la lista dei formattatori, delle estensioni supportate e dei comandi o opzioni di config richiesti.
|
||||
|
||||
@@ -42,7 +42,7 @@ Quindi, se il progetto ha `prettier` in `package.json`, OpenCode lo usera automa
|
||||
|
||||
---
|
||||
|
||||
## How it works
|
||||
## Come funziona
|
||||
|
||||
Quando OpenCode scrive o modifica un file:
|
||||
|
||||
@@ -54,7 +54,7 @@ Questo processo avviene in background, mantenendo lo stile del codice senza pass
|
||||
|
||||
---
|
||||
|
||||
## Configure
|
||||
## Configurazione
|
||||
|
||||
Puoi personalizzare i formattatori nella sezione `formatter` della config di OpenCode.
|
||||
|
||||
@@ -78,7 +78,7 @@ Vediamo alcuni esempi.
|
||||
|
||||
---
|
||||
|
||||
### Disabling formatters
|
||||
### Disabilitare i formattatori
|
||||
|
||||
Per disabilitare **tutti** i formattatori globalmente, imposta `formatter` a `false`:
|
||||
|
||||
@@ -104,7 +104,7 @@ Per disabilitare un formattatore **specifico**, imposta `disabled` a `true`:
|
||||
|
||||
---
|
||||
|
||||
### Custom formatters
|
||||
### Formattatori personalizzati
|
||||
|
||||
Puoi sovrascrivere i formattatori integrati o aggiungerne di nuovi specificando comando, variabili d'ambiente ed estensioni file:
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ OpenCode si integra nel tuo workflow GitHub. Menziona `/opencode` o `/oc` in un
|
||||
|
||||
---
|
||||
|
||||
## Funzionalita'
|
||||
## Funzionalità
|
||||
|
||||
- **Triage delle issue**: chiedi a OpenCode di indagare su una issue e spiegartela.
|
||||
- **Fix e implementazioni**: chiedi a OpenCode di risolvere una issue o implementare una feature. Lavorera' su un nuovo branch e inviera' una PR con tutte le modifiche.
|
||||
|
||||
@@ -17,7 +17,7 @@ Qui usiamo un componente CI/CD creato dalla community per OpenCode — [nagyv/gi
|
||||
|
||||
---
|
||||
|
||||
### Funzionalita'
|
||||
### Funzionalità
|
||||
|
||||
- **Configurazione personalizzata per job**: configura OpenCode con una directory di configurazione personalizzata, ad esempio `./config/#custom-directory`, per abilitare o disabilitare funzionalita' per ogni invocazione di OpenCode.
|
||||
- **Setup minimo**: il componente CI prepara OpenCode in background; devi solo creare la configurazione OpenCode e il prompt iniziale.
|
||||
@@ -25,7 +25,7 @@ Qui usiamo un componente CI/CD creato dalla community per OpenCode — [nagyv/gi
|
||||
|
||||
---
|
||||
|
||||
### Setup
|
||||
### Configurazione
|
||||
|
||||
1. Salva il JSON di autenticazione di OpenCode come variabile d'ambiente CI di tipo File in **Settings** > **CI/CD** > **Variables**. Assicurati di marcarla come "Masked and hidden".
|
||||
2. Aggiungi quanto segue al tuo file `.gitlab-ci.yml`.
|
||||
@@ -51,7 +51,7 @@ Menziona `@opencode` in un commento e OpenCode eseguira' i task dentro la tua pi
|
||||
|
||||
---
|
||||
|
||||
### Funzionalita'
|
||||
### Funzionalità
|
||||
|
||||
- **Triage delle issue**: chiedi a OpenCode di indagare su una issue e spiegartela.
|
||||
- **Fix e implementazioni**: chiedi a OpenCode di risolvere una issue o implementare una feature.
|
||||
@@ -60,7 +60,7 @@ Menziona `@opencode` in un commento e OpenCode eseguira' i task dentro la tua pi
|
||||
|
||||
---
|
||||
|
||||
### Setup
|
||||
### Configurazione
|
||||
|
||||
OpenCode gira nella pipeline GitLab CI/CD. Ecco cosa ti serve per configurarlo:
|
||||
|
||||
|
||||
@@ -211,7 +211,7 @@ Questo e utile se c'e una parte della codebase su cui non hai lavorato.
|
||||
|
||||
---
|
||||
|
||||
### Aggiungi funzionalita
|
||||
### Aggiungi funzionalità
|
||||
|
||||
Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti consigliamo prima di chiedergli di creare un piano.
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ OpenCode usa [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) pe
|
||||
|
||||
---
|
||||
|
||||
## Providers
|
||||
## Provider
|
||||
|
||||
I provider piu popolari sono precaricati per impostazione predefinita. Se hai aggiunto le credenziali di un provider tramite il comando `/connect`, saranno disponibili quando avvii OpenCode.
|
||||
|
||||
@@ -63,7 +63,7 @@ Se hai configurato un [provider personalizzato](/docs/providers#custom), `provid
|
||||
|
||||
---
|
||||
|
||||
## Configure models
|
||||
## Configurazione modelli
|
||||
|
||||
Puoi configurare globalmente le opzioni di un modello tramite la config.
|
||||
|
||||
@@ -134,11 +134,11 @@ Puoi anche definire varianti personalizzate che estendono quelle integrate. Le v
|
||||
|
||||
---
|
||||
|
||||
## Variants
|
||||
## Varianti
|
||||
|
||||
Molti modelli supportano piu varianti con configurazioni diverse. OpenCode include varianti predefinite integrate per i provider piu comuni.
|
||||
|
||||
### Built-in variants
|
||||
### Varianti integrate
|
||||
|
||||
OpenCode include varianti predefinite per molti provider:
|
||||
|
||||
@@ -167,7 +167,7 @@ Varies by model but roughly:
|
||||
Questa lista non e completa. Anche molti altri provider hanno default integrati.
|
||||
:::
|
||||
|
||||
### Custom variants
|
||||
### Varianti personalizzate
|
||||
|
||||
Puoi sovrascrivere varianti esistenti o aggiungerne di tue:
|
||||
|
||||
@@ -194,13 +194,13 @@ Puoi sovrascrivere varianti esistenti o aggiungerne di tue:
|
||||
}
|
||||
```
|
||||
|
||||
### Cycle variants
|
||||
### Ciclare tra varianti
|
||||
|
||||
Usa il keybind `variant_cycle` per passare rapidamente tra le varianti. [Scopri di piu](/docs/keybinds).
|
||||
|
||||
---
|
||||
|
||||
## Loading models
|
||||
## Caricamento modelli
|
||||
|
||||
Quando OpenCode si avvia, controlla i modelli in questo ordine di priorita:
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Modalita
|
||||
title: Modalità
|
||||
description: Modalita diverse per casi d'uso diversi.
|
||||
---
|
||||
|
||||
@@ -41,7 +41,7 @@ Questa modalita e utile quando vuoi che l'AI analizzi il codice, suggerisca modi
|
||||
|
||||
---
|
||||
|
||||
## Cambiare modalita
|
||||
## Cambiare modalità
|
||||
|
||||
Puoi cambiare modalita durante una sessione usando il tasto _Tab_. In alternativa, puoi usare il keybind `switch_mode` che hai configurato.
|
||||
|
||||
@@ -49,7 +49,7 @@ Vedi anche: [Formatter](/docs/formatters) per informazioni sulla configurazione
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
## Configurazione
|
||||
|
||||
Puoi personalizzare le modalita integrate o crearne di tue tramite configurazione. Le modalita si possono configurare in due modi:
|
||||
|
||||
@@ -240,7 +240,7 @@ Ecco tutti gli strumenti che possono essere controllati tramite la configurazion
|
||||
|
||||
---
|
||||
|
||||
## Modalita personalizzate
|
||||
## Modalità personalizzate
|
||||
|
||||
Puoi creare modalita personalizzate aggiungendole alla configurazione. Ecco esempi con entrambi gli approcci:
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Providers
|
||||
title: Provider
|
||||
description: Usa qualsiasi provider LLM in OpenCode.
|
||||
---
|
||||
|
||||
|
||||
@@ -129,7 +129,7 @@ Il server opencode espone le seguenti API.
|
||||
|
||||
---
|
||||
|
||||
### Provider
|
||||
### Fornitori
|
||||
|
||||
| Metodo | Path | Descrizione | Response |
|
||||
| ------ | -------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------- |
|
||||
|
||||
@@ -8,7 +8,7 @@ Le skill vengono caricate on-demand tramite lo strumento nativo `skill`: gli age
|
||||
|
||||
---
|
||||
|
||||
## Posiziona i file
|
||||
## Posizione dei file
|
||||
|
||||
Crea una cartella per ogni nome di skill e metti un `SKILL.md` al suo interno.
|
||||
OpenCode cerca in queste posizioni:
|
||||
@@ -22,7 +22,7 @@ OpenCode cerca in queste posizioni:
|
||||
|
||||
---
|
||||
|
||||
## Comprendere la discovery
|
||||
## Discovery
|
||||
|
||||
Per i percorsi locali al progetto, OpenCode risale dalla directory di lavoro corrente finche' non raggiunge il worktree git.
|
||||
Carica qualsiasi `skills/*/SKILL.md` corrispondente in `.opencode/` e qualsiasi `.claude/skills/*/SKILL.md` o `.agents/skills/*/SKILL.md` corrispondente lungo il percorso.
|
||||
@@ -31,7 +31,7 @@ Le definizioni globali vengono caricate anche da `~/.config/opencode/skills/*/SK
|
||||
|
||||
---
|
||||
|
||||
## Scrivi il frontmatter
|
||||
## Frontmatter
|
||||
|
||||
Ogni `SKILL.md` deve iniziare con frontmatter YAML.
|
||||
Sono riconosciuti solo questi campi:
|
||||
@@ -46,7 +46,7 @@ I campi di frontmatter sconosciuti vengono ignorati.
|
||||
|
||||
---
|
||||
|
||||
## Valida i nomi
|
||||
## Validazione nomi
|
||||
|
||||
`name` deve:
|
||||
|
||||
@@ -64,14 +64,14 @@ Regex equivalente:
|
||||
|
||||
---
|
||||
|
||||
## Rispetta le regole di lunghezza
|
||||
## Regole di lunghezza
|
||||
|
||||
`description` deve essere lunga 1-1024 caratteri.
|
||||
Tieni la descrizione abbastanza specifica da permettere all'agente di scegliere correttamente.
|
||||
|
||||
---
|
||||
|
||||
## Usa un esempio
|
||||
## Esempio
|
||||
|
||||
Crea `.opencode/skills/git-release/SKILL.md` cosi':
|
||||
|
||||
@@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear.
|
||||
|
||||
---
|
||||
|
||||
## Riconoscere la descrizione dello strumento
|
||||
## Descrizione strumento
|
||||
|
||||
OpenCode elenca le skill disponibili nella descrizione dello strumento `skill`.
|
||||
Ogni voce include il nome della skill e la descrizione:
|
||||
@@ -122,7 +122,7 @@ skill({ name: "git-release" })
|
||||
|
||||
---
|
||||
|
||||
## Configura i permessi
|
||||
## Permessi
|
||||
|
||||
Controlla a quali skill gli agenti possono accedere usando permessi basati su pattern in `opencode.json`:
|
||||
|
||||
@@ -149,7 +149,7 @@ I pattern supportano wildcard: `internal-*` corrisponde a `internal-docs`, `inte
|
||||
|
||||
---
|
||||
|
||||
## Sovrascrivi per agente
|
||||
## Sovrascrittura per agente
|
||||
|
||||
Dai ad agenti specifici permessi diversi dai default globali.
|
||||
|
||||
@@ -181,7 +181,7 @@ permission:
|
||||
|
||||
---
|
||||
|
||||
## Disabilita lo strumento skill
|
||||
## Disabilitare skill
|
||||
|
||||
Disabilita completamente le skill per agenti che non dovrebbero usarle:
|
||||
|
||||
@@ -212,7 +212,7 @@ Quando e' disabilitato, la sezione `<available_skills>` viene omessa completamen
|
||||
|
||||
---
|
||||
|
||||
## Risoluzione problemi di caricamento
|
||||
## Risoluzione problemi
|
||||
|
||||
Se una skill non compare:
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ Di default, tutti gli strumenti sono **abilitati** e non richiedono permessi per
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
## Configurazione
|
||||
|
||||
Usa il campo `permission` per controllare il comportamento degli strumenti. Puoi consentire, negare o richiedere approvazione per ciascuno.
|
||||
|
||||
|
||||
@@ -350,7 +350,7 @@ Alcuni editor richiedono argomenti da riga di comando per funzionare in modalita
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
## Configurazione
|
||||
|
||||
Puoi personalizzare il comportamento della TUI tramite il file di config di OpenCode.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user