# Laporan wawasan berulang
<a name="insights-recurring-report"></a>

Buat konfigurasi evaluasi online dengan wawasan dan jadwal pengelompokan. Layanan secara otomatis menjalankan analisis wawasan tentang irama yang dikonfigurasi tanpa intervensi manual.

**Topics**
+ [Buat konfigurasi](#insights-recurring-create)
+ [Parameter konfigurasi](#insights-recurring-params)
+ [Perbarui konfigurasi](#insights-recurring-update)
+ [Lihat hasil laporan berulang](#insights-recurring-view)
+ [Kelola konfigurasi](#insights-recurring-manage)

## Buat konfigurasi
<a name="insights-recurring-create"></a>

**Example**  

```
agentcore add online-insights --name my_agent_insights --runtime MyAgent --insights Builtin.Insight.FailureAnalysis --sampling-rate 100 --clustering-frequency DAILY --enable-on-create --json
```
Kemudian terapkan melalui CloudFormation:  

```
agentcore deploy -y --json
```

1. Jalankan `agentcore` untuk membuka TUI, lalu pilih **tambah** dan pilih **Wawasan Online**:  
![Wizard wawasan: pilih agen untuk dipantau](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-agent.png)

1. Pilih wawasan untuk mengaktifkan:  
![Wizard wawasan: pilih wawasan](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-insights.png)

1. Atur laju pengambilan sampel:  
![Wizard wawasan: atur laju pengambilan sampel](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-sampling-rate.png)

1. Pilih frekuensi pengelompokan:  
![Wizard wawasan: pilih frekuensi pengelompokan](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-clustering.png)

1. Masukkan nama konfigurasi:  
![Wizard wawasan: masukkan nama konfigurasi](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-name.png)

1. Tinjau konfigurasi dan tekan Enter untuk mengonfirmasi:  
![Wizard wawasan: konfigurasi tinjauan](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/images/tui/insights-add-confirm.png)

```
import boto3

client_cp = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client_cp.create_online_evaluation_config(
    onlineEvaluationConfigName="my_agent_insights",
    rule={
        "samplingConfig": {"samplingPercentage": 100.0},
        "sessionConfig": {"sessionTimeoutMinutes": 30},
    },
    dataSourceConfig={
        "cloudWatchLogs": {
            "serviceNames": ["MyAgent.DEFAULT"],
            "logGroupNames": [
                "/aws/bedrock-agentcore/runtimes/MyAgent-abc123-DEFAULT"
            ],
        }
    },
    insights=[
        {"insightId": "Builtin.Insight.FailureAnalysis"},
        {"insightId": "Builtin.Insight.UserIntent"},
    ],
    clusteringConfig={"frequencies": ["DAILY"]},
    evaluationExecutionRoleArn="arn:aws:iam::123456789012:role/AgentCoreEvaluationRole",
    enableOnCreate=True,
)

config_id = response["onlineEvaluationConfigId"]
print(f"Created config: {config_id}")
```

Ini memberitahu layanan untuk:
+ Sesi sampel pada tingkat yang dikonfigurasi (100% dalam contoh ini — `samplingPercentage` menyesuaikan `--sampling-rate` atau menganalisis subset lalu lintas).
+ Jalankan analisis kegagalan dan ekstraksi maksud pengguna pada setiap sesi sampel.
+ Picu laporan pengelompokan setiap hari.

## Parameter konfigurasi
<a name="insights-recurring-params"></a>


| Parameter | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `insights`  | Daftar | Diperlukan (saling eksklusif dengan`evaluators`) | Daftar jenis wawasan untuk dijalankan. Setiap entri memiliki`insightId`. Maksimal 10. | 
|  `rule.samplingConfig.samplingPercentage`  | Bilangan | Tidak (default: 100) | Persentase sesi untuk dianalisis (1-100). Gunakan tingkat pengambilan sampel yang lebih rendah untuk agen lalu lintas tinggi untuk mengontrol biaya sambil tetap memunculkan pola kegagalan. | 
|  `clusteringConfig`  | Objek | Tidak | Mengonfigurasi pekerjaan evaluasi batch berkala untuk pengelompokan. Berisi `frequencies` daftar. Hanya dapat digunakan saat `insights` disediakan. | 
|  `clusteringConfig.frequencies`  | Daftar string | Ya (dalam`clusteringConfig`) | Satu atau lebih dari:`DAILY`,`WEEKLY`,`MONTHLY`. Maksimum 3 nilai. | 

**catatan**  
Wawasan dan evaluator saling eksklusif — Anda harus memberikan satu atau yang lain, bukan keduanya. Jika Anda menginginkan penilaian kualitas dan triase kegagalan untuk agen yang sama, buat dua konfigurasi terpisah yang menunjuk ke sumber data yang sama.

## Perbarui konfigurasi
<a name="insights-recurring-update"></a>

Ubah wawasan atau frekuensi pengelompokan:

```
client_cp.update_online_evaluation_config(
    onlineEvaluationConfigId=config_id,
    insights=[
        {"insightId": "Builtin.Insight.FailureAnalysis"},
        {"insightId": "Builtin.Insight.UserIntent"},
    ],
    clusteringConfig={"frequencies": ["DAILY", "WEEKLY"]},
)
```

## Lihat hasil laporan berulang
<a name="insights-recurring-view"></a>

Laporan berulang menghasilkan pekerjaan evaluasi batch secara otomatis. Gunakan `ListBatchEvaluations` untuk menemukan laporan yang sudah selesai, lalu `GetBatchEvaluation` untuk mengambil hasil:

```
client = boto3.client("bedrock-agentcore", region_name="us-west-2")

# List recent batch evaluations
evaluations = client.list_batch_evaluations()

for eval_summary in evaluations.get("batchEvaluations", []):
    if eval_summary["status"] == "COMPLETED" and eval_summary.get("insights"):
        result = client.get_batch_evaluation(
            batchEvaluationId=eval_summary["batchEvaluationId"]
        )
        print(f"Report: {eval_summary['batchEvaluationName']}")
        if "failureAnalysisResult" in result:
            failures = result["failureAnalysisResult"]["failures"]
            print(f"  Found {len(failures)} failure categories")
```

## Kelola konfigurasi
<a name="insights-recurring-manage"></a>

**Example**  
Jeda:  

```
agentcore pause online-insights my_agent_insights --json
```
Lanjutkan:  

```
agentcore resume online-insights my_agent_insights --json
```
Hapus:  

```
agentcore remove online-insights --name my_agent_insights --yes --json
```
Jeda atau lanjutkan:  

```
# Pause
client_cp.update_online_evaluation_config(
    onlineEvaluationConfigId=config_id,
    executionStatus="DISABLED",
)

# Resume
client_cp.update_online_evaluation_config(
    onlineEvaluationConfigId=config_id,
    executionStatus="ENABLED",
)
```
Hapus:  

```
client_cp.delete_online_evaluation_config(
    onlineEvaluationConfigId=config_id,
)
```

**Awas**  
Menghapus konfigurasi tidak menghapus hasil evaluasi batch sebelumnya. Hasil wawasan historis tetap dapat diakses melalui`GetBatchEvaluation`.