

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Lacak proses penalaran langkah demi langkah agen menggunakan jejak
<a name="trace-events"></a>

Setiap tanggapan dari agen Amazon Bedrock disertai dengan *jejak* yang merinci langkah-langkah yang diatur oleh agen. Jejak membantu Anda mengikuti proses penalaran agen yang mengarahkannya ke respons yang diberikannya pada saat itu dalam percakapan.

Gunakan jejak untuk melacak jalur agen dari input pengguna ke respons yang dikembalikan. Jejak memberikan informasi tentang input ke grup tindakan yang dipanggil agen dan basis pengetahuan yang ditanyakan untuk merespons pengguna. Selain itu, jejak memberikan informasi tentang output yang dikembalikan oleh kelompok aksi dan basis pengetahuan. Anda dapat melihat alasan yang digunakan agen untuk menentukan tindakan yang diperlukan atau kueri yang dibuatnya ke basis pengetahuan. Jika langkah dalam jejak gagal, jejak mengembalikan alasan kegagalan. Gunakan informasi terperinci dalam jejak untuk memecahkan masalah agen Anda. Anda dapat mengidentifikasi langkah-langkah di mana agen mengalami masalah atau di mana ia menghasilkan perilaku yang tidak terduga. Kemudian, Anda dapat menggunakan informasi ini untuk mempertimbangkan cara-cara di mana Anda dapat meningkatkan perilaku agen.

## Struktur jejak
<a name="trace-understand"></a>

Jika Anda mengaktifkan jejak, dalam [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)respons, masing-masing `chunk` dalam aliran disertai dengan `trace` bidang yang memetakan ke [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)objek. `tracePart`Objek berisi informasi tentang agen dan sesi, di samping proses penalaran agen dan dan hasil dari memanggil fungsi API. 

```
{
    "agentId": "string",
    "agentName": "string",
    "collaboratorName": "string",
    "agentAliasId": "string",
    "sessionId": "string",
    "agentVersion": "string",
    "trace": { ...},    
    "callerChain": [{
        "agentAliasArn": "{{agent alias arn}}"
    }]
}
```

Daftar berikut menjelaskan bidang [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)objek:
+ `agentId`— Pengenal unik agen.
+ `agentName`Nama agennya.
+ `collaboratorName`— Jika kolaborasi multi-agen diaktifkan, nama agen kolaborator.
+ `agentVersion`— Versi agen.
+ `agentAliasId`— Pengenal unik alias agen.
+ `sessionId`— Pengenal unik sesi dengan agen.
+ `trace`— Berisi proses penalaran agen dan hasil dari memanggil tindakan API. Lihat di bawah untuk informasi lebih lanjut.
+ `callerChain`— Daftar penelepon antara agen yang menerbitkan jejak ini dan pengguna akhir.
  + Jika itu adalah agen tunggal, bidang ini akan berisi alias Arn dari agen yang sama yang menerbitkan jejak.
  + Jika kolaborasi multi-agen diaktifkan, bidang ini akan berisi alias Arn dari semua agen yang meneruskan permintaan pengguna akhir ke agen saat ini. 

 Di dalamnya [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html)adalah `trace` bidang yang memetakan ke [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html)objek. Jejak ditampilkan sebagai objek JSON di konsol dan API. Setiap **Langkah** di konsol atau [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html)di API dapat menjadi salah satu dari jejak berikut:
+ [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)— Melacak input dan output dari langkah pra-pemrosesan, di mana agen mengontekstualisasikan dan mengkategorikan input pengguna dan menentukan apakah itu valid.
+ [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)— Melacak input dan output dari langkah orkestrasi, di mana agen menafsirkan input, memanggil kelompok tindakan, dan menanyakan basis pengetahuan. Kemudian agen mengembalikan output untuk melanjutkan orkestrasi atau untuk menanggapi pengguna.
+ [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)— Melacak input dan output dari langkah pasca-pemrosesan, di mana agen menangani output akhir orkestrasi dan menentukan bagaimana mengembalikan respons kepada pengguna.
+ [CustomOrchestrationTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_CustomOrchestrationTrace.html)— Detail tentang langkah orkestrasi khusus di mana agen menentukan urutan di mana tindakan dijalankan.
+ [RoutingClassifierTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_RoutingClassifierTrace.html)— Melacak input dan output dari routing classifier
+ [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)— Melacak alasan bahwa sebuah langkah gagal.
+ [GuardrailTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GuardrailTrace.html)— Melacak tindakan Guardrail.

Setiap jejak (kecuali`FailureTrace`) berisi [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objek. [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)Objek berisi konfigurasi yang diatur dalam template prompt untuk langkah tersebut, di samping prompt yang diberikan kepada agen pada langkah ini. Untuk informasi selengkapnya tentang cara memodifikasi templat prompt, lihat[Tingkatkan akurasi agen menggunakan templat prompt lanjutan di Amazon Bedrock](advanced-prompts.md). Struktur `ModelInvocationInput` objek adalah sebagai berikut:

```
{
    "traceId": "string",
    "text": "string",
    "type": "PRE_PROCESSING | ORCHESTRATION | ROUTING_CLASSIFIER | KNOWLEDGE_BASE_RESPONSE_GENERATION | POST_PROCESSING",
    "foundationModel":string",
    "inferenceConfiguration": {
        "maximumLength": number,
        "stopSequences": ["string"],
        "temperature": float,
        "topK": float,
        "topP": float
    },
    "promptCreationMode": "DEFAULT | OVERRIDDEN",
    "parserMode": "DEFAULT | OVERRIDDEN",
    "overrideLambda": "string"
}
```

Daftar berikut menjelaskan bidang [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objek:
+ `traceId`— Pengidentifikasi unik dari jejak.
+ `text`— Teks dari prompt yang diberikan kepada agen pada langkah ini.
+ `type`— Langkah saat ini dalam proses agen.
+ `foundationModel`— Model dasar agen kolaborator dalam kolaborasi multi-agen. Bidang ini hanya diisi jika `type` ada`ROUTING_CLASSIFIER`. Jika model default yang digunakan untuk routing prompt diganti, bidang ini menunjukkan model agen pengawas yang digunakan untuk merutekan prompt.
+ `inferenceConfiguration`— Parameter inferensi yang mempengaruhi generasi respons. Untuk informasi selengkapnya, lihat [Mempengaruhi generasi respons dengan parameter inferensi](inference-parameters.md).
+ `promptCreationMode`— Apakah template prompt dasar default agen diganti untuk langkah ini. Untuk informasi selengkapnya, lihat [Tingkatkan akurasi agen menggunakan templat prompt lanjutan di Amazon Bedrock](advanced-prompts.md).
+ `parserMode`— Apakah parser respons default agen diganti untuk langkah ini. Untuk informasi selengkapnya, lihat [Tingkatkan akurasi agen menggunakan templat prompt lanjutan di Amazon Bedrock](advanced-prompts.md).
+ `overrideLambda`— Nama Sumber Daya Amazon (ARN) dari fungsi parser Lambda yang digunakan untuk mengurai respons, jika parser default diganti. Untuk informasi selengkapnya, lihat [Tingkatkan akurasi agen menggunakan templat prompt lanjutan di Amazon Bedrock](advanced-prompts.md).

Untuk informasi selengkapnya tentang setiap jenis jejak, lihat bagian berikut:

### PreProcessingTrace
<a name="trace-preprocessing"></a>

```
{
    "modelInvocationInput": { // see above for details }
    "modelInvocationOutput": {
        "metadata": {
             "usage": {
                  "inputToken":: int,
                  "outputToken":: int
           },
         "rawResponse": {
              "content": "string"
          }
        "parsedResponse": {
            "isValid": boolean,
            "rationale": "string"
        },
        "traceId": "string"
    }
}
```

[PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)Terdiri dari [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objek dan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html)objek. [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html)Berisi bidang-bidang berikut.
+ `metadata`- Berisi informasi berikut tentang output model pondasi.
  + `usage`— Berisi informasi berikut tentang penggunaan model pondasi.
    + `inputTokens`— Berisi informasi tentang token input dari penggunaan model foundation.
    + `outputTokens`— Berisi informasi tentang token keluaran dari penggunaan model foundation.
+ `rawResponse`- Berisi output mentah dari model pondasi.
  + `content`— Konten keluaran mentah model pondasi.
+ `parsedResponse`— Berisi rincian berikut tentang prompt pengguna yang diuraikan.
  + `isValid`- Menentukan apakah prompt pengguna valid.
  + `rationale`— Menentukan alasan agen untuk langkah selanjutnya yang harus diambil.
+ `traceId`— Pengidentifikasi unik dari jejak.

### OrchestrationTrace
<a name="trace-orchestration"></a>

[OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)Terdiri dari [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objek, [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html)objek, dan kombinasi apa pun dari [Rasional](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html), [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html), dan objek [Observasi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html). [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html)Berisi bidang-bidang berikut. Untuk informasi lebih lanjut tentang [Rasional](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html), [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html), dan objek [Observasi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html), pilih dari tab berikut. 

```
{
    "modelInvocationInput": { // see above for details },
     "modelInvocationOutput": {
        "metadata": {
             "usage": {
                  "inputToken":: int,
                  "outputToken":: int
           },
         "rawResponse": {
              "content": "string"
          },
    "rationale": { ... },
    "invocationInput": { ... },
    "observation": { ... }
}
```

Jika `type` is `AGENT_COLLABORATOR` dan jika routing diaktifkan untuk agen supervisor, [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html)akan berisi struktur berikut:

```
routingClassifierModelInvocationOutput: {
        traceId: "string",
        rawResponse: "string",
        routerClassifierParsedResponse: {...} 
        metadata: {
            inputTokens: "..."
            outputTokens: "..."    
        }
    }
```

------
#### [ Rationale ]

Objek [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) berisi penalaran agen yang diberikan input pengguna. Berikut ini adalah strukturnya:

```
{
       "traceId": "string",
       "text": "string"
    }
```

Daftar berikut menjelaskan bidang objek [Rationale:](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html)
+ `traceId`— Pengidentifikasi unik dari langkah jejak.
+ `text`— Proses penalaran agen, berdasarkan prompt input.

------
#### [ InvocationInput ]

[InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)Objek berisi informasi yang akan dimasukkan ke grup tindakan atau basis pengetahuan yang akan dipanggil atau ditanyakan. Berikut ini adalah strukturnya:

```
{
    "traceId": "string",
    "invocationType": "AGENT_COLLABORATOR" | "ACTION_GROUP | KNOWLEDGE_BASE | FINISH",
     "agentCollaboratorInvocationInput": { 
        // see below for details
    },
    "actionGroupInvocationInput": {
        // see below for details
    },
    "knowledgeBaseLookupInput": {
        "knowledgeBaseId": "string",
        "text": "string"
    }
}
```

Daftar berikut menjelaskan bidang [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)objek:
+ `traceId`— Pengidentifikasi unik dari jejak.
+ `invocationType`— Menentukan apakah agen memanggil agen kolaborator, kelompok tindakan atau basis pengetahuan, atau mengakhiri sesi.
+ `agentCollaborationInvocationInput`— Berisi input doa ke agen kolaborator. Muncul jika `type` is `AGENT_COLLABORATOR` dan jika routing diaktifkan untuk agen supervisor. Untuk informasi selengkapnya, lihat [Gunakan kolaborasi multi-agen dengan Amazon Bedrock Agents](agents-multi-agent-collaboration.md).
  + `agentCollaborationInvocationInput `Strukturnya adalah sebagai berikut:

    ```
    {
      "agentCollaboratorName": "string",
      "agentCollaboratorAliasArn": "string",
      "input": {
          "text": "string"           
         }
      }
    ```

    Berikut ini adalah deskripsi bidang:
    + `agentCollaboratorName`— Nama agen kolaborator yang terkait dengan agen supervisor.
    + `agentCollaboratorAliasArn`— Alias Arn dari agen kolaborator.
    + `input`— String input untuk agen kolaborator.
+ `actionGroupInvocationInput`— Muncul jika `type` ada`ACTION_GROUP`. Untuk informasi selengkapnya, lihat [Tentukan tindakan dalam kelompok tindakan](action-define.md). Dapat menjadi salah satu struktur berikut:
  + Jika grup tindakan ditentukan oleh skema API, strukturnya adalah sebagai berikut:

    ```
    {
        "actionGroupName": "string",
        "apiPath": "string",
        "verb": "string",
        "parameters": [
            {
                "name": "string",
                "type": "string",
                "value": "string"
            },
            ...
        ],
        "requestBody": {
            "content": {
                "{{<content-type>}}": [
                    {
                        "name": "string",
                        "type": "string",
                        "value": "string"
                    }   
                ]
            }
        },
        "executionType": "LAMBDA | RETURN_CONTROL",
        "invocationId": "string"
    }
    ```

    Berikut ini adalah deskripsi bidang:
    + `actionGroupName`— Nama kelompok aksi yang diprediksi agen harus dipanggil.
    + `apiPath`— Jalur ke operasi API untuk memanggil, sesuai dengan skema API.
    + `verb`— Metode API yang digunakan, sesuai dengan skema API.
    + `parameters`— Berisi daftar objek. Setiap objek berisi nama, jenis, dan nilai parameter dalam operasi API, seperti yang didefinisikan dalam skema API.
    + `requestBody`— Berisi isi isi permintaan dan propertinya, seperti yang didefinisikan dalam skema API.
    + `executionType`— Apakah pemenuhan tindakan diteruskan ke fungsi Lambda `LAMBDA` () atau kontrol dikembalikan melalui `InvokeAgent` respons `RETURN_CONTROL` (). Untuk informasi selengkapnya, lihat [Menangani pemenuhan tindakan](action-handle.md).
    + `invocationId`— Pengidentifikasi unik dari doa. Hanya dikembalikan jika `executionType` ada`RETURN_CONTROL`.
  + Jika kelompok tindakan ditentukan oleh rincian fungsi, strukturnya adalah sebagai berikut:

    ```
    {
        "actionGroupName": "string",
        "function": "string",
        "parameters": [
            {
                "name": "string",
                "type": "string",
                "value": "string"
            },
            ...
        ],
        "executionType": "LAMBDA | RETURN_CONTROL",
        "invocationId": "string"
    }
    ```

    Berikut ini adalah deskripsi bidang:
    + `actionGroupName`— Nama kelompok aksi yang diprediksi agen harus dipanggil.
    + `function`— Nama fungsi yang diprediksi agen harus dipanggil.
    + `parameters`— Parameter fungsi.
    + `executionType`— Apakah pemenuhan tindakan diteruskan ke fungsi Lambda `LAMBDA` () atau kontrol dikembalikan melalui `InvokeAgent` respons `RETURN_CONTROL` (). Untuk informasi selengkapnya, lihat [Menangani pemenuhan tindakan](action-handle.md).
    + `invocationId`— Pengidentifikasi unik dari doa. Hanya dikembalikan jika `executionType` ada`RETURN_CONTROL`.
+ `knowledgeBaseLookupInput`— Muncul jika `type` ada`KNOWLEDGE_BASE`. Untuk informasi selengkapnya, lihat [Ambil data dan hasilkan respons AI dengan Pangkalan Pengetahuan Amazon Bedrock](knowledge-base.md). Berisi informasi berikut tentang basis pengetahuan dan kueri pencarian untuk basis pengetahuan:
  + `knowledgeBaseId`— Pengidentifikasi unik dari basis pengetahuan yang akan dicari agen.
  + `text`— Permintaan yang akan dibuat ke basis pengetahuan.

------
#### [ Observation ]

[Objek Observasi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) berisi hasil atau output dari kolaborator agen, kelompok tindakan atau basis pengetahuan, atau respons terhadap pengguna. Berikut ini adalah strukturnya:

```
{
    "traceId": "string",
    "type": "AGENT_COLLABORATOR |ACTION_GROUP | KNOWLEDGE_BASE | REPROMPT | ASK_USER | FINISH",
    "agentCollaboratorInvocationOutput": { 
            "agentCollaboratorName": "string",
            "agentCollaboratorAliasArn": "string",
            "output": {
                "text": "string"
            },
    "actionGroupInvocation": {
        "text": "JSON-formatted string"
    },
    "knowledgeBaseLookupOutput": {
        "retrievedReferences": [
            {
                "content": {
                    "text": "string"
                },
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "uri": "string"
                    }
                }
            },
            ...
        ]
    },
    "repromptResponse": {
        "source": "ACTION_GROUP | KNOWLEDGE_BASE | PARSER",
        "text": "string"
    },
    "finalResponse": {
        "text"
    }
}
```

Daftar berikut menjelaskan bidang objek [Observasi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html):
+ `traceId`— Pengidentifikasi unik dari jejak.
+ `type`— Menentukan apakah pengamatan agen dikembalikan dari hasil kolaborator agen, kelompok tindakan atau basis pengetahuan, jika agen tersebut meminta kembali pengguna, meminta informasi lebih lanjut, atau mengakhiri percakapan.
+ `agentCollaboratorInvocationOutput`— Berisi respon dari agen kolaborator atau respon akhir. Muncul jika `type` is `AGENT_COLLABORATOR` dan jika routing diaktifkan untuk agen supervisor. Untuk informasi selengkapnya, lihat [Gunakan kolaborasi multi-agen dengan Amazon Bedrock Agents](agents-multi-agent-collaboration.md). Setiap respon berisi bidang-bidang berikut:
  + `agentCollaboratorName`— Nama agen kolaborator yang mengirimkan tanggapan.
  + `agentCollaboratorAliasArn`— Alias Arn dari agen kolaborator mengirimkan tanggapan.
  + `output`— Berisi tanggapan yang dikirim oleh agen kolaborator.
+ `actionGroupInvocationOutput`— Berisi JSON-formatted string yang dikembalikan oleh operasi API yang dipanggil oleh grup aksi. Muncul jika `type` ada`ACTION_GROUP`. Untuk informasi selengkapnya, lihat [Mendefinisikan OpenAPI skema untuk grup aksi agen Anda di Amazon Bedrock](agents-api-schema.md).
+ `knowledgeBaseLookupOutput`— Berisi teks yang diambil dari basis pengetahuan yang relevan untuk menanggapi prompt, di samping lokasi Amazon S3 dari sumber data. Muncul jika `type` ada`KNOWLEDGE_BASE`. Untuk informasi selengkapnya, lihat [Ambil data dan hasilkan respons AI dengan Pangkalan Pengetahuan Amazon Bedrock](knowledge-base.md). Setiap objek dalam daftar `retrievedReferences` berisi bidang-bidang berikut:
  + `content`— Berisi `text` dari basis pengetahuan yang dikembalikan dari kueri basis pengetahuan.
  + `location`— Berisi URI Amazon S3 dari sumber data tempat teks yang dikembalikan ditemukan.
+ `repromptResponse`— Muncul jika `type` ada`REPROMPT`. Berisi `text` yang meminta prompt lagi di `source` samping mengapa agen perlu reprompt.
+ `finalResponse`— Muncul jika `type` ada `ASK_USER` atau`FINISH`. Berisi `text` yang meminta pengguna untuk informasi lebih lanjut atau merupakan respons terhadap pengguna.

------

### PostProcessingTrace
<a name="trace-postprocessing"></a>

```
{
    "modelInvocationInput": { // see above for details }
    "modelInvocationOutput": {
        "rawResponse": {
            "content": "string"
        },
        "metadata": {
            "usage": {
                "inputToken": int,
                "outputToken": int    
             }     
         },
        "parsedResponse": {
            "text": "string"
        },
        "traceId": "string"
    }
}
```

[PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)Terdiri dari [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objek dan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html)objek. [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html)Berisi bidang-bidang berikut:
+ `rawResponse`- Berisi output mentah dari model pondasi.
  + `content`— Konten keluaran mentah model pondasi.
+ `metadata`- Berisi informasi berikut tentang output model pondasi.
  + `usage`— Berisi informasi berikut tentang penggunaan model pondasi.
    + `inputTokens`— Berisi informasi tentang token input dari penggunaan model foundation.
    + `outputTokens`— Berisi informasi tentang token keluaran dari penggunaan model foundation.
+ `parsedResponse`— Berisi `text` untuk kembali ke pengguna setelah teks diproses oleh fungsi parser.
+ `traceId`— Pengidentifikasi unik dari jejak.

### FailureTrace
<a name="trace-failure"></a>

```
{
    "failureReason": "string",
    "traceId": "string"
}
```

Daftar berikut menjelaskan bidang [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)objek:
+ `failureReason`Alasan mengapa langkah itu gagal.
+ `traceId`— Pengidentifikasi unik dari jejak.

### GuardrailTrace
<a name="trace-guardrail"></a>

```
{
    "action": "GUARDRAIL_INTERVENED" | "NONE",
    "inputAssessments": [GuardrailAssessment],
    "outputAssessments": [GuardrailAssessment]
}
```

Daftar berikut menjelaskan bidang GuardrailAssessment objek:
+ `action`— menunjukkan apakah pagar pembatas diintervensi atau tidak pada data input. Pilihannya adalah `GUARDRAIL_INTERVENED` atau`NONE`.
+ `inputAssessments`— Rincian penilaian Guardrail pada input pengguna.
+ `outputAssessments`— Rincian penilaian Guardrail pada tanggapan.

Untuk detail lebih lanjut tentang `GuardrailAssessment` objek dan menguji Pagar Pembatas, lihat. [Uji pagar pembatas Anda](guardrails-test.md)

GuardrailAssessment contoh:

```
{
    "topicPolicy": {
        "topics": [{
            "name": "string",
            "type": "string",
            "action": "string"
        }]
    },
    "contentPolicy": {
        "filters": [{
            "type": "string",
            "confidence": "string",
            "action": "string"
        }]
    },
    "wordPolicy": {
        "customWords": [{
            "match": "string",
            "action": "string"
        }],
        "managedWordLists": [{
            "match": "string",
            "type": "string",
            "action": "string"
        }]
    },
    "sensitiveInformationPolicy": {
        "piiEntities": [{
            "type": "string",
            "match": "string",
            "action": "string"
        }],
        "regexes": [{
            "name": "string",
            "regex": "string",
            "match": "string",
            "action": "string"
        }]
    }
}
```