As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Implantar um fluxo em sua aplicação usando versões e aliases
Ao criar um fluxo pela primeira vez, uma versão de rascunho de trabalho (`DRAFT`) e um alias de teste (`TSTALIASID`) que apontam para a versão de rascunho de trabalho são criados. Quando você faz alterações no fluxo, as alterações se aplicam ao rascunho de trabalho e, portanto, é a versão mais recente do fluxo. Você itera o rascunho de trabalho até que o comportamento do fluxo fique adequado. É possível configurar o fluxo para implantação criando *versões* do fluxo.
A *versão* é um snapshot que preserva o recurso na forma como está no momento em que foi criado. É possível continuar a modificar o rascunho de trabalho e a criar versões do fluxo conforme necessário. O Amazon Bedrock cria versões em ordem numérica, começando em 1. As versões são imutáveis porque atuam como um snapshot do fluxo no momento em que é criado. Para fazer atualizações em um fluxo que implantou na produção, crie uma versão no rascunho de trabalho e faça chamadas ao alias que aponta para essa versão.
Para implantar o fluxo, crie um *alias* que aponte para uma versão do fluxo. Você cria solicitações `InvokeFlow` para esse alias. Com aliases, é possível alternar com eficiência entre diferentes versões do fluxo sem acompanhar a versão. Por exemplo, é possível alterar um alias para apontar para uma versão anterior do fluxo se houver alterações que você precise reverter rapidamente.
Os tópicos a seguir descrevem como criar versões e aliases do fluxo.
**Topics**
+ [Criar uma versão de um fluxo no Amazon Bedrock](flows-version-create.md)
+ [Visualizar informações sobre versões de fluxo do Amazon Bedrock](flows-version-view.md)
+ [Excluir uma versão de um fluxo no Amazon Bedrock](flows-version-delete.md)
+ [Criar um alias de um fluxo no Amazon Bedrock](flows-alias-create.md)
+ [Visualizar informações sobre aliases de fluxos no Amazon Bedrock](flows-alias-view.md)
+ [Modificar um alias de um fluxo no Amazon Bedrock](flows-alias-modify.md)
+ [Excluir um alias de um fluxo no Amazon Bedrock](flows-alias-delete.md)
# Criar uma versão de um fluxo no Amazon Bedrock
Quando a configuração do fluxo estiver adequada para você, crie uma versão imutável do fluxo para a qual possa apontar com um alias. Para saber como criar uma versão do seu fluxo, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como criar uma versão de seus fluxos do Amazon Bedrock**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. Selecione **Fluxos do Amazon Bedrock** no painel de navegação à esquerda. Escolha um fluxo na seção **Fluxos do Amazon Bedrock**.
1. Na seção **Versões**, escolha **Publicar versão**.
1. Depois que a versão for publicada, um banner de sucesso será exibido na parte superior.
------
#### [ API ]
Para criar uma versão do fluxo, envie uma solicitação [CreateFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlowVersion.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique o ARN ou o ID do fluxo como o `flowIdentifier`.
A resposta exibe um ID e um ARN para a versão. As versões são criadas de forma incremental, começando em 1.
------
# Visualizar informações sobre versões de fluxo do Amazon Bedrock
Para saber como visualizar informações sobre as versões de um fluxo, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como visualizar informações sobre uma versão de um fluxo**
1. Abra o [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e faça login em sua conta. Navegue até o Amazon Bedrock.
1. No painel de navegação à esquerda, selecione **Fluxos**. Na seção **Fluxos**, selecione um fluxo que deseja visualizar.
1. Escolha a versão a ser visualizada na seção **Versões**.
1. Para visualizar detalhes sobre os nós e as configurações anexadas à versão do fluxo , selecione o nó e visualize os detalhes no painel **Construtor de fluxos**. Para fazer modificações no fluxo, use o rascunho de trabalho e crie uma versão.
------
#### [ API ]
Para ter informações sobre a versão de um fluxo, envie uma solicitação [GetFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetFlowVersion.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique o ARN ou o ID do fluxo como o `flowIdentifier`. No campo `flowVersion`, especifique o número da versão.
Para listar informações de todas as versões de um fluxo, envie uma solicitação [ListFlowVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListFlowVersions.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique o ARN ou o ID do fluxo como o `flowIdentifier`. É possível especificar os seguintes parâmetros opcionais:
****
| Campo | Descrição breve |
| --- | --- |
| maxResults | O número máximo de resultados a serem apresentados em uma resposta. |
| nextToken | Se houver mais resultados do que o número especificado no campo maxResults, a resposta exibirá um valor de nextToken. Para ver o próximo lote de resultados, envie o valor de nextToken em outra solicitação. |
------
# Excluir uma versão de um fluxo no Amazon Bedrock
Para saber como excluir uma versão de um fluxo, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como excluir uma versão do fluxo**
1. Abra o [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e faça login em sua conta. Navegue até o Amazon Bedrock.
1. No painel de navegação à esquerda, selecione **Fluxos**. Em seguida, na seção **Fluxos**, selecione um fluxo.
1. Escolha **Excluir**.
1. É exibida uma caixa de diálogo avisando sobre as consequências da exclusão. Para confirmar que deseja excluir a versão, insira **delete** no campo de entrada e escolha **Excluir**.
1. Um banner é exibido para informar que a versão está sendo excluída. Quando a exclusão for concluída, um banner de sucesso será exibido.
------
#### [ API ]
Para excluir uma versão do fluxo, envie uma solicitação [DeleteFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteFlowVersion.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique o ARN ou o ID do fluxo no campo `flowIdentifier` e a versão a ser excluída no campo `flowVersion`.
------
# Criar um alias de um fluxo no Amazon Bedrock
Para invocar um fluxo, primeiro é necessário criar um alias que aponte para uma versão do fluxo. Para saber como criar um alias, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como criar um alias para fluxos do Amazon Bedrock**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. Selecione **Fluxos do Amazon Bedrock** no painel de navegação à esquerda. Em seguida, escolha um fluxo na seção **Fluxos**.
1. Na seção **Aliases**, escolha **Criar alias**.
1. Insira um nome exclusivo para o alias e forneça uma descrição opcional.
1. Escolha uma das seguintes opções:
+ Para criar uma versão, escolha **Criar uma versão e associá-la a esse alias**.
+ Para usar uma versão existente, escolha **Usar uma versão existente para associar esse alias**. No menu suspenso, escolha a versão à qual você deseja associar o alias.
1. Selecione **Criar alias**. Um banner de sucesso é exibido na parte superior.
------
#### [ API ]
Para criar um alias que aponte para uma versão do fluxo, envie uma solicitação [CreateFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlowAlias.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Os seguintes campos são obrigatórios:
****
| Campo | Descrição básica |
| --- | --- |
| flowIdentifier | O ARN ou o ID do fluxo para o qual criar um alias. |
| nome | Um nome para o alias. |
| routingConfiguration | Especifique a versão à qual associar o alias no campo flowVersion. |
Os seguintes campos são opcionais:
****
| Campo | Caso de uso |
| --- | --- |
| description | Para fornecer uma descrição do alias. |
| clientToken | Para evitar a reduplicação da solicitação. |
------
A criação de um alias produz um recurso com um identificador e um nome do recurso da Amazon (ARN) que é possível especificar ao invocar um fluxo na aplicação. Para saber como invocar um fluxo, consulte [Testar um fluxo no Amazon Bedrock](flows-test.md).
# Visualizar informações sobre aliases de fluxos no Amazon Bedrock
Para saber como visualizar informações sobre os aliases de um fluxo, escolha a guia correspondente ao método de sua escolha e siga as etapas:
------
#### [ Console ]
**Como visualizar os detalhes de um alias**
1. Abra o [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e faça login em sua conta. Navegue até o Amazon Bedrock.
1. No painel de navegação à esquerda, selecione **Fluxos**. Em seguida, na seção **Fluxos**, selecione um fluxo.
1. Escolha o alias a ser visualizado na seção **Aliases**.
1. É possível visualizar o nome e a descrição do alias e as tags associadas ao alias.
------
#### [ API ]
Para ter informações sobre um alias, envie uma solicitação [GetFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetFlowAlias.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique o ARN ou o ID do fluxo como o `flowIdentifier`. No campo `aliasIdentifier`, especifique o ID ou o ARN do alias.
Para listar informações de todos os aliases de um fluxo, envie uma solicitação [ListFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListFlowAliass.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique o ARN ou o ID do fluxo como o `flowIdentifier`. É possível especificar os seguintes parâmetros opcionais:
****
| Campo | Descrição breve |
| --- | --- |
| maxResults | O número máximo de resultados a serem apresentados em uma resposta. |
| nextToken | Se houver mais resultados do que o número especificado no campo maxResults, a resposta exibirá um valor de nextToken. Para ver o próximo lote de resultados, envie o valor de nextToken em outra solicitação. |
------
# Modificar um alias de um fluxo no Amazon Bedrock
Para saber como modificar um alias de um fluxo, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como modificar um alias**
1. Abra o [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e faça login em sua conta. Navegue até o Amazon Bedrock.
1. No painel de navegação à esquerda, selecione **Fluxos**. Em seguida, na seção **Fluxos**, selecione um fluxo.
1. Na seção **Aliases**, escolha o botão de opção ao lado do alias que você deseja editar.
1. É possível editar o nome e a descrição do alias. Além disso, é possível realizar uma das seguintes ações:
+ Para criar uma versão e associá-la a esta versão, escolha **Criar uma versão e associá-la a esse alias**.
+ Para associar esse alias a uma versão existente diferente, escolha **Usar uma versão existente e associá-la a esse alias**.
1. Selecione **Salvar**.
------
#### [ API ]
Para atualizar um alias, envie uma solicitação [UpdateFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlowAlias.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Inclua os dois campos que você deseja manter e os campos que deseja alterar na solicitação.
------
# Excluir um alias de um fluxo no Amazon Bedrock
Para saber como excluir um alias de um fluxo, escolha a guia correspondente ao método de sua escolha e siga as etapas:
------
#### [ Console ]
**Como excluir um alias**
1. Abra o [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e faça login em sua conta. Navegue até o Amazon Bedrock.
1. No painel de navegação à esquerda, selecione **Fluxos**. Em seguida, na seção **Fluxos**, selecione um fluxo.
1. Para escolher o alias a ser excluído, na seção **Aliases**, escolha o botão de opção ao lado do alias que você deseja excluir.
1. Escolha **Excluir**.
1. É exibida uma caixa de diálogo avisando sobre as consequências da exclusão. Para confirmar que deseja excluir o alias, insira **delete** no campo de entrada e escolha **Excluir**.
1. Um banner é exibido informando que o alias está sendo excluído. Quando a exclusão for concluída, um banner de sucesso será exibido.
------
#### [ API ]
Para um alias de um fluxo, envie a solicitação [DeleteFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteFlowAlias.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique o ARN ou o ID do fluxo no campo `flowIdentifier` e o ARN ou o ID do alias a ser excluído no campo `aliasIdentifier`.
------