Crie um fluxo no Amazon Bedrock

nota

O Prompt Flows está em pré-visualização e está sujeito a alterações.

Para criar um fluxo de solicitação, você fornece, no mínimo, um nome e uma descrição para o fluxo de solicitações e especifica uma função de serviço com as permissões adequadas (ou permite que o console do Amazon Bedrock crie automaticamente uma para você). Em seguida, você definirá o fluxo do prompt configurando os nós, que atuam como etapas no fluxo do prompt, e as conexões entre os nós. Antes de criar um fluxo, recomendamos que você leia Como funcionam os fluxos imediatos do Amazon Bedrock para se familiarizar com os conceitos e termos em Fluxos rápidos para o Amazon Bedrock e para saber mais sobre os tipos de nós que estão disponíveis para você. Para saber como criar um fluxo de solicitação, selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console

Para criar um fluxo

1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em Getting Started with o. AWS Management Console

2. Selecione Fluxos imediatos no painel de navegação esquerdo.

3. Na seção Fluxos de solicitação, escolha Criar fluxo de solicitação.

4. Insira um nome para o fluxo e uma descrição opcional.

5. Para o nome da função de serviço, escolha uma das seguintes opções:

   • Crie e use uma nova função de serviço — Deixe o Amazon Bedrock criar uma função de serviço para você usar.

   • Usar uma função de serviço existente — Selecione uma função de serviço personalizada que você configurou anteriormente. Para ter mais informações, consulte Crie uma função de serviço para fluxos rápidos no Amazon Bedrock.

6. (Opcional) Para criptografar seu fluxo de solicitações com uma chave KMS, selecione Personalizar configurações de criptografia (avançadas) e escolha a chave. Para ter mais informações, consulte Política fundamental para permitir que o Amazon Bedrock criptografe e descriptografe um fluxo.

7. Escolha Criar. Seu fluxo é criado e você será levado ao construtor de fluxo imediato, onde poderá criar seu fluxo.

8. Você pode continuar com o procedimento a seguir para criar seu fluxo ou retornar ao criador de fluxo imediato posteriormente.

Para criar seu fluxo

1. Se você ainda não estiver no criador de fluxo de solicitações, faça o seguinte:

   1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em Getting Started with o. AWS Management Console

   2. Selecione Fluxos imediatos no painel de navegação esquerdo. Em seguida, escolha um fluxo na seção Fluxos rápidos.

   3. Escolha Editar no construtor de fluxo imediato.

2. Na seção Prompt Flow Builder, o painel central exibe um nó de entrada de fluxo e um nó de saída de fluxo. Esses são os nós de entrada e saída do seu fluxo.

3. Para adicionar e configurar nós

   1. No painel Prompt flow builder, selecione Nodes.

   2. Arraste um nó que você deseja usar na primeira etapa do fluxo e solte-o no painel central.

   3. Os círculos nos nós são pontos de conexão. Para conectar seu nó de entrada de fluxo ao segundo nó, arraste uma linha do círculo no nó de entrada de fluxo até o círculo na seção Entrada do nó que você acabou de adicionar.

   4. Selecione o nó que você acabou de adicionar.

   5. Na seção Configurar do painel Prompt flow builder, forneça as configurações para o nó selecionado e defina nomes, tipos de dados e expressões para as entradas e saídas do nó.

   6. No painel Prompt flow builder, selecione Nodes.

   7. Repita as etapas para adicionar e configurar os nós restantes em seu fluxo.

      nota

      Se você usar uma função de serviço que o Amazon Bedrock criou automaticamente para você, a função será atualizada com as permissões adequadas à medida que você adicionar nós. No entanto, se você usar uma função de serviço personalizada, deverá adicionar as permissões adequadas à política anexada à sua função de serviço consultando Crie uma função de serviço para fluxos rápidos no Amazon Bedrock a.

4. Conecte a saída do último nó em seu fluxo com a entrada do nó de saída de fluxo. Você pode ter vários nós de saída de fluxo. Para adicionar mais nós de saída de fluxo, arraste o nó de saída de fluxo e solte-o próximo ao nó em que você deseja que o fluxo pare. Certifique-se de estabelecer conexões entre os dois nós.

5. Você pode continuar com o próximo procedimento Teste um fluxo imediato no Amazon Bedrock ou voltar mais tarde. Para continuar na próxima etapa, escolha Salvar. Para voltar mais tarde, escolha Salvar e sair.

Excluir um nó ou uma conexão

Durante o processo de criação do fluxo, talvez seja necessário excluir um nó ou remover as conexões do nó.

Para excluir um nó

1. Selecione um nó que você deseja excluir.

2. No painel Prompt flow builder, escolha o ícone de exclusão ( ).

   nota

   Se você usar uma função de serviço que o Amazon Bedrock criou automaticamente para você, a função será atualizada com as permissões adequadas à medida que você adicionar nós. No entanto, se você excluir os nós, as permissões relevantes não serão excluídas. Recomendamos que você exclua as permissões de que não precisa mais seguindo as etapas em Modificar uma função.

Para remover uma conexão

• Na página do Flow builder, passe o mouse sobre a conexão que você deseja remover até ver o ícone de expansão e, em seguida, arraste a conexão para fora do nó.

API

Para criar um fluxo, envie uma CreateFlowsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

Os campos a seguir são obrigatórios:

Campo	Descrição básica
name	Um nome para o fluxo.
executionRoleArn	O ARN da função de serviço com permissões para criar e gerenciar fluxos.

Os campos a seguir são opcionais:

Campo	Caso de uso
definição	Contém a nodes e connections que compõe o fluxo.
description	Para descrever o fluxo.
tags	Para associar tags ao fluxo. Para ter mais informações, consulte Marcar recursos.
customerEncryptionKeyArn	Para criptografar o fluxo com uma chave KMS. Para ter mais informações, consulte Política fundamental para permitir que o Amazon Bedrock criptografe e descriptografe um fluxo.
clientToken	Para evitar a reduplicação de solicitações.

Embora o definition campo seja opcional, ele é necessário para que o fluxo seja funcional. Você pode optar por criar um fluxo sem a definição primeiro e, em vez disso, atualizar o fluxo posteriormente.

Para cada nó em sua nodes lista, você especifica o tipo de nó no type campo e fornece a configuração correspondente do nó no config campo. Para obter detalhes sobre a estrutura da API de diferentes tipos de nós, consulteTipos de nós em fluxo imediato.

Os requisitos a seguir se aplicam à criação de um fluxo:

• Seu fluxo deve ter somente um nó de entrada de fluxo e pelo menos um nó de saída de fluxo.

• Você não pode incluir entradas para um nó de entrada de fluxo.

• Você não pode incluir saídas para um nó de saída de fluxo.

• Cada saída em um nó deve ser conectada a uma entrada em um nó downstream (na API, isso é feito por meio de um FlowConnectioncom a FlowDataConnectionConfiguration).

• Cada condição (incluindo a padrão) em um nó de condição deve ser conectada a um nó downstream (na API, isso é feito por meio de um FlowConnectioncom a FlowConditionalConnectionConfiguration).

As dicas a seguir se aplicam à criação de um fluxo:

• Comece definindo o tipo de dados para a saída do nó de entrada de fluxo. Esse tipo de dados deve corresponder ao que você espera enviar como entrada ao invocar o fluxo.

• Ao definir as entradas para um fluxo usando expressões, verifique se o resultado corresponde ao tipo de dados escolhido para a entrada.

• Se você incluir um nó iterador, inclua um nó coletor a jusante depois de enviar a saída pelos nós necessários. O nó coletor retornará as saídas em uma matriz.