Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Deploy agen
Saat pertama kali membuat agen Amazon Bedrock, Anda memiliki versi draf (`DRAFT`) dan alias pengujian (`TSTALIASID`) yang mengarah ke versi draf yang berfungsi. Ketika Anda membuat perubahan pada agen Anda, perubahan berlaku untuk draf kerja. Anda mengulangi draf kerja Anda sampai Anda puas dengan perilaku agen Anda. Kemudian, Anda dapat mengatur agen Anda untuk penyebaran dan integrasi ke dalam aplikasi Anda dengan membuat *alias* agen Anda.
**Alias dan Versi**
Untuk menyebarkan agen Anda, Anda harus membuat *alias*. Selama pembuatan alias, Amazon Bedrock membuat versi agen Anda secara otomatis. Alias menunjuk ke versi yang baru dibuat ini. Atau, Anda dapat mengarahkan alias ke versi agen Anda yang dibuat sebelumnya. Kemudian, Anda mengonfigurasi aplikasi Anda untuk melakukan panggilan API ke alias itu.
*Versi* adalah snapshot yang mempertahankan sumber daya seperti yang ada pada saat itu dibuat. Anda dapat terus memodifikasi draf kerja dan membuat alias baru (dan akibatnya, versi) dari agen Anda seperlunya. Di Amazon Bedrock, Anda membuat versi baru agen Anda dengan membuat alias yang menunjuk ke versi baru secara default. Amazon Bedrock membuat versi dalam urutan numerik, mulai dari 1.
Versi tidak dapat diubah karena mereka bertindak sebagai snapshot dari agen Anda pada saat Anda membuatnya. Untuk melakukan pembaruan ke agen dalam produksi, Anda harus membuat versi baru dan mengatur aplikasi Anda untuk melakukan panggilan ke alias yang menunjuk ke versi itu.
Dengan alias, Anda dapat beralih secara efisien di antara berbagai versi agen Anda tanpa mengharuskan aplikasi untuk melacak versinya. Misalnya, Anda dapat mengubah alias untuk menunjuk ke versi agen Anda sebelumnya jika ada perubahan yang perlu Anda kembalikan dengan cepat.
## Menjeda agen yang dikerahkan
Anda mungkin perlu menghentikan sementara waktu menjalankan agen. Misalnya, selama pemeliharaan, pembaruan, atau saat menangani masalah kinerja. Untuk menjeda agen, Anda menggunakan alias untuk agen dengan operasi. [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) Untuk menjeda agen, atur `aliasInvocationState` bidang ke`REJECT_INVOCATIONS`. Untuk memulai agen berjalan lagi, atur `aliasInvocationState` ke`ACCEPT_INVOCATIONS`. Anda tidak perlu melakukan modifikasi kebijakan IAM untuk menjeda agen.
Untuk memeriksa apakah agen saat ini dijeda, hubungi [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html)dan periksa bidangnya. `aliasInvocationState` Anda juga dapat memeriksa `aliasInvocationState` bidang untuk alias dalam tanggapan dari [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html).
**Topics**
+ [Menjeda agen yang dikerahkan](#agent-pause)
+ [Buat alias untuk agen Anda](deploy-agent-proc.md)
+ [Melihat informasi tentang versi agen di Amazon Bedrock](agents-version-view.md)
+ [Hapus versi agen di Amazon Bedrock](agents-version-delete.md)
+ [Lihat informasi tentang alias agen di Amazon Bedrock](agents-alias-view.md)
+ [Edit alias agen di Amazon Bedrock](agents-alias-edit.md)
+ [Hapus alias agen di Amazon Bedrock](agents-alias-delete.md)
# Buat alias untuk agen Anda
Prosedur berikut menunjukkan cara membuat alias dan versi untuk agen Anda. Setelah Anda membuat alias, Anda dapat menggunakan agen dalam aplikasi Anda dengan membuat [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)permintaan dengan titik akhir [runtime Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt).
**Untuk membuat alias**
+ Buat alias dan versi agen Anda. Pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk membuat alias (dan opsional versi baru)**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Di bagian **Alias**, pilih **Buat**.
1. Masukkan **nama Alias yang** unik dan berikan **Deskripsi** opsional.
1. Di bawah **Mengaitkan versi**, pilih salah satu opsi berikut:
+ Untuk membuat versi baru, pilih **Buat versi baru dan kaitkan dengan alias ini**.
+ Untuk menggunakan versi yang ada, pilih **Gunakan versi yang ada untuk mengaitkan alias ini**. Dari menu tarik-turun, pilih versi yang ingin Anda kaitkan alias.
1. Di bawah **Pilih throughput**, pilih salah satu opsi berikut:
+ Agar agen Anda menjalankan inferensi model dengan tarif yang ditetapkan untuk akun Anda, pilih **On-Demand (ODT**). Untuk informasi selengkapnya, lihat [Kuota untuk Amazon Bedrock](quotas.md).
+ Agar agen Anda menjalankan inferensi model pada tingkat yang lebih tinggi menggunakan Provisioned Throughput yang sebelumnya Anda beli untuk model tersebut, pilih **Provisioned Throughput (PT)** lalu pilih model yang disediakan. Untuk informasi selengkapnya, lihat [Tingkatkan kapasitas pemanggilan model dengan Provisioned Throughput di Amazon Bedrock](prov-throughput.md).
1. Pilih **Buat alias**.
------
#### [ API ]
Untuk membuat alias agen, kirim [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Bidang berikut diperlukan:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/deploy-agent-proc.html)
Bidang berikut adalah opsional:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/deploy-agent-proc.html)
```
def create_agent_alias(self, name, agent_id):
"""
Creates an alias of an agent that can be used to deploy the agent.
:param name: The name of the alias.
:param agent_id: The unique identifier of the agent.
:return: Details about the alias that was created.
"""
try:
response = self.client.create_agent_alias(
agentAliasName=name, agentId=agent_id
)
agent_alias = response["agentAlias"]
except ClientError as e:
logger.error(f"Couldn't create agent alias. {e}")
raise
else:
return agent_alias
```
Lihat informasi yang lebih lengkap di [Halo Agen Bedrock Amazon](bedrock-agent_example_bedrock-agent_Hello_section.md).
------
# Melihat informasi tentang versi agen di Amazon Bedrock
Setelah Anda membuat versi agen Anda, Anda dapat melihat informasi tentangnya atau menghapusnya. Anda hanya dapat membuat versi baru agen dengan membuat alias baru.
Untuk mempelajari cara melihat informasi tentang versi agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk melihat informasi tentang versi agen**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Pilih versi yang akan dilihat dari bagian **Versi**.
1. Untuk melihat detail tentang model, grup tindakan, atau basis pengetahuan yang dilampirkan ke versi agen, pilih nama informasi yang ingin Anda lihat. Anda tidak dapat memodifikasi bagian mana pun dari versi. Untuk membuat modifikasi pada agen, gunakan draf kerja dan buat versi baru.
------
#### [ API ]
Untuk mendapatkan informasi tentang versi agen, kirim [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Tentukan `agentId` dan`agentVersion`.
Untuk mencantumkan informasi tentang versi agen, kirim [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan. `agentId` Anda dapat menentukan parameter opsional berikut:
****
| Bidang | Deskripsi singkat |
| --- | --- |
| maxResults | Jumlah maksimum hasil yang akan dikembalikan sebagai respons. |
| nextToken | Jika ada lebih banyak hasil daripada angka yang Anda tentukan di maxResults bidang, respons mengembalikan nextToken nilai. Untuk melihat kumpulan hasil berikutnya, kirim nextToken nilai dalam permintaan lain. |
------
# Hapus versi agen di Amazon Bedrock
Untuk mempelajari cara menghapus versi agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk menghapus versi agen**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Untuk memilih versi untuk dihapus, di bagian **Versi**, pilih tombol opsi di sebelah versi yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Kotak dialog muncul memperingatkan Anda tentang konsekuensi penghapusan. Untuk mengonfirmasi bahwa Anda ingin menghapus versi, masukkan **delete** di bidang input dan pilih **Hapus**.
1. Sebuah spanduk muncul untuk memberi tahu Anda bahwa versi sedang dihapus. Ketika penghapusan selesai, spanduk sukses muncul.
------
#### [ API ]
Untuk menghapus versi agen, kirim [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Secara default, `skipResourceInUseCheck` parameternya `false` dan penghapusan dihentikan jika sumber daya sedang digunakan. Jika Anda mengatur `skipResourceInUseCheck` ke`true`, sumber daya akan dihapus bahkan jika sumber daya sedang digunakan.
------
# Lihat informasi tentang alias agen di Amazon Bedrock
Untuk mempelajari cara melihat informasi tentang alias agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk melihat detail alias**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Pilih alias untuk dilihat dari bagian **Alias**.
1. Anda dapat melihat nama dan deskripsi alias dan tag yang terkait dengan alias.
------
#### [ API ]
Untuk mendapatkan informasi tentang alias agen, kirim [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Tentukan `agentId` dan`agentAliasId`.
Untuk mencantumkan informasi tentang alias agen, kirim [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html)permintaan dengan titik [akhir waktu pembuatan Agen untuk Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) tentukan. `agentId` Anda dapat menentukan parameter opsional berikut:
****
| Bidang | Deskripsi singkat |
| --- | --- |
| maxResults | Jumlah maksimum hasil yang akan dikembalikan sebagai respons. |
| nextToken | Jika ada lebih banyak hasil daripada angka yang Anda tentukan di maxResults bidang, respons mengembalikan nextToken nilai. Untuk melihat kumpulan hasil berikutnya, kirim nextToken nilai dalam permintaan lain. |
Untuk melihat semua tag untuk alias, kirim [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)permintaan dengan titik [akhir waktu build Agen untuk Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) sertakan Nama Sumber Daya Amazon (ARN) alias tersebut.
------
# Edit alias agen di Amazon Bedrock
Untuk mempelajari cara mengedit alias agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Mengedit alias**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Di bagian **Alias**, pilih tombol opsi di sebelah alias yang ingin Anda edit. Kemudian pilih **Edit**
1. Edit salah satu bidang yang ada seperlunya. Untuk informasi lebih lanjut tentang bidang ini, lihat[Menyebarkan dan menggunakan agen Amazon Bedrock di aplikasi Anda](agents-deploy.md).
1. Pilih **Simpan**.
**Untuk menambah atau menghapus tag yang terkait dengan alias**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Pilih alias yang ingin Anda kelola tag dari bagian **Alias**.
1. Di bagian **Tanda**, pilih **Kelola tanda**.
1. Untuk menambahkan tanda, pilih **Tambahkan tanda baru**. Kemudian masukkan **Kunci** dan secara opsional masukkan **Nilai**. Untuk menghapus sebuah tag, pilih **Hapus**. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon Bedrock](tagging.md).
1. Setelah selesai mengedit tag, pilih **Kirim**.
------
#### [ API ]
Untuk mengedit alias agen, kirim [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Karena semua bidang akan ditimpa, sertakan kedua bidang yang ingin Anda perbarui serta bidang yang ingin Anda pertahankan sama.
Untuk menambahkan tag ke alias, kirim [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html)permintaan dengan titik [akhir waktu pembuatan Agen untuk Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) sertakan Nama Sumber Daya Amazon (ARN) alias tersebut. Badan permintaan berisi `tags` bidang, yang merupakan objek yang berisi pasangan kunci-nilai yang Anda tentukan untuk setiap tag.
Untuk menghapus tag dari alias, kirim [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)permintaan dengan titik [akhir waktu pembuatan Agen untuk Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) sertakan Nama Sumber Daya Amazon (ARN) alias tersebut. Parameter `tagKeys` permintaan adalah daftar yang berisi kunci untuk tag yang ingin Anda hapus.
------
# Hapus alias agen di Amazon Bedrock
Untuk mempelajari cara menghapus alias agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk menghapus alias**
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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Untuk memilih alias untuk dihapus, di bagian **Alias**, pilih tombol opsi di sebelah alias yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Kotak dialog muncul memperingatkan Anda tentang konsekuensi penghapusan. Untuk mengonfirmasi bahwa Anda ingin menghapus alias, masukkan **delete** di bidang input dan pilih **Hapus**.
1. Sebuah spanduk muncul untuk memberi tahu Anda bahwa alias sedang dihapus. Ketika penghapusan selesai, spanduk sukses muncul.
------
#### [ API ]
Untuk menghapus alias agen, kirim [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Secara default, `skipResourceInUseCheck` parameternya `false` dan penghapusan dihentikan jika sumber daya sedang digunakan. Jika Anda mengatur `skipResourceInUseCheck` ke`true`, sumber daya akan dihapus bahkan jika sumber daya sedang digunakan.
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
Lihat informasi yang lebih lengkap di [Halo Agen Bedrock Amazon](bedrock-agent_example_bedrock-agent_Hello_section.md).
------