Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Jalankan Amazon Bedrock flow secara asinkron dengan eksekusi flow
Dengan eksekusi flow, Anda dapat menjalankan aliran Amazon Bedrock secara asinkron. Ini memungkinkan alur Anda berjalan untuk jangka waktu yang lebih lama dan juga menghasilkan kontrol sehingga aplikasi Anda dapat melakukan tugas lain.
Saat Anda menjalankan aliran dengan menggunakan konsol Amazon Bedrock atau dengan [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)operasi, aliran berjalan hingga selesai atau habis waktu dalam satu jam (mana yang pertama). Ketika Anda menjalankan eksekusi flow, flow Anda dapat berjalan lebih lama: Node individual dapat berjalan hingga lima menit, dan seluruh aliran Anda dapat berjalan hingga 24 jam.
**catatan**
Eksekusi Flow dalam rilis pratinjau untuk Amazon Bedrock dan dapat berubah sewaktu-waktu.
## Izin yang diperlukan untuk menjalankan eksekusi alur
+ Pastikan bahwa peran layanan Amazon Bedrock Flows Anda memiliki semua izin yang diperlukan. Untuk informasi selengkapnya, lihat [Buat peran layanan untuk Amazon Bedrock Flows di Amazon Bedrock](flows-permissions.md).
+ (Opsional) Enkripsi data eksekusi alur Anda dengan AWS KMS kunci yang dikelola pelanggan. Untuk informasi selengkapnya, lihat [Enkripsi sumber daya Amazon Bedrock Flows](encryption-flows.md).
## Membuat dan mengelola eksekusi aliran
Anda dapat membuat eksekusi aliran di konsol atau dengan menggunakan [StartFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StartFlowExecution.html)operasi.
------
#### [ Console ]
1. Buat alur dengan mengikuti instruksi di[Buat dan rancang alur di Amazon Bedrock](flows-create.md).
1. Buat alias untuk alur dengan mengikuti petunjuk di[Buat alias aliran di Amazon Bedrock](flows-alias-create.md).
1. Jika Anda belum berada di **pembuat Flow**, lakukan hal berikut:
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Amazon Bedrock Flows** dari panel navigasi kiri, lalu pilih alur Anda.
1. Pilih tab **Eksekusi**, lalu pilih **Buat eksekusi**.
1. Dalam dialog **Buat eksekusi**, masukkan yang berikut
1. Untuk **Nama**, masukkan nama untuk eksekusi aliran.
1. Untuk **Pilih alias**, pilih alias aliran yang ingin Anda gunakan.
1. Untuk **input Prompt**, masukkan prompt yang ingin Anda mulai alirannya.
1. Pilih **Buat** untuk membuat eksekusi aliran dan mulai menjalankannya.
1. Pada halaman detail alur, pilih tab **Eksekusi** dan catat status eksekusi alur dalam **status Eksekusi**.
1. (Opsional) Pilih eksekusi untuk membuka alur dan melihat ringkasan eksekusi.
Dalam **output Eksekusi**, Anda melihat output dari aliran.
1. (Opsional) Untuk menghentikan eksekusi flow, pilih eksekusi dan pilih **Stop**.
------
#### [ API ]
**Memulai eksekusi aliran**
Untuk menjalankan eksekusi flow, kirim [StartFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StartFlowExecution.html)permintaan dengan titik akhir [runtime Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Dalam permintaan, tentukan ID aliran dan ID alias aliran aliran yang ingin Anda jalankan. Anda juga dapat menentukan yang berikut:
+ **input** - Array yang berisi simpul [input](flows-nodes.md#flows-nodes-input) yang Anda inginkan agar alirannya mulai berjalan. Anda menentukan input yang akan dikirim ke node input aliran prompt di `content` lapangan.
+ **name** — Nama untuk eksekusi flow.
```
{
"inputs": [{
"nodeName": "FlowInputNode",
"nodeOutputName": "document",
"content": {
"document": "Test"
}
}],
"name": "MyExecution"
}
```
Responsnya adalah Amazon Resource Name (ARN) dari eksekusi flow. Anda dapat menggunakan `executionArn` to polling untuk status aliran saat ini, seperti saat eksekusi flow selesai atau node kondisi mengevaluasi kondisinya.
```
{
"executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution"
}
```
**Lacak kemajuan eksekusi aliran**
Gunakan [GetFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetFlowExecution.html)operasi untuk mendapatkan status arus arus yang Anda identifikasi dengan eksekusi ARN. Status aliran adalah`Running`,,`Succeeded`, `Failed``TimedOut`, atau`Aborted`.
```
{
"endedAt": null,
"errors": null,
"executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution",
"flowAliasIdentifier": "TSTALIASID",
"flowIdentifier": "FLOWID",
"flowVersion": "DRAFT",
"startedAt": "2025-03-20T23:32:28.899221162Z",
"status": "Running"
}
```
Kesalahan (seperti simpul Lambda yang habis waktu) dikembalikan dalam `errors` array seperti contoh berikut:
```
"errors": [{
"nodeName": "LambdaNode1",
"errorType": "ExecutionTimedOut",
"message": "Call to lambda function timed out"
}],
```
**Dapatkan hasil eksekusi aliran**
Amazon Bedrock menulis output dari aliran ke node [output](flows-nodes.md#flows-nodes-output) flow. Anda bisa mendapatkan output setelah aliran selesai atau saat aliran sedang berjalan (tergantung pada kasus penggunaan Anda).
Jika Anda ingin alur selesai terlebih dahulu, lakukan panggilan ke `GetFlowExecution` dan pastikan bahwa nilai `status` bidang dalam respons adalah`Succeeded`.
Untuk mendapatkan daftar peristiwa keluaran dari eksekusi flow, lakukan panggilan ke [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html). Sebagai tanggapan, periksa `flowOutputEvent` objek di`flowExecutionEvents`. Misalnya, Anda bisa mendapatkan output aliran di `content` bidang:
```
{
"flowOutputEvent": {
"content": {
"document": "The model response."
},
"nodeName": "FlowOutputNode"
}
}
```
Anda dapat membatasi output dari `ListFlowExecutions` hanya input dan output node dengan mengatur parameter `eventType` query ke`Flow`.
**Melihat peristiwa**
Untuk membantu men-debug eksekusi flow, Anda dapat menggunakan [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html)operasi untuk melihat peristiwa yang dihasilkan node saat aliran sedang berjalan. Tetapkan parameter `eventType` kueri `Node` untuk melihat input dan output dari semua node (termasuk node perantara) dalam respons yang mirip dengan contoh berikut:
```
{
"flowExecutionEvents": [{
"nodeOutputEvent": {
"fields": [{
"content": {
"document": "History book"
},
"name": "document"
}],
"nodeName": "FlowInputNode",
"timestamp": "2025-05-05T18:38:56.637867516Z"
}
},
{
"nodeInputEvent": {
"fields": [{
"content": {
"document": "History book"
},
"name": "book"
}],
"nodeName": "Prompt_1",
"timestamp": "2025-05-05T18:38:57.434600163Z"
}
},
{
"nodeOutputEvent": {
"fields": [{
"content": {
"document": "Here's a summary of the history book."
},
"name": "modelCompletion"
}],
"nodeName": "Prompt_1",
"timestamp": "2025-05-05T18:39:06.034157077Z"
}
},
{
"nodeInputEvent": {
"fields": [{
"content": {
"document": "Here's a summary of the history book."
},
"name": "document"
}],
"nodeName": "FlowOutputNode",
"timestamp": "2025-05-05T18:39:06.453128251Z"
}
}
]
}
```
**Dapatkan snapshot dari eksekusi alur Anda**
Amazon Bedrock secara otomatis mengambil snapshot definisi aliran dan metadata saat eksekusi flow dimulai. Ini sangat membantu karena aliran dapat diperbarui saat berjalan secara asinkron. Untuk mengambil snapshot ini, panggil operasi. [GetExecutionFlowSnapshot](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetExecutionFlowSnapshot.html) Responsnya mencakup bidang aliran berikut:
+ **customerEncryptionKeyARN** — ARN dari kunci AWS KMS yang mengenkripsi aliran.
+ **definisi** — [Definisi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowDefinition.html) aliran.
+ **executionRoleArn**— ARN dari peran layanan IAM yang digunakan oleh eksekusi aliran.
+ **flowAliasIdentifier**— ID alias aliran.
+ **FloWidentifier - ID** aliran.
+ **FlowVersion** - Versi aliran.
```
{
"customerEncryptionKeyArn": null,
"definition": "{flow-definition}",
"executionRoleArn": "arn:aws:iam::111122223333:role/name",
"flowAliasIdentifier": "TSTALIASID",
"flowIdentifier": "FLOWID",
"flowVersion": "DRAFT"
}
```
**Buat daftar eksekusi aliran Anda**
Anda bisa mendapatkan daftar eksekusi alur Anda dengan memanggil [ListFlowExecutions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutions.html)operasi. Responsnya mencakup `flowExecutionSummaries` array dengan informasi tentang setiap eksekusi aliran Anda dalam arus Wilayah AWS untuk alias aliran atau aliran. Setiap elemen mencakup informasi seperti ARN eksekusi, waktu mulai, dan status arus saat ini.
```
{
"flowExecutionSummaries": [{
"createdAt": "2025-03-11T23:21:02.875598966Z",
"endedAt": null,
"executionArn": "arn:aws:bedrock:us-west-2:111122223333:flow/FLOWID/alias/TSTALIASID/execution/MyExecution",
"flowAliasIdentifier": "TSTALIASID",
"flowIdentifier": "FLOWID",
"flowVersion": "DRAFT",
"status": "Running"
}]
}
```
**Hentikan eksekusi alur yang sedang berjalan**
Jika Anda perlu menghentikan eksekusi aliran yang sedang berjalan, panggil [StopFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StopFlowExecution.html)operasi dan berikan ID aliran, ID alias aliran, dan ID eksekusi aliran untuk eksekusi yang ingin Anda hentikan.
------
## Status eksekusi aliran
Eksekusi flow dapat memiliki salah satu status berikut:
+ **Running** - Eksekusi aliran sedang berlangsung.
+ **Berhasil** - Eksekusi aliran berhasil diselesaikan.
+ **Gagal** - Eksekusi aliran gagal karena kesalahan.
+ **TimedOut**— Eksekusi aliran melebihi runtime maksimum 24 jam.
+ **Dibatalkan** - Eksekusi aliran dihentikan secara manual menggunakan [StopFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StopFlowExecution.html)operasi.
Eksekusi aliran yang tidak lagi berjalan secara otomatis dihapus setelah 90 hari.
## Praktik terbaik untuk eksekusi aliran
Pertimbangkan hal berikut saat menggunakan eksekusi flow:
+ Secara teratur polling status eksekusi flow Anda menggunakan [GetFlowExecution](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetFlowExecution.html)sampai flow Anda mencapai status terminal (yang merupakan hal lain selain`Running`).
+ Saat eksekusi flow Anda mencapai status terminal, gunakan [ListFlowExecutionEvents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListFlowExecutionEvents.html)untuk mendapatkan hasil flow Anda. Misalnya, Anda mungkin menggunakan hasil ini untuk membangun beberapa logika di sekitar alur Anda.
+ Dapatkan snapshot dari eksekusi flow Anda yang digunakan [GetExecutionFlowSnapshot](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetExecutionFlowSnapshot.html)untuk membantu proses debug jika muncul masalah dengan eksekusi.