Strumenti

Gli strumenti consentono all'LLM di eseguire azioni nel tuo codebase. Dropstone viene fornito con un set di strumenti integrati, ma puoi estenderlo con strumenti personalizzati o server MCP.

Per impostazione predefinita, tutti gli strumenti sono abilitati e non richiedono autorizzazione per l'esecuzione. Puoi controllare il comportamento degli strumenti tramite permessi.

Configura

Utilizza il campo permission per controllare il comportamento degli strumenti. Puoi consentire, negare o richiedere l'approvazione per ogni strumento.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "edit": "deny",
    "bash": "ask",
    "webfetch": "allow"
  }
}

Puoi anche utilizzare i caratteri jolly per controllare più strumenti contemporaneamente. Ad esempio, per richiedere l'approvazione per tutti gli strumenti di un server MCP:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "mymcp_*": "ask"
  }
}

Scopri di più sulla configurazione dei permessi.

Integrati

Ecco tutti gli strumenti integrati disponibili in Dropstone.

bash

Esegui comandi shell nell'ambiente del tuo progetto.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "bash": "allow"
  }
}

Questo strumento consente all'LLM di eseguire comandi terminali come npm install, git status o qualsiasi altro comando shell.

edit

Modifica i file esistenti utilizzando sostituzioni di stringhe esatte.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "edit": "allow"
  }
}

Questo strumento esegue modifiche precise ai file sostituendo corrispondenze di testo esatte. È il modo principale in cui l'LLM modifica il codice.

write

Crea nuovi file o sovrascrivi quelli esistenti.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "edit": "allow"
  }
}

Utilizza questo per consentire all'LLM di creare nuovi file. Sovrascriverà i file esistenti se già presenti.

read

Leggi il contenuto dei file dal tuo codebase.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "read": "allow"
  }
}

Questo strumento legge i file e restituisce il loro contenuto. Supporta la lettura di intervalli di righe specifici per file di grandi dimensioni.

grep

Cerca il contenuto dei file utilizzando espressioni regolari.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "grep": "allow"
  }
}

Ricerca veloce dei contenuti nel tuo codebase. Supporta la sintassi regex completa e il filtraggio dei pattern di file.

glob

Trova file tramite pattern matching.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "glob": "allow"
  }
}

Cerca file utilizzando pattern glob come **/*.js o src/**/*.ts. Restituisce i percorsi dei file corrispondenti ordinati per ora di modifica.

lsp (sperimentale)

Interagisci con i tuoi server LSP configurati per ottenere funzionalità di intelligenza del codice come definizioni, riferimenti, informazioni al passaggio del mouse e gerarchia delle chiamate.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "lsp": "allow"
  }
}

Le operazioni supportate includono goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls e outgoingCalls.

Per configurare quali server LSP sono disponibili per il tuo progetto, vedi Server LSP.

apply_patch

Applica patch ai file.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "edit": "allow"
  }
}

Questo strumento applica file patch al tuo codebase. Utile per applicare diff e patch da varie fonti.

Quando gestisci gli hook tool.execute.before o tool.execute.after, controlla input.tool === "apply_patch" (non "patch").

apply_patch utilizza output.args.patchText invece di output.args.filePath. I percorsi sono incorporati nelle righe marcatore all'interno di patchText e sono relativi alla radice del progetto (ad esempio: *** Add File: src/new-file.ts, *** Update File: src/existing.ts, *** Move to: src/renamed.ts, *** Delete File: src/obsolete.ts).

skill

Carica una skill (un file SKILL.md) e restituisci il suo contenuto nella conversazione.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "skill": "allow"
  }
}

todowrite

Gestisci elenchi di attività durante le sessioni di codifica.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "todowrite": "allow"
  }
}

Crea e aggiorna elenchi di attività per tracciare i progressi durante operazioni complesse. L'LLM utilizza questo per organizzare attività multi-step.

webfetch

Recupera contenuti web.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "webfetch": "allow"
  }
}

Consente all'LLM di recuperare e leggere pagine web. Utile per consultare la documentazione o ricercare risorse online.

websearch

Cerca il web per informazioni. Disponibile per impostazione predefinita quando sei connesso a Dropstone.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "websearch": "allow"
  }
}

Esegue ricerche web per trovare informazioni rilevanti online. Utile per ricercare argomenti, trovare eventi attuali o raccogliere informazioni oltre la data di cutoff dell'addestramento. Non è richiesta alcuna chiave API o configurazione aggiuntiva quando sei connesso a Dropstone.

question

Poni domande all'utente durante l'esecuzione.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "question": "allow"
  }
}

Questo strumento consente all'LLM di porre domande all'utente durante un'attività. È utile per:

• Raccogliere preferenze o requisiti dell'utente
• Chiarire istruzioni ambigue
• Ottenere decisioni su scelte di implementazione
• Offrire scelte sulla direzione da intraprendere

Ogni domanda include un'intestazione, il testo della domanda e un elenco di opzioni. Gli utenti possono selezionare dalle opzioni fornite o digitare una risposta personalizzata. Quando ci sono più domande, gli utenti possono navigare tra loro prima di inviare tutte le risposte.

Strumenti personalizzati

Gli strumenti personalizzati ti consentono di definire le tue funzioni che l'LLM può chiamare. Questi sono definiti nel tuo file di configurazione e possono eseguire codice arbitrario.

Scopri di più sulla creazione di strumenti personalizzati.

Server MCP

I server MCP (Model Context Protocol) ti consentono di integrare strumenti e servizi esterni. Questo include accesso ai database, integrazioni API e servizi di terze parti.

Scopri di più sulla configurazione dei server MCP.

Ignora i pattern

Per impostazione predefinita, grep e glob rispettano il tuo .gitignore: i file e le directory elencati lì sono esclusi dalle ricerche e dagli elenchi.

Per includere file che normalmente verrebbero ignorati, crea un file .ignore nella radice del tuo progetto. Questo file può consentire esplicitamente determinati percorsi.

!node_modules/
!dist/
!build/

Ad esempio, questo file .ignore consente la ricerca all'interno delle directory node_modules/, dist/ e build/ anche se sono elencate in .gitignore.