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à.
Avvia una raccomandazione tempestiva del sistema
Avvia una raccomandazione per generare un prompt di sistema ottimizzato per il tuo agente. Il servizio analizza le tracce degli agenti, identifica i modelli di errore e produce un prompt di sistema rivisto che migliora le prestazioni del valutatore target.
Nota
I consigli vengono generati dagli LLM. Rivedi e prova prima di applicarli.
Esempi di codice
Esempio
Parametri della richiesta
| Parametro | Tipo | Campo obbligatorio | Descrizione |
|---|---|---|---|
|
|
Stringa |
Sì |
Un nome per la raccomandazione. Massimo 48 caratteri. Motivo: |
|
|
Stringa |
Sì |
Deve essere |
|
|
Oggetto |
Sì |
Contiene |
|
|
Stringa |
No |
Descrizione facoltativa. Massimo 4096 caratteri. |
|
|
Stringa |
No |
Token di idempotenza. Se ritenti una richiesta con lo stesso token client, il servizio restituisce il consiglio esistente invece di crearne uno nuovo. |
campi di sistema PromptRecommendationConfig
| Campo | Tipo | Campo obbligatorio | Description |
|---|---|---|---|
|
|
Union |
Sì |
L'attuale richiesta di ottimizzazione del sistema. Fornisci |
|
|
Union |
Sì |
Traccia la fonte per l'analisi. Vedi Trace sources per consigli. |
|
|
Oggetto |
Sì |
Configurazione di valutazione che specifica il valutatore target. Contiene un |
Scelta di un valutatore
Seleziona un valutatore in linea con la direzione che desideri migliorare. Il valutatore selezionato determina in che direzione viene ottimizzata la raccomandazione; qualunque sia il punteggio più alto ottenuto dal valutatore, è ciò verso cui l'ottimizzatore spinge il prompt.
Puoi utilizzare un valutatore integrato o fornire un ARN di valutazione personalizzato. Usa le seguenti linee guida per scegliere:
-
Se il tuo agente ha un compito chiaro da completare (prenotazione, recupero, un flusso di lavoro in più fasi),
Builtin.GoalSuccessRateè il segnale giusto. -
Se il tuo agente è più aperto e ti interessa la qualità dell'interazione stessa,
Builtin.Helpfulnessè la soluzione più adatta. -
Se la qualità che ti interessa è specifica del dominio o non viene acquisita da un valutatore integrato, utilizza un valutatore personalizzato per rappresentare al meglio la misurazione.
Nota
I consigli supportano valutatori integrati LLM-as-judge, personalizzati e basati su codice, ma richiedono che il valutatore restituisca un valore numerico come segnale di ottimizzazione. Per i LLM-as-judge valutatori personalizzati, configurali ratingScale con una scala (non). numerical categorical Per i valutatori basati su codice, includi il value campo nello schema di risposta. Schema di risposta
Nell'API, specifica il valutatore nell'evaluationConfig.evaluatorselenco con esattamente un riferimento al valutatore:
"evaluationConfig": { "evaluators": [ {"evaluatorArn": "arn:aws:bedrock-agentcore:::evaluator/Builtin.GoalSuccessRate"} ] }
Nella CLI, usa il flag: --evaluator
--evaluator Builtin.GoalSuccessRate
Modalità di immissione del prompt del sistema
| Modalità | Bandiere CLI | Campo API |
|---|---|---|
|
Testo in linea |
|
|
|
Pacchetto di configurazione |
|
|
Quando si utilizza un pacchetto di configurazione, il risultato include una nuova versione del pacchetto con il prompt di sistema ottimizzato applicato.
Risposta
| Campo | Tipo | Description |
|---|---|---|
|
|
Stringa |
Identificatore univoco per la raccomandazione. |
|
|
Stringa |
ARN della raccomandazione. |
|
|
Stringa |
Il nome che hai specificato. |
|
|
Stringa |
|
|
|
Stringa |
Stato iniziale: |
|
|
Time stamp |
Quando è stata creata la raccomandazione. |
|
|
Time stamp |
Data dell'ultimo aggiornamento del consiglio. |
Risultato della raccomandazione
Quando la raccomandazione raggiunge COMPLETED lo stato (recuperato tramite Ottieni una raccomandazione), il risultato contiene:
| Campo | Tipo | Description |
|---|---|---|
|
|
Stringa |
Il testo del prompt di sistema ottimizzato. |
|
|
Oggetto |
Presente quando l'input era un pacchetto di configurazione. Contiene |
|
|
Stringa |
Una spiegazione del motivo per cui è stata generata la raccomandazione e il ragionamento alla base delle modifiche suggerite. |
|
|
Stringa |
Presente se la raccomandazione ha avuto esito negativo. Codice di errore che descrive l'errore. |
|
|
Stringa |
Presente se la raccomandazione non è riuscita. Human-readable descrizione dell'errore. |
Errori
| Errore | Stato HTTP | Description |
|---|---|---|
|
|
400 |
Parametri di richiesta non validi. Controlla i vincoli dei campi e i campi obbligatori. |
|
|
403 |
Autorizzazioni insufficienti. Verifica le politiche IAM. |
|
|
409 |
Esiste già una raccomandazione con lo stesso token client con parametri diversi. |
|
|
402 |
Hai superato il numero massimo di raccomandazioni simultanee. |
|
|
429 |
Percentuale di richieste superata. Riprova con un backoff esponenziale. |
|
|
500 |
Service-side errore. Riprova la richiesta . |