Crie um fluxo no Amazon Bedrock - Amazon Bedrock

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á.

Crie um fluxo no Amazon Bedrock

Para criar um fluxo, você fornece minimamente um nome e uma descrição para o fluxo 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 configurando os nós, que atuam como etapas no fluxo, e as conexões entre os nós. Antes de criar um fluxo, recomendamos que você leia Como funciona o Amazon Bedrock Flows para se familiarizar com os conceitos e termos do Amazon Bedrock Flows e para saber mais sobre os tipos de nós que estão disponíveis para você. Para saber como criar um fluxo, escolha a guia do seu método preferido e siga as etapas:

Console
Para criar um fluxo

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

  2. Selecione Amazon Bedrock Flows no painel de navegação esquerdo.

  3. Na seção Amazon Bedrock Flows, escolha Criar fluxo.

  4. Informe um Nome para o fluxo e uma Descrição opcional.

  5. Em Nome do perfil de serviço, escolha uma das seguintes opções:

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

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

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

Como construir o fluxo

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

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

    2. Selecione Amazon Bedrock Flows no painel de navegação esquerdo. Em seguida, escolha um fluxo na seção Amazon Bedrock Flows.

    3. Escolha Editar no criador de fluxo.

  2. Na seção Criador de fluxo, 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 de saída do fluxo.

  3. Como adicionar e configurar nós

    1. No painel Flow builder, selecione Nodes.

    2. Arraste um nó que 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 o nó de entrada do 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 acabou de adicionar.

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

    5. Na seção Configurar do painel Construtor de fluxo, 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 Flow builder, selecione Nodes.

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

      nota

      Se você usar um perfil de serviço que o Amazon Bedrock criou automaticamente para você, o perfil será atualizado com as permissões adequadas conforme você adicionar nós. No entanto, se usar um perfil de serviço personalizado, adicione as permissões adequadas à política anexada ao perfil de serviço que se refere a Crie uma função de serviço para o Amazon Bedrock Flows no Amazon Bedrock.

  4. Conecte a Saída do último nó no fluxo com a Entrada do nó de Saída de fluxo. É possível 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 ao lado do nó em que você deseja que o fluxo pare. Desenhe as conexões entre os dois nós.

  5. É possível continuar com o próximo procedimento Teste um fluxo no Amazon Bedrock ou voltar posteriormente. Para continuar com a próxima etapa, escolha Salvar. Para voltar mais tarde, escolha Salvar e sair.

Excluir um nó ou uma conexão

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

Como excluir um nó

  1. Selecione um nó que deseja excluir.

  2. No painel Criador de fluxo, escolha o ícone de exclusão ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ).

    nota

    Se você usar um perfil de serviço que o Amazon Bedrock criou automaticamente para você, o perfil será atualizado com as permissões adequadas conforme você adicionar nós. Ao excluir nós, no entanto, as permissões relevantes não serão excluídas. É recomendável excluir as permissões que não são mais necessárias seguindo as etapas em Modificar um perfil.

Como remover uma conexão

  • Na página Construtor de fluxo, passe o mouse sobre a conexão que deseja remover até ver o ícone de expansão e arraste a conexão para fora do nó.

API

Para criar um fluxo, envie uma CreateFlowsolicitação 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
nome Um nome para o fluxo.
executionRoleArn A ARN da função de serviço com permissões para criar e gerenciar fluxos.

Os seguintes campos são opcionais:

Campo Caso de uso
definition Contém os nodes e as connections que compõem o fluxo.
description Para descrever o fluxo.
tags Para associar tags ao fluxo. Para obter mais informações, consulte Marcação de recursos do Amazon Bedrock.
customerEncryptionKeyArn Para criptografar o recurso com uma KMS chave. Para obter mais informações, consulte Política de chave para permitir que o Amazon Bedrock criptografe e descriptografe um fluxo.
clientToken Para garantir que a API solicitação seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.

Embora o campo definition seja opcional, ele é necessário para que o fluxo seja funcional. É possível escolher criar um fluxo sem a definição primeiro e, em vez disso, atualizar o fluxo posteriormente.

Para cada nó na lista de nodes, especifique o tipo de nó no campo type e forneça a configuração correspondente do nó no campo config. Para obter detalhes sobre a API estrutura dos diferentes tipos de nós, consulteTipos de nós em fluxo.

Os seguintes requisitos são aplicáveis à construção de um fluxo:

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

  • Não é possível incluir entradas para um nó de entrada de fluxo.

  • Não é possível 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 (noAPI, isso é feito por meio de a FlowConnectioncom a FlowDataConnectionConfiguration).

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

Os seguintes ponteiros se aplicam à construção de um fluxo:

  • Comece definindo o tipo de dados para a saída do nó de entrada do fluxo. Esse tipo de dados deve corresponder ao que você espera enviar como a 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 subsequente depois de enviar a saída por meio dos nós necessários. O nó coletor retornará as saídas em uma matriz.