Vai al contenuto principale Passa a contenuto complementare

Utilizzo delle connessioni Anthropic (Amazon Bedrock) nelle espressioni di visualizzazione

Oltre ad aggiungere le domande e le risposte di Anthropic al modello dati della propria app utilizzando lo script di caricamento, è possibile anche eseguire queste operazioni direttamente in un grafico della propria app nella modalità di analisi. I dati per un singolo campo vengono inviati avanti e indietro tra l'utente e Anthropic.

In molti casi, il codice usato per la connessione di uno script di caricamento può essere riutilizzato in un grafico, con alcune differenze.

Se il caso di utilizzo si basa sull'input dell'utente, è possibile utilizzare una connessione di analisi e la sintassi corrispondente di estensione lato server nell'espressione del grafico dell'utente al fine di creare grafici interattivi che visualizzino i dati ricevuti dagli endpoint modello.

Considerazioni relative al volume dati delle richieste

Per le espressioni del grafico per una o alcune righe di dati, si consiglia di utilizzare esclusivamente le connessioni Anthropic (Amazon Bedrock). Non si consiglia l'utilizzo di espressioni del grafico per inviare grandi quantità di dati a Anthropic.

È importante verificare il numero di righe che si inviano con ogni richiesta. Gli errori nella configurazione della connessione in un'espressione del grafico possono portare a richieste accidentalmente grandi (ad esempio, a causa di righe identiche con la stessa domanda a causa dell'utilizzo scorretto del modello dati in un grafico). Prima di interagire con una piattaforma di terze parti, assicurarsi di conoscere in che modo i campi utilizzati nel calcolo dell'espressione del grafico, e la loro posizione nel modello dati, hanno effetto sull'accordo finanziario e sulle modalità di fatturazione con le terze parti. Un utilizzo più elevato della piattaforma esterna può determinare costi superiori.

Seguire queste linee guida per controllare e limitare le dimensioni delle richieste:

  • Utilizzare solo la connessione in un'espressione del grafico Testo e immagine. Si sconsiglia vivamente l'utilizzo di una connessione  Anthropic (Amazon Bedrock) in un oggetto Tabella, soprattutto se si desidera aggiungere l'espressione a una tabella con una o più dimensioni preesistenti.

  • Se l'espressione del grafico è collegata al modello dati della propria app, utilizzare un'istruzione if nell'espressione esclusivamente per calcolare il grafico quando si affettua un'unica selezione nell'app. In questo modo, il numero di righe verrà ridotto notevolmente nelle richieste che il grafico invierà a Anthropic.

  • Se si usa una connessione Anthropic (Amazon Bedrock) per inviare richieste di grandi dimensioni, usare la connessione nello script di caricamento anziché in un'espressione del grafico, in modo che i dati vengano pre-caricati del modello dati.

Preparazione dei prompt

Quando si digitano le richieste che si desidera inviare al modello di IA generativa (spesso denominate prompt), seguire le linee guida specifiche per la piattaforma con cui si interagisce. Per informazioni sulla progettazione di prompt e alcune linee guida su come strutturare i prompt per i connettori Amazon Bedrock, vedere Linee guida per la progettazione di prompt.

Creazione di prompt per la configurazione di Anthropic - Claude

È possibile utilizzare la configurazione Anthropic - Claude di questo connettore per effettuare la connessione ai modelli precedenti elencati di seguito:

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

I prompt scritti per questa configurazione richiedono una sintassi specifica per restituire correttamente i completamenti. Di seguito sono elencati i requisiti:

  • Ogni prompt deve avere un prefisso con testo Human:

  • È necxessario aggiungere il testo Assistant: come prefisso all'inzio del prompt.

  • Il prefisso Human: deve avere due ritorni a capo precedenti. Questo risultato si ottiene aggiungendo chr(10) & chr(10) all'espressione, prima del prefisso.

  • Il suffisso Assistant: deve avere due ritorni a capo precedenti. Questo risultato si ottiene aggiungendo chr(10) & chr(10) all'espressione, prima del suffisso.

Per informazioni su come applicare la struttura e il formato di un prompt Claude, vedere Creazione di un prompt.

Per esempio, vedere Esempi rapidi.

Creazione di prompt per la configurazione di Anthropic - Claude (Messages API)

La configurazione Anthropic - Claude (Messages API) effettua la connessione all'API di Messaggi. È possibile utilizzare questa configurazione per accedere ai seguenti modelli Claude:

  • Claude 3 Sonnet

  • Claude 3 Haiku

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

I prompt per questi modelli non richiedono una sintassi specifica. Per esempio, vedere Esempi rapidi.

Creazione di espressioni del grafico

  1. Al momento di modificare una visualizzazione, fare clic su Espressione per accedere all'editor delle espressioni.

  2. Nell'editor delle espressioni, inserire un'espressione nel campo espressioni. L'espressione deve essere formulata usando la sintassi dell'estensione lato server.

Esempi rapidi

In questa sezione vengono elencate alcune espressioni di esempio che è possibile utilizzare quando con il connettore Anthropic (Amazon Bedrock). Tenere presente le seguenti indicazioni:

  • Utilizzare unicamente espressioni con un oggetto Testo e immagine.

  • Considerare di aggiungere un'istruzione if alle espressioni per controllare quando bisogna ricalcolare e aggiornare il grafico, a seconda delle selezioni dell'utente nell'app.

  • Per fare in modo che le espressioni funzioni correttamente, è necessario sostituire il valore connectionname e i nomi di qualsiasi campo in modo che corrispondano alle connessioni e app utilizzate dall'utente.

  • Per ogni configurazione di questo connettore vi sono diversi requisiti di sintassi. Vedere Preparazione dei prompt.

Esempi di espressioni del grafico per il connettore di analisi Anthropic (Amazon Bedrock)

Configurazione del connettore Espressione Riepilogo
Anthropic - Claude endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.' & chr(10) & chr(10) & 'Assistant:')

Questa istruzione restituirà la risposta di Anthropic a una singola domanda, inserita nell'espressione.

Nota di avviso

Questa espressione non utilizza un'istruzione if, e non se ne consiglia l'uso se vincolata a un campo nel modello dati dell'utente. È adatta per l'uso solo in un'espressione indipendente con un'unica cella di input contenente un valore codificato.

Anthropic - Claude if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & vQuestion & chr(10) & chr(10) & ' Assistant:'))

Questa è un'istruzione che può essere utilizzata in un oggetto Testo e immagine collegato a un Controllo input variabile. Il grafico viene calcolato solo dopo che viene inserito l'input. Quando l'utente digita l'input nell'oggetto e preme Invio, il grafico visualizza la risposta del modello al testo inserito.

Notare che, forniti i requisiti per i prompt Anthropic, l'utente deve inserire il prefisso e il suffisso manualmente nell'input.

Per una procedura dettagliata simile con un connettore differente, vedere Esercizio: Creazione di una casella di testo di input che utilizza una variabile.

Anthropic - Claude if(count(distinct [BusinessTopic]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human: write me a sample response from a technical support department for a customer complaint about ' & [BusinessTopic] & chr(10) & chr(10) & ' Assistant:')) In questo esempio, il grafico viene calcolato solo se un valore distinto viene selezionato dal campo IssueCategory nel modello dati dell'app. Un prompt viene inviato al modello per richiedere una risposta di esempio da un dipartimento di supporto tecnico riguardante un tipo generale di problema, un elenco dei quali è incluso nel campo IssueCategory. Il grafico viene aggiornato a seconda del valore selezionato dall'utente.
Anthropic - Claude (Messages API) endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.')

Questa istruzione restituirà la risposta di Anthropic a una singola domanda, inserita nell'espressione.

Nota di avviso

Questa espressione non utilizza un'istruzione if, e non se ne consiglia l'uso se vincolata a un campo nel modello dati dell'utente. È adatta per l'uso solo in un'espressione indipendente con un'unica cella di input contenente un valore codificato.

Anthropic - Claude (Messages API) if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion))

Questa è un'istruzione che può essere utilizzata in un oggetto Testo e immagine collegato a un Controllo input variabile. Il grafico viene calcolato solo dopo che viene inserito l'input. Quando l'utente digita l'input nell'oggetto e preme Invio, il grafico visualizza la risposta del modello al testo inserito.

Notare che, forniti i requisiti per i prompt Anthropic, l'utente deve inserire il prefisso e il suffisso manualmente nell'input.

Per una procedura dettagliata simile con un connettore differente, vedere Esercizio: Creazione di una casella di testo di input che utilizza una variabile.

Anthropic - Claude (Messages API) if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]')) In questo esempio, il grafico viene calcolato solo se un valore distinto viene selezionato dal campo IssueCategory nel modello dati dell'app. Un prompt viene inviato al modello per richiedere una risposta di esempio da un dipartimento di supporto tecnico riguardante un tipo generale di problema, un elenco dei quali è incluso nel campo IssueCategory. Il grafico viene aggiornato a seconda del valore selezionato dall'utente.

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!