Atividade Amazon Bedrock Prompt no Jitterbit Studio

Introdução

Uma atividade Prompt do Amazon Bedrock, usando sua conexão Amazon Bedrock, envia um prompt para o modelo especificado no Amazon Bedrock e é destinada a ser usada como um destino em uma operação.

Pré-requisitos

Para usar esta atividade com sucesso, você deve ter as seguintes permissões de conta AWS IAM:

• bedrock:ListFoundationModels
• bedrock:ListKnowledgeBases
• bedrock:GetFoundationModel
• bedrock:GetKnowledgeBase
• bedrock:InvokeModel

Criar uma atividade Amazon Bedrock Prompt

Uma instância de uma atividade Prompt do Amazon Bedrock é criada a partir de uma conexão Amazon Bedrock usando seu tipo de atividade Prompt.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade Prompt do Amazon Bedrock existente pode ser editada a partir destes locais:

• A tela de design (consulte Menu de ações de componentes em Tela de design).
• A aba Componentes do painel de projeto (consulte Menu de ações de componentes em Aba Componentes do painel de projeto).

Configurar uma atividade Amazon Bedrock Prompt

Siga estas etapas para configurar uma atividade Prompt do Amazon Bedrock:

• Etapa 1: Insira um nome e especifique as configurações
  Forneça um nome para a atividade, selecione um modelo e especifique um prompt e configurações opcionais.

• Etapa 2: Revise os esquemas de dados
  Todos os esquemas de solicitação ou resposta são exibidos.

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade, selecione um modelo e especifique um prompt e configurações opcionais. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Menu Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

  • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado no momento.

• Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Prompt do Amazon Bedrock e não deve conter barras / ou dois-pontos :.

• Listar todos os modelos: Selecione esta opção para escolher em uma lista de modelos recuperados do Amazon Bedrock:

  • Selecionar um modelo: Esta seção exibe os modelos disponíveis no endpoint do Amazon Bedrock.

• Modelo selecionado: Após selecionar um modelo, ele é listado aqui.

• Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de modelos. A pesquisa não diferencia maiúsculas de minúsculas. Se os modelos já estiverem exibidos na tabela, os resultados da tabela são filtrados em tempo real a cada digitação. Para recarregar modelos do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

• Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar modelos do endpoint do Amazon Bedrock. Isso pode ser útil se novos modelos foram adicionados ao Amazon Bedrock. Esta ação atualiza todos os metadados usados para construir a tabela de modelos exibida na configuração.

• Selecionando um modelo: Na tabela, clique em qualquer lugar em uma linha para selecionar um modelo. Apenas um modelo pode ser selecionado. As informações disponíveis para cada modelo são obtidas do endpoint do Amazon Bedrock:

  • Identificador do modelo: O ID do modelo.

  • Provedor do modelo: O provedor do modelo.

  • Nome do modelo: O nome do modelo.

Como alternativa, o modelo pode ser especificado no campo Identificador do modelo ou fornecido na transformação de solicitação. Se um modelo for especificado em vários locais, a seguinte ordem de precedência é seguida:

1. Um modelo fornecido na transformação de solicitação substitui todos os campos abaixo.
2. Um modelo especificado no campo Identificador do modelo substitui o campo restante abaixo, mesmo se Listar todos os modelos estiver selecionado.

3. Um modelo selecionado na lista Selecionar um modelo tem a menor precedência.

4. Inserir identificador do modelo: Selecione esta opção para inserir manualmente o nome de um modelo no Amazon Bedrock.

   • Identificador do modelo: Digite o ID do modelo.

5. Prompt: Digite o texto para fazer o prompt do modelo.

6. Usar base de conhecimento: Selecione para ativar as opções de base de conhecimento para o modelo. Quando selecionado, as seguintes opções são exibidas:

   • Escolher base de conhecimento: Você pode especificar uma base de conhecimento usando uma destas duas opções: Listar todas as bases de conhecimento ou Inserir ID da base de conhecimento. Bases de conhecimento com armazenamentos de vetores (Amazon S3 Vectors) ou armazenamentos de dados estruturados (Amazon Redshift) como fontes de recuperação são suportadas.

     • Listar todas as bases de conhecimento: Selecione esta opção para escolher em uma lista de bases de conhecimento disponíveis no endpoint do Amazon Bedrock. Quando esta opção é selecionada, esta tabela fica visível:

       • Selecionar uma base de conhecimento: Esta seção exibe as bases de conhecimento disponíveis no endpoint do Amazon Bedrock.

         • Base de conhecimento selecionada: Após selecionar uma base de conhecimento, ela é listada aqui.

         • Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de bases de conhecimento. A pesquisa não diferencia maiúsculas de minúsculas. Se as bases de conhecimento já estiverem exibidas na tabela, os resultados da tabela são filtrados em tempo real a cada digitação. Para recarregar bases de conhecimento do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

         • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar bases de conhecimento do endpoint do Amazon Bedrock. Isso pode ser útil se novas bases de conhecimento foram adicionadas ao Amazon Bedrock. Esta ação atualiza todos os metadados usados para construir a tabela de bases de conhecimento exibida na configuração.

7. Selecionando uma base de conhecimento: Na tabela, clique em qualquer lugar de uma linha para selecionar uma base de conhecimento. Apenas uma base de conhecimento pode ser selecionada. As informações disponíveis para cada base de conhecimento são obtidas do endpoint do Amazon Bedrock:

   • Status: O status da base de conhecimento, um de CREATING, ACTIVE, DELETING, UPDATING ou FAILED. Para mais informações, consulte a lista de status da base de conhecimento do Amazon Bedrock.

   • Identificador: O ID da base de conhecimento.

   • Nome: O nome da base de conhecimento.

• Inserir ID da base de conhecimento: Selecione esta opção para fornecer o ID da base de conhecimento no endpoint do Amazon Bedrock. Quando esta opção é selecionada, este campo fica visível:

  • Identificador da base de conhecimento: Digite o ID da base de conhecimento.

• Máximo de resultados de recuperação: Digite o número de resultados a recuperar da base de conhecimento. Pode variar de 1 a 100 e o valor padrão é 5.

• Configurações Opcionais: Clique para expandir configurações opcionais adicionais.

  • Aleatoriedade e Diversidade:

    • Temperatura: Digite um parâmetro de influência de temperatura. O valor deste parâmetro pode variar entre 0 e 1, por exemplo: 0.5. Este parâmetro não é suportado com os modelos GPT-5.6 do OpenAI.
    • Top K: Digite um parâmetro de influência Top K. O valor deste parâmetro pode variar entre 0 e 500, por exemplo: 250.
    • Top P: Digite um parâmetro de influência Top P. O valor deste parâmetro pode variar entre 0 e 1, por exemplo: 0.999. Este parâmetro não é suportado com os modelos GPT-5.6 do OpenAI.

  • Comprimento:

    • Comprimento Máximo: Digite um parâmetro de influência de comprimento máximo de resposta. O número máximo de tokens permitidos depende do modelo escolhido.

  • Continuar em Caso de Erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será gravado no log de operação.

• Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

• Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

• Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Todos os esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Esquema de dados: Estes esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de dados.

  O conector do Amazon Bedrock usa a API do Amazon Bedrock. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

• Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint do Amazon Bedrock. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

• Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

• Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

• Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Solução de problemas

Você pode encontrar o seguinte erro ao executar atividades:

Invocation of model ID <model-name> with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

Este erro ocorre porque alguns modelos, incluindo os modelos GPT-5.6 da OpenAI, não suportam throughput sob demanda e exigem o ID de um perfil de inferência entre regiões em vez do ID do modelo retornado na lista Selecionar um modelo.

No Console de Gerenciamento da AWS, acesse Amazon Bedrock > Perfis de inferência e localize o ID do perfil de inferência para o modelo. Para os modelos GPT-5.6 da OpenAI, os prefixos de ID de perfil de inferência válidos variam por modelo e região (por exemplo, us. ou global.), como us.openai.gpt-5.6-terra ou global.openai.gpt-5.6-terra. Para o ID exato do perfil de inferência para seu modelo e região, consulte os cartões de modelo da AWS para GPT-5.6 Sol, GPT-5.6 Terra e GPT-5.6 Luna. Para inserir o ID do perfil de inferência, use a opção Inserir identificador de modelo na etapa 1.

Próximas etapas

Após configurar uma atividade Prompt do Amazon Bedrock, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.

As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas do conector.

As atividades Prompt do Amazon Bedrock podem ser usadas como destino com estes padrões de operação:

• Padrão de transformação
• Padrão de duas transformações (como primeiro ou segundo destino)

Para usar a atividade com funções de script, escreva os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.