Avviare una raccomandazione rapida di 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 dello strumento di valutazione target.
Nota
I consigli vengono generati dai LLM. Esaminali e testali 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 riprovi 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. Fornire |
|
|
Union |
Sì |
Traccia la fonte per l'analisi. Consulta Trace sources per consigli. |
|
|
Oggetto |
Sì |
Configurazione di valutazione che specifica il valutatore di destinazione. Contiene un |
Scelta di un valutatore
Seleziona un valutatore in linea con la direzione che desideri migliorare. Il valutatore selezionato determina l'obiettivo in base al quale la raccomandazione deve essere ottimizzata; l'ottimizzatore indirizza il prompt verso il quale il valutatore ottiene un punteggio elevato.
È possibile utilizzare un valutatore integrato o fornire un ARN di valutazione personalizzato. Utilizza le seguenti linee guida per scegliere:
-
Se il tuo agente ha un compito chiaro da completare (prenotazione, recupero, 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 migliore. -
Se la qualità che ti interessa è specifica del dominio o non viene rilevata da uno strumento di valutazione integrato, utilizza uno strumento di valutazione 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.
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 --evaluator flag:
--evaluator Builtin.GoalSuccessRate
Modalità di input del prompt di 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 della raccomandazione. |
Risultato della raccomandazione
Quando la raccomandazione raggiunge COMPLETED lo stato (recuperato tramite Ottieni una raccomandazione), il risultato contiene:
| Campo | Tipo | Description |
|---|---|---|
|
|
Stringa |
Il testo ottimizzato del prompt di sistema. |
|
|
Oggetto |
Presente quando l'input era un pacchetto di configurazione. Contiene |
|
|
Stringa |
Una spiegazione del motivo per cui è stata generata la raccomandazione e del motivo alla base delle modifiche suggerite. |
|
|
Stringa |
Presente se la raccomandazione non è riuscita. 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 consigli simultanei. |
|
|
429 |
Frequenza di richiesta superata. Riprova con backoff esponenziale. |
|
|
500 |
Service-side errore. Riprova la richiesta . |