> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consigli sui prompt

> Suggerimenti per scrivere al meglio i prompt e reindirizzare Devin

export const PromptBlock = ({children, type, agent, intent, playbookId}) => {
  var utm = 'utm_source=docs&utm_medium=use-case-gallery&utm_campaign=prompt-block';
  var tag = 'docs-use-case-gallery';
  var agentParams = (agent ? '&agent=' + agent : '') + (intent ? '&intent=' + intent : '') + (playbookId ? '&playbookId=' + playbookId : '');
  var label = type === 'schedule' ? 'Schedule in Devin' : type === 'playbook' ? 'Create Playbook' : type === 'knowledge' ? 'Add to Knowledge' : agent === 'advanced' ? 'Try in Devin' : agent === 'dana' ? 'Try in Dana' : agent === 'ada' ? 'Try in Ask Devin' : 'Try in Devin';
  var buildUrl = function (text) {
    var encoded = encodeURIComponent(text);
    if (type === 'schedule') return 'https://app.devin.ai/settings/schedules/create?' + utm + agentParams + '&prompt=' + encoded;
    if (type === 'playbook') return 'https://app.devin.ai/settings/playbooks/create?' + utm + '&body=' + encoded;
    if (type === 'knowledge') return 'https://app.devin.ai/knowledge?' + utm + '&body=' + encoded;
    if (agent === 'ada') return 'https://app.devin.ai/search?' + utm + '&noSubmit=true&prompt=' + encoded;
    return 'https://app.devin.ai/?tags=' + tag + '&' + utm + agentParams + '&prompt=' + encoded;
  };
  const ref = React.useRef(null);
  const [href, setHref] = React.useState('#');
  React.useEffect(() => {
    if (!ref.current) return;
    var codeEl = ref.current.querySelector('pre code');
    if (codeEl) {
      var text = codeEl.textContent.trim();
      if (text) setHref(buildUrl(text));
    }
    var header = ref.current.querySelector('[data-component-part="code-block-header"]');
    if (header && !header.querySelector('.prompt-block-devin-link')) {
      var link = document.createElement('a');
      link.href = href;
      link.target = '_blank';
      link.rel = 'noopener noreferrer';
      link.className = 'prompt-block-devin-link';
      link.style.cssText = 'display:inline-flex;align-items:center;gap:6px;text-decoration:none;color:#fff;font-size:11px;font-weight:500;padding:4px 10px;border-radius:6px;white-space:nowrap;background:#317CFF;transition:background 0.2s;margin-left:8px;';
      link.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" y1="14" x2="21" y2="3"/></svg> ' + label;
      link.onmouseenter = function () {
        link.style.background = '#2968D9';
      };
      link.onmouseleave = function () {
        link.style.background = '#317CFF';
      };
      header.appendChild(link);
    }
    var existingLink = ref.current.querySelector('.prompt-block-devin-link');
    if (existingLink && href !== '#') existingLink.href = href;
  });
  return <div className="prompt-block" ref={ref}>{children}</div>;
};

<Tip>Per una panoramica completa delle best practice, vedi anche [Instructing Devin Effectively](/it/essential-guidelines/instructing-devin-effectively) e [Good vs. Bad Instructions](/it/essential-guidelines/good-vs-bad-instructions).</Tip>

Devin ha bisogno di indicazioni sulle tue preferenze e su come verificare se è sulla strada giusta. Se non gli fornisci queste indicazioni, Devin prenderà decisioni in autonomia. Ti consigliamo di seguire una struttura semplice nei tuoi prompt per assicurarti che Devin resti allineato e controlli il proprio lavoro:

<CardGroup cols={1}>
  <Card title="Cosa" icon="block-question" horizontal>
    Descrivi l'attività che vuoi che Devin porti a termine.

    **Esempio**: Aggiorna il mio progetto da Java 7 a Java 8.
  </Card>

  <Card title="Come" icon="chalkboard-user" horizontal>
    Descrivi alcune indicazioni su cosa fare e cosa evitare per Devin durante l'esecuzione dell'attività (ad es. effettua il deploy usando Modal, ecc.)

    **Esempio**: Identifica e sostituisci le API Java 7 deprecate con le loro equivalenti in Java 8. Analizza la codebase per potenziali miglioramenti del linguaggio e delle API di Java 8.
  </Card>

  <Card title="Risultato" icon="print" horizontal>
    Descrivi i risultati o i comportamenti attesi che Devin dovrebbe verificare, così che sappia quando l'attività è completata.

    **Esempio**: Esegui la suite di test e verifica che tutti i test vengano superati correttamente. Compila il progetto usando la configurazione aggiornata a Java 8 e verifica che l'applicazione sia attiva e funzionante.
  </Card>
</CardGroup>

<div id="choosing-the-right-tasks">
  ### Scelta delle attività giuste
</div>

Quando decidi cosa delegare a Devin, cerca attività che abbiano:

1. **Criteri di successo chiari**

   * Attività il cui successo può essere verificato automaticamente
   * Cicli di feedback integrati (test, compilazione, controlli di linting)
   * Misure oggettive della qualità

2. **Ambito appropriato**

   * Confini ben definiti e requisiti chiari
   * Pattern chiari da seguire nel tuo codebase
   * Come regola generale, le attività che ti richiederebbero tre ore o meno sono perfette

3. **Elementi ripetitivi**

   * Attività che richiedono modifiche simili applicate molte volte
   * Varianti che rendono difficile affidarsi solo a script
   * Esempi esistenti da seguire

4. **Esempi comuni**
   * Aggiornamenti di versione su più pacchetti
   * Aggiunta di copertura dei test a moduli non testati
   * Conversione di file per usare nuovi pattern/standard
   * Implementazione di componenti UI standard

<div id="split-complex-tasks-into-simpler-sub-tasks-across-multiple-sessions">
  #### Suddividi le attività complesse in sotto-attività più semplici, distribuite su più sessioni
</div>

Devin ha maggiori probabilità di avere successo se i progetti complessi vengono suddivisi in sotto-attività chiare. Ad esempio, invece di chiedere a Devin di aggiornare il codice della tua applicazione, la test suite e la configurazione CI in un'unica sessione, potresti suddividere il lavoro in tre sessioni distinte. Puoi eseguirle in parallelo [chiedendo a Devin di delegare a Devin gestiti](/it/work-with-devin/advanced-capabilities#managed-devins).

Per attività particolarmente complesse, ti consigliamo di lavorare con Devin in più sessioni distinte, **poiché le prestazioni di Devin a volte possono degradarsi man mano che la sessione si allunga**.

<div id="tell-devin-how-to-check-its-progress">
  #### Indica a Devin come verificare i propri progressi
</div>

Devin offre i risultati migliori quando riceve passaggi di verifica chiari per validare il proprio lavoro. Questo aiuta a garantire che l'attività venga completata correttamente e consente a Devin di individuare potenziali problemi in anticipo.

Ecco un elenco non esaustivo di alcuni modi per aiutare Devin a verificare il proprio lavoro:

1. **Specifica i requisiti di test**

   * Chiedi a Devin di eseguire suite di test specifiche
   * Definisci quali test devono passare
   * Richiedi, se rilevante, metriche di copertura dei test

2. **Definisci checkpoint e sotto-attività chiari**

   * Suddividi attività complesse in sotto-attività verificabili e avvia una sessione Devin per ciascuna sotto-attività
   * Definisci cosa significa successo per ciascuna sotto-attività e, facoltativamente, i checkpoint all'interno di ogni sotto-attività
   * Chiedi a Devin di fornire un resoconto dopo aver completato ciascun checkpoint / sotto-attività

3. **Indica a Devin come controllare il proprio lavoro**

   Chiarisci come Devin può verificare di essere sulla strada giusta. Ad esempio:

   * Quando lavori con dataset: "Verifica che il dataset abbia almeno 500 righe e contenga le colonne X, Y, Z"
   * Quando modifichi API: "Conferma che l'endpoint restituisca il codice di stato 200 e includa tutti i campi richiesti"
   * Quando aggiorni la UI: "Controlla che il componente venga visualizzato senza errori in console e che corrisponda alle specifiche di design"

Quanto più sei specifico riguardo ai requisiti di validazione, tanto più con sicurezza Devin potrà procedere con l'attività senza interventi.

<div id="be-clear-and-specific">
  #### Sii chiaro e specifico
</div>

Fornisci istruzioni e requisiti chiari e dettagliati per Devin. Ad esempio, prova a:

1. Specificare i passaggi fondamentali necessari per completare un'attività
2. Indicare i repository, le librerie, i branch specifici, ecc. con cui vuoi che Devin lavori

Per Devin niente è “troppo ovvio”, ma farà del suo meglio per chiarire i dettagli e porre domande durante il processo.

<div id="use-playbooks">
  #### Usa i playbook
</div>

Per attività ripetitive o complesse, consigliamo di usare e perfezionare i [playbook](/it/product-guides/creating-playbooks). I playbook sono prompt facilmente riutilizzabili e condivisibili. Ad esempio, se vuoi che Devin gestisca errori ricorrenti nelle build CI, puoi creare un playbook che includa i passaggi generali che Devin dovrebbe seguire ogni volta per risolvere il problema, senza doverli inserire in ogni prompt.

<div id="provide-references-or-examples">
  #### Fornisci riferimenti o esempi
</div>

Quando possibile, includi link a documentazione o esempi rilevanti per l’attività. Se non fornisci alcuna risorsa, Devin potrebbe cercare la documentazione in modo autonomo.

<div id="jump-in">
  #### Inizia subito!
</div>

Fai domande a Devin e dagli istruzioni mentre lavora, proprio come faresti con qualsiasi altro collega!