本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 部署代理程式
首次建立 Amazon Bedrock 代理程式時，您會有一個工作草稿版本 (`DRAFT`) 和指向工作草稿版本的測試別名 (`TSTALIASID`)。當您變更代理程式時，變更會套用至工作草稿。您在工作草稿上進行迭代，直到對代理程式的行為感到滿意為止。然後，您可以透過建立代理程式的*別名*，設定代理程式以部署和整合到應用程式。
**別名和版本**
若要部署代理程式，則必須建立*別名*。在別名建立期間，Amazon Bedrock 會自動建立代理程式版本。別名指向這個新建立的版本。或者，您可以將別名指向先前建立的代理程式版本。然後，您可以將應用程式設定為對該別名進行 API 呼叫。
*版本*是一個快照，可以保留資源在建立時存在的原樣。您可以繼續修改工作草稿，並視需要建立代理程式的新別名 (進而建立版本)。在 Amazon Bedrock 中，您可以建立預設指向新版本的別名，以建立新版本的代理程式。Amazon Bedrock 按數字順序建立版本，從 1 開始。
版本在您建立代理程式時會充當快照，因此不可變。若要在生產環境中更新代理程式，您必須建立新的版本並設定應用程式，以呼叫指向該版本的別名。
您可以透過別名，有效地在不同版本的代理程式之間切換，而不需要應用程式追蹤版本。例如，如果需要快速還原變更，您可以將別名變更為指向先前版本的代理程式。
## 暫停已部署的代理程式
您可能需要暫停代理程式的執行。例如，在維護、更新或解決效能問題期間。若要暫停代理程式，您可以使用代理程式的別名搭配 [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) 操作。若要暫停代理程式，請將 `aliasInvocationState` 欄位設為 `REJECT_INVOCATIONS`。若要再次啟動代理程式，請將 `aliasInvocationState` 設為 `ACCEPT_INVOCATIONS`。您不需要進行任何 IAM 政策修改，即可暫停代理程式。
若要檢查代理程式目前是否為暫停，請呼叫 [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) 並檢查 `aliasInvocationState` 欄位。您也可以在 [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html) 的回應中檢查別名的 `aliasInvocationState` 欄位。
**Topics**
+ [暫停已部署的代理程式](#agent-pause)
+ [建立代理程式別名](deploy-agent-proc.md)
+ [檢視 Amazon Bedrock 中代理程式版本的相關資訊](agents-version-view.md)
+ [在 Amazon Bedrock 中刪除代理程式的版本](agents-version-delete.md)
+ [檢視 Amazon Bedrock 中代理程式別名的相關資訊](agents-alias-view.md)
+ [在 Amazon Bedrock 中編輯代理程式的別名](agents-alias-edit.md)
+ [在 Amazon Bedrock 中刪除代理程式的別名](agents-alias-delete.md)
# 建立代理程式別名
下列程序說明如何為代理程式建立別名和版本。建立別名後，您可以透過使用 [Amazon Bedrock 代理程式執行時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)提出 [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) 請求，在應用程式中使用代理程式。
**建立別名**
+ 建立代理程式的別名和版本。選擇您偏好方法的索引標籤，然後遵循下列步驟：
------
#### [ Console ]
**建立別名 (以及選擇性地建立新版本)**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 在**別名**區段中，選擇**建立**。
1. 輸入唯一的**別名名稱**，並提供選用的**描述**。
1. 在**與版本建立關聯**下，選擇下列其中一個選項：
+ 若要建立新版本，選擇**建立新版本，並將其與此別名建立關聯**。
+ 若要使用現有版本，選擇**使用現有版本來與此別名建立關聯**。從下拉式功能表中，選擇要與別名建立關聯的版本。
1. 在**選取輸送量**下，選取下列其中一個選項：
+ 若要讓代理程式在為帳戶設定的速率執行模型推論，請選取**隨需 (ODT)**。如需詳細資訊，請參閱 [Amazon Bedrock 的配額](quotas.md)。
+ 若要讓代理程式使用您先前為模型購買的佈建輸送量，以更高的速率執行模型推論，請選取**佈建輸送量 (PT)**，然後選取佈建模型。如需詳細資訊，請參閱 [使用 Amazon Bedrock 中的佈建輸送量增加模型調用容量](prov-throughput.md)。
1. 選取**建立別名**。
------
#### [ API ]
若要建立代理程式的別名，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html) 請求。
下列是必要欄位：
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/deploy-agent-proc.html)
以下是選填欄位：
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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
```
如需詳細資訊，請參閱 [Hello Amazon Bedrock 代理人](bedrock-agent_example_bedrock-agent_Hello_section.md)。
------
# 檢視 Amazon Bedrock 中代理程式版本的相關資訊
建立代理程式版本後，您可以檢視或刪除它的相關資訊。您只能透過建立新的別名來建立新的代理程式版本。
若要了解如何檢視代理程式版本的相關資訊，請選擇您偏好方法的索引標籤，然後遵循下列步驟：
------
#### [ Console ]
**檢視代理程式版本的相關資訊**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 從**版本**區段中選擇要檢視的版本。
1. 若要檢視連接到代理程式版本之模型、動作群組或知識庫的詳細資訊，請選擇您要檢視的資訊名稱。您無法修改版本的任何部分。若要修改代理程式，請使用工作草稿並建立新版本。
------
#### [ API ]
若要取得代理程式版本的相關資訊，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html) 請求。指定 `agentId` 和 `agentVersion`。
若要列出代理程式版本的相關資訊，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) 請求，並指定 `agentId`。您可以指定以下選用參數：
****
| 欄位 | 簡短描述 |
| --- | --- |
| maxResults | 回應傳回的結果數目上限。 |
| nextToken | 如果結果多於您在 maxResults 欄位中指定的數字，則回應會傳回 nextToken 值。若要查看下一批結果，請在另一個請求中傳送 nextToken 值。 |
------
# 在 Amazon Bedrock 中刪除代理程式的版本
若要了解如何刪除代理程式的版本，請選擇您偏好方法的索引標籤，然後遵循下列步驟：
------
#### [ Console ]
**刪除代理程式的版本**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 若要選擇要刪除的版本，請在**版本**區段中，選擇您要刪除版本旁的選項按鈕。
1. 選擇 **刪除**。
1. 此時會出現對話方塊，警告您刪除的後果。若確認要刪除版本，請在輸入欄位中輸入 **delete**，然後選擇**刪除**。
1. 橫幅隨即出現，通知您正在刪除版本。刪除完成時，會出現成功橫幅。
------
#### [ API ]
若要刪除代理程式的版本，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html) 請求。依預設，`skipResourceInUseCheck` 參數為 `false`，如果資源正在使用中，則會停止刪除。如果將 `skipResourceInUseCheck` 設定為 `true`，即使資源正在使用中，也會刪除資源。
------
# 檢視 Amazon Bedrock 中代理程式別名的相關資訊
若要了解如何檢視代理程式別名的相關資訊，請選擇您偏好方法的標籤，然後遵循下列步驟：
------
#### [ Console ]
**檢視別名的詳細資訊**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 從**別名**區段選擇要檢視的別名。
1. 您可以檢視別名的名稱和描述以及與別名相關聯的標籤。
------
#### [ API ]
若要取得代理程式別名的相關資訊，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) 請求。指定 `agentId` 和 `agentAliasId`。
若要列出代理程式別名的相關資訊，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) 請求，並指定 `agentId`。您可以指定以下選用參數：
****
| 欄位 | 簡短描述 |
| --- | --- |
| maxResults | 回應傳回的結果數目上限。 |
| nextToken | 如果結果多於您在 maxResults 欄位中指定的數字，則回應會傳回 nextToken 值。若要查看下一批結果，請在另一個請求中傳送 nextToken 值。 |
若要檢視別名的所有標籤，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) 請求，並包含別名的 Amazon Resource Name (ARN)。
------
# 在 Amazon Bedrock 中編輯代理程式的別名
若要了解如何編輯代理程式的別名，請選擇您偏好方法的標籤，然後遵循下列步驟：
------
#### [ Console ]
**編輯別名**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 在**別名**區段中，選擇您要編輯之別名旁的選項按鈕。然後選擇 **Edit (編輯)**
1. 視需要編輯任何現有的欄位。如需有關這些欄位的詳細資訊，請參閱 [在應用程式中部署和使用 Amazon Bedrock 代理程式](agents-deploy.md)。
1. 選取 **Save** (儲存)。
**新增或移除與別名相關聯的標籤**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 從**別名**區段中選擇您要管理標籤的別名。
1. 在**標籤**區段中，選擇**管理標籤**。
1. 若要新增標籤，請選擇 **Add new tag** (新增新標籤)。然後輸入**索引鍵**，並選擇性地輸入**值**。若要移除標籤，請選擇 **Remove** (移除)。如需詳細資訊，請參閱 [標記 Amazon Bedrock 資源](tagging.md)。
1. 完成編輯標籤後，選擇**提交**。
------
#### [ API ]
若要編輯代理程式別名，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) 請求。由於所有欄位都將遭覆寫，因此請同時包括您要更新的欄位以及要保持不變的欄位。
若要將標籤新增至別名，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html) 請求，並包含別名的 Amazon Resource Name (ARN)。請求內文包含 `tags` 欄位，該欄位是包含您為每個標籤指定的鍵值對的物件。
若要從別名移除標籤，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) 請求，並包含別名的 Amazon Resource Name (ARN)。`tagKeys` 請求參數是包含您要移除之標籤索引鍵的清單。
------
# 在 Amazon Bedrock 中刪除代理程式的別名
若要了解如何刪除代理程式的別名，請選擇您偏好方法的標籤，然後遵循下列步驟：
------
#### [ Console ]
**刪除別名**
1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。
1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。
1. 若要選擇要刪除的別名，請在**別名**區段中，選擇您要刪除之別名旁的選項按鈕。
1. 選擇 **刪除**。
1. 此時會出現對話方塊，警告您刪除的後果。若確認要刪除別名，請在輸入欄位中輸入 **delete**，然後選擇**刪除**。
1. 橫幅即會出現，通知您正在刪除別名。刪除完成時，會出現成功橫幅。
------
#### [ API ]
若要刪除代理程式的別名，請使用 [Amazon Bedrock 代理程式建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html) 請求。依預設，`skipResourceInUseCheck` 參數為 `false`，如果資源正在使用中，則會停止刪除。如果將 `skipResourceInUseCheck` 設定為 `true`，即使資源正在使用中，也會刪除資源。
```
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
```
如需詳細資訊，請參閱 [Hello Amazon Bedrock 代理人](bedrock-agent_example_bedrock-agent_Hello_section.md)。
------