View a markdown version of this page

Agenti personalizzati - Amazon Quick

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Agenti personalizzati

L'agente personalizzato è un'azione intelligente che elabora gli input in linguaggio naturale per automatizzare passaggi complessi utilizzando funzionalità integrate di chiamata degli strumenti. Utilizza principalmente le integrazioni come interfaccia dello strumento, offrendo al contempo l'estensibilità per utilizzare Code come strumento e altre azioni native come l'attività human-in-the-loop. L'agente fornisce output strutturati e prevedibili ottimizzati per una perfetta integrazione nelle fasi di automazione a valle.

Properties

  • Titolo: nome dell'agente step/custom

  • Modalità: una modalità definisce il funzionamento dell'agente in base al caso d'uso. Le tre modalità disponibili sono: Fast, Pro e Custom. Fast è ideale per attività semplici come riepilogo, classificazione e automazioni ad alto volume, mentre Pro è ideale per attività complesse che implicano il ragionamento e l'orchestrazione di più strumenti o azioni. Fast e Pro sono modalità completamente gestite che non richiedono alcuna configurazione preimpostata. In modalità personalizzata, avrai bisogno di un connettore runtime Bedrock e potrai selezionare il modello che desideri utilizzare (spiegato di seguito). È ideale quando avete già un prompt ottimizzato per un particolare modello Bedrock, avete bisogno in particolare di un particolare modello Bedrock per l'Agent o desiderate includere il vostro modello personalizzato o ottimizzato ospitato su Bedrock. In modalità personalizzata, poiché si importa il proprio modello da Bedrock tramite un'integrazione, l'inferenza del modello viene fatturata separatamente all'account associato a tale integrazione Bedrock.

  • Istruzioni: in questo campo si scrive il prompt per l'agente in linguaggio naturale. Procedure consigliate per la stesura del prompt:

    • Sii chiaro ed esplicito su ciò che desideri.

    • Struttura il prompt. Inizia citando prima l' "Attività» o il «Ruolo» e poi le «Istruzioni» per completare l'attività con passaggi numerati

    • Per migliorare la precisione nell'utilizzo degli strumenti e guidare l'agente, specifica chiaramente nel prompt quale strumento utilizzare in ogni fase, se applicabile.

    • Specificate chiaramente i requisiti di lunghezza (ad esempio, meno di 100 parole) o il formato di output (ad esempio, il formato della data) MM/DD/YY

    • Raccogli il testo tra virgolette triple («"») per scrivere istruzioni su più righe. Esempio:

      """You are content summarization agent. Summarize the last two paragraphs of the provided text, focusing only on the main conclusion."""
  • Azioni: Action è uno strumento che consente all'agente AI di interagire con sistemi esterni o eseguire attività specifiche. Questo è facoltativo. È possibile eseguire l'agente personalizzato senza alcuna azione. Di seguito sono elencate le diverse azioni che possono essere utilizzate nell'agente personalizzato

    • Azioni generali

      • Crea attività utente: se abilitato, questo strumento consente all'agente di attivare un'attività Human-in-the-Loop (HITL) ogni volta che si blocca e necessita di assistenza durante l'esecuzione. L'agente si ferma e attende l'input umano. L'attività HITL è visibile nel task center. Per ottenere risultati ottimali, l'autore può specificare nel prompt esattamente quando l'agente deve richiamare HITL. Questa opzione è selezionata per impostazione predefinita. L'automazione viene eseguita fino al termine dell'attività.

      • Codice: l'azione Codice genera ed esegue codice python all'interno di un ambiente python limitato, come le azioni di codice, per risolvere attività che coinvolgono calcoli, manipolazione dei dati ed elaborazione di file. A differenza dei generatori di codice, crea ed esegue attivamente script per raggiungere gli obiettivi, lavorando con Excel, file PDF, vari formati di dati e integrazioni disponibili

        • Funzionalità chiave:

          • Operazioni sui file: elabora file Excel multischeda, estrai contenuti, esegui calcoli delle date, applica la formattazione condizionale e carica i risultati su S3

          • Trasformazione dei dati: converti tra formati JSON e tabelle, trasponi dati, rinomina colonne e unisci tabelle

          • Calcoli avanzati: generazione di sequenze numeriche ed esecuzione di convalide automatiche

    • Integrazioni: se hai aggiunto azioni di integrazione specifiche, come Salesforce, MS Exchange o Bedrock, al tuo gruppo di automazione, le azioni corrispondenti vengono visualizzate qui per essere utilizzate nell'agente personalizzato. L'autore può quindi selezionare le azioni pertinenti da utilizzare come strumenti per l'agente.

      Elenco di integrazioni che possono essere utilizzate come tools/actions nell'agente personalizzato

      • Simple Storage Service (Amazon S3)

      • Automazione dei dati Amazon Bedrock

      • Amazon Comprehend

      • Amazon Textract

      • API REST personalizzata

      • Connettore MCP personalizzato

      • Microsoft Outlook

      • Salesforce

  • Output strutturato (opzionale)

    Configura il tuo agente AI per restituire un output JSON strutturato che le fasi successive possono elaborare. Questa funzionalità è ideale per il riepilogo del testo, la generazione di report, la trasformazione dei dati e l'estrazione di statistiche da contenuti non strutturati. Questo campo è opzionale. Se non si definisce un output strutturato, l'agente restituisce l'output in linguaggio naturale per impostazione predefinita. Utilizzate l'output strutturato quando l'output ha una struttura definita, ad esempio un elenco, una tabella di dati o JSON.

    Nota

    La configurazione di output strutturata per gli agenti personalizzati segue lo stesso formato degli agenti dell'interfaccia utente. Per istruzioni di configurazione dettagliate, consulta la sezione sull'output strutturato dell'agente UI.

  • Risposta dell'agente: nome della variabile a cui assegnare l'output dell'agente. La risposta segue il formato di output strutturato in uno schema JSON, se definito, altrimenti è un testo in formato libero.

Utilizzo di modelli personalizzati in Custom Agent (Bring your own bedrock model)

Integra i modelli desiderati o personalizzati ospitati in AWS Bedrock con i flussi di lavoro di automazione Quick Suite.

Prima di iniziare, assicurati di disporre di quanto segue:

  • Un modello ottimizzato distribuito e accessibile in Bedrock AWS

  • Accesso Quick Suite Admin per la creazione di connettori

  • Un ruolo IAM con autorizzazioni Bedrock per richiamare modelli

  • L'ID del tuo modello (ad esempio,) us.anthropic.claude-3-5-sonnet-20241022-v2:0

Fase 1: Creare un'integrazione con Bedrock Runtime Action seguendo le istruzioni dettagliate in AWS connettori service action

Fase 2: Configura il tuo gruppo di automazione

Crea un gruppo di automazione e collega l'integrazione:

  • Crea un gruppo di automazione: segui le istruzioni dettagliate in Attività di configurazione

  • Configura le integrazioni: segui le istruzioni dettagliate in Attività di configurazione

  • Una volta configurato, il connettore viene visualizzato nell'elenco delle risorse disponibili

Fase 3: Configurazione di un agente personalizzato

Aggiungi e configura un agente personalizzato per utilizzare il tuo modello ottimizzato:

  • All'interno del flusso di lavoro di automazione, aggiungi un agente personalizzato

  • Configura le seguenti impostazioni dell'agente:

    • Titolo dell'agente: inserisci un nome descrittivo per il tuo agente

    • Istruzioni: inserisci istruzioni personalizzate personalizzate in base al tuo caso d'uso

    • Modalità: seleziona Personalizzato

    • Connettore: scegli il connettore Bedrock Runtime (richiesto quando è selezionata la modalità personalizzata)

    • Modello personalizzato: inserisci l'ID del modello (ad esempio,us.anthropic.claude-3-5-sonnet-20241022-v2:0), obbligatorio quando è selezionata la modalità personalizzata

Fasi successive

Una volta configurato, l'agente personalizzato utilizza il modello ottimizzato per elaborare le richieste in base alle istruzioni fornite. Ora puoi incorporare questo agente nei tuoi flussi di lavoro Quick Automate.

Nota

Assicurati che l'ID del modello sia formattato correttamente e corrisponda al modello distribuito nel tuo account Bedrock. AWS Puoi trovare l'ID del modello nella console AWS Bedrock sotto i modelli forniti.

Test personalizzati con agenti

Il test personalizzato degli agenti consente di testare singoli agenti indipendentemente dall'intero flusso di lavoro di automazione. Questa funzionalità consente di convalidare il comportamento degli agenti, eseguire il debug delle richieste e iterare in modo più efficiente senza eseguire l'intero flusso di lavoro.

Prerequisiti

  • Un flusso di lavoro di automazione con almeno un agente personalizzato configurato

  • Autorizzazioni appropriate per eseguire automazioni nell'area di lavoro

Inizia un test

  • Nell'area di disegno del flusso di lavoro, passa il mouse sulla scheda dell'agente che desideri testare

  • Scegli il pulsante Unit test che appare nella parte superiore della scheda

  • Nella finestra di raccolta delle variabili che si apre, esamina le variabili rilevate automaticamente dal prompt del tuo agente

    • L'anteprima del prompt mostra tutte le variabili rilevate con evidenziazione

  • Immettete un valore per ogni variabile

    • I valori devono utilizzare una sintassi di espressione valida

    • Se un valore contiene una sintassi non valida, viene visualizzato un messaggio di errore che impedisce l'esecuzione del test

Monitora l'esecuzione del test

Durante l'esecuzione del test, puoi monitorare l'avanzamento nel pannello di controllo sul lato destro dello schermo. Il test salta tutti i passaggi precedenti del flusso di lavoro ed esegue solo l'agente selezionato. Ottieni la stessa esperienza di registrazione di un intero flusso di lavoro.

Rivedi i risultati dei test

Al termine del test, esaminate le seguenti informazioni nel pannello Test:

  • Scheda metrica (scheda Monitor nella parte superiore del pannello Test)

    • Tempo totale di esecuzione

    • Numero di strumenti utilizzati

    • Numero di attività create

  • Effettua il login tra

  • Guarda la scheda Variables (fisarmonica inferiore del pannello Test)

    • Input: visualizza le variabili di input e i relativi valori

    • Output: esamina i risultati di output dell'esecuzione dell'agente

    • Per gli output strutturati, fate clic sul pulsante Visualizza dettagli per scegliere il visualizzatore JSON per aprire la finestra di dialogo Visualizza output:

      • Scheda Campi: naviga tra i dati utilizzando la visualizzazione della struttura ad albero

      • Campi: evidenzia i valori corrispondenti selezionando i nodi ad albero nella scheda Campi

      • Campi di output: valori corrispondenti per le chiavi JSON

Utilizzo dell'agente personalizzato con Build with Assistant

Il principio attuale dell'agente personalizzato è che deve essere menzionato specificamente per farlo invocare in modo coerente, ecco le cose necessarie nel prompt per farlo apparire:

- Function names: `use_inline_agent` - Representation names: "Custom Agent", "Inline Agent" → use `use_inline_agent` - Generic terms: "agentic skills" → default to `use_inline_agent`

Altrimenti, si preferisce utilizzare il modello per creare il flusso di lavoro in modo deterministico.

Tuttavia, in pratica, quando non sono disponibili azioni appropriate, Planner potrebbe scegliere un agente personalizzato come soluzione alternativa. Tuttavia, per richiamare in modo coerente l'agente personalizzato nel flusso di lavoro, si consiglia di utilizzare le frasi precedenti nel prompt.

Esempi di casi d'uso degli agenti

Caso d'uso 1: agente di classificazione e assegnazione delle e-mail

Ruolo: sei un agente di categorizzazione e assegnazione delle e-mail

Istruzioni: segui questi passaggi:

  • Passaggio 1: classifica l'e-mail in arrivo in base alla colonna Categoria della tabella di riferimento fornita come conoscenza

  • Passaggio 2: utilizza il sistema di posta elettronica per inviare una notifica:

    • Da: [system_email]

    • A: [team_distribution_email]

    • Oggetto: [Risultato della classificazione]

    • Corpo: includi un breve riepilogo che spieghi la classificazione, il ragionamento e i punti chiave dell'e-mail originale

  • Passaggio 3: Per tutte le categorie valide (eccetto «sconosciuto»), crea un nuovo caso in Salesforce con:

    • Oggetto: [Oggetto dell'email originale]

    • Descrizione: problema riepilogato dal corpo dell'e-mail

    • Priorità: in base all'urgenza dei contenuti () High/Medium/Low

    • Tipo: seleziona il tipo appropriato () Question/Problem/Feature Request/Other

    • Stato: 'Nuovo'

    • Categoria: [Risultato della classificazione della Fase 1]

  • Fase 4: Se classificato come «sconosciuto»:

    • Passa a supervisore per la revisione manuale

    • Aggiungi una nota che spiega perché la classificazione era incerta

    • In base alla categoria ricevuta dal supervisore, segui i passaggi 2 e 3 e fermati

    • Se la categoria ricevuta dal supervisore è sconosciuta o non valida, interrompi

Utilizzo delle knowledge base con agenti personalizzati

In Amazon Quick Automate, puoi collegare le knowledge base agli agenti personalizzati per consentire il AI-powered recupero e la risposta alle domande sui documenti della tua organizzazione. Collegando uno spazio Quick al tuo gruppo di automazione, gli agenti personalizzati possono cercare e recuperare informazioni dalle knowledge base all'interno di quello spazio.

Utilizzalo per le automazioni che devono fare riferimento alle conoscenze organizzative, ad esempio per rispondere a domande contenute nei documenti relativi alle politiche, riepilogare i report o classificare i contenuti in base a dati di riferimento.

Le knowledge base indicizzano i documenti per la ricerca semantica, in modo che l'agente personalizzato recuperi solo i passaggi più pertinenti anziché elaborare interi file. Ciò rende il recupero più rapido e accurato, soprattutto su set di documenti di grandi dimensioni.

Prerequisiti

Prima che un agente personalizzato possa accedere alle knowledge base, è necessario collegare lo spazio che contiene tali knowledge base al gruppo di automazione. Il collegamento di uno spazio concede al gruppo di automazione l'autorizzazione ad accedere alle knowledge base e ai file all'interno di quello spazio.

Per collegare uno spazio a un gruppo di automazione:

  1. Nella scheda Automazioni, vai alla pagina Progetti.

  2. Scegli Gruppi e seleziona il gruppo a cui vuoi allegare lo spazio.

    Suggerimento

    Puoi anche scegliere Crea gruppo sul lato destro per creare un nuovo gruppo di automazione.

  3. Nella sezione Risorse, scegli Aggiungi, quindi scegli Spazi.

  4. Seleziona lo spazio che contiene le knowledge base che desideri utilizzare, quindi scegli Aggiungi.

Lo spazio ora appare nell'elenco delle connessioni del gruppo di automazione. Gli agenti personalizzati di questo gruppo di automazione possono accedere alle knowledge base e ai file all'interno dello spazio collegato. Le altre risorse presenti nello spazio non sono disponibili per le automazioni.

Nota

Se lo spazio mostra Accesso limitato dopo l'aggiunta, significa che non tutte le knowledge base sono condivise con il gruppo di automazione. Ciò può accadere se le knowledge base sono state aggiunte allo spazio dopo il collegamento o se inizialmente non tutte le knowledge base sono state condivise. Per risolvere questo problema, aggiorna la connessione allo spazio per condividere tutte le risorse con il gruppo di automazione. Non è necessario riconfigurare la scheda Conoscenze sui singoli agenti personalizzati.

Aggiungi conoscenze a un agente personalizzato

Dopo aver collegato uno spazio al gruppo di automazione, è possibile configurare un agente personalizzato per utilizzare le knowledge base all'interno di tale spazio. Il flusso di lavoro deve appartenere allo stesso gruppo di automazione a cui è stato collegato lo spazio.

Per aggiungere conoscenze a un agente personalizzato:

  1. Nel generatore di flussi di lavoro, aggiungi un passaggio Custom Agent. Puoi trascinare e rilasciare un nodo Custom Agent sull'area di lavoro o chattare con l'assistente di automazione per creare questo passaggio.

  2. Nel pannello delle proprietà dell'agente, scegli Conoscenza, quindi scegli Aggiungi.

  3. Si apre un selettore che mostra gli spazi disponibili collegati al gruppo di automazione. Seleziona uno o più spazi che contengono le knowledge base che desideri che l'agente utilizzi.

  4. Scegli Save (Salva).

L'agente personalizzato può ora cercare e recuperare contenuti dalle knowledge base negli spazi selezionati durante l'esecuzione dell'automazione.

Quando si collega uno spazio, tutte le knowledge base all'interno di tale spazio diventano automaticamente disponibili per l'agente. Non è necessario allegare ogni knowledge base singolarmente. In fase di esecuzione, l'agente interroga ogni knowledge base in modo indipendente e combina i risultati nella sua risposta.

Nota

Se il proprietario del gruppo di automazione perde l'accesso a una specifica knowledge base all'interno dello spazio, tale knowledge base viene ignorata durante le interrogazioni e l'editor del flusso di lavoro visualizza un badge di avviso sullo spazio allegato.

Istruzioni di scrittura per le interrogazioni della Knowledge Base

Quando un agente personalizzato dispone di una knowledge base allegata, cerca e recupera automaticamente i contenuti pertinenti in base alle istruzioni fornite dall'utente. Scrivi istruzioni che descrivano chiaramente quali informazioni l'agente deve trovare o come deve utilizzare il contenuto della knowledge base.

Migliori pratiche:

  • Sii specifico sulle informazioni da recuperare o riepilogare

  • Fai riferimento al tipo di contenuto che ti aspetti che l'agente trovi (ad esempio, «Cerca nei documenti relativi alle policy per...» o «Trova informazioni su...»)

  • Specificate in che modo l'agente deve utilizzare le informazioni recuperate nella sua risposta

  • Includi istruzioni di riserva per i casi in cui la knowledge base non contiene contenuti pertinenti

Esempio: addetto alle richieste dei clienti con knowledge base

L'esempio seguente mostra come configurare un agente personalizzato che utilizza una knowledge base per rispondere alle richieste dei clienti sulla base della documentazione aziendale.

Configurazione:

  • Uno spazio contenente una knowledge base con documentazione sul prodotto e contenuti delle domande frequenti

  • Lo spazio è collegato al gruppo di automazione

  • Lo spazio viene aggiunto come conoscenza all'agente personalizzato

Istruzioni:

"""You are a customer support agent. Task: Answer the customer inquiry using information from the knowledge base. Instructions: 1. Search the knowledge base for information relevant to the customer's question. 2. Provide a clear, concise answer based on the retrieved content. 3. If the knowledge base does not contain relevant information, respond with: "I don't have enough information to answer this question. Please escalate to a human agent." Constraints: - Only use information found in the knowledge base. Do not make up answers. - Keep responses under 200 words. - Include the source document name when referencing specific information."""

Output strutturato:

{ "answer": "The response to the customer inquiry", "sourceDocument": "Name of the document used", "confidence": "high/medium/low", "escalationNeeded": false }