AWS Bedrock
Conectar AWS Bedrock à operação da sua empresa. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Conectar AWS Bedrock à operação da sua empresa.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Credenciais da sua empresa
O cliente deve obter e configurar suas próprias chaves de API ou a forma de autenticação exigida por este conector. A assinatura Zild é definida pelo tamanho da empresa; o consumo dos serviços externos é cobrado pelo respectivo provedor, separado da assinatura. Não é necessário configurar conectores que sua operação não utiliza.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
CredentialsJson | JSON com region, accessKeyId, secretAccessKey e sessionToken para credenciais temporárias. |
Como obter as credenciais
- Peça ao administrador AWS uma identidade IAM com acesso aos modelos e às operações Bedrock necessárias na região escolhida.
- Obtenha credenciais temporárias por uma sessão IAM/STS autorizada, ou uma access key de um usuário IAM dedicado quando essa for a política da empresa. Não use credenciais root.
- Copie region, accessKeyId, secretAccessKey e, para sessão temporária, sessionToken para CredentialsJson. Atualize as credenciais antes de expirarem.
- No Bedrock, confira o acesso ao modelo e selecione na Zild o modelo ou perfil de inferência disponível na região.
Como funciona na Zild
Este conector assina requisições com AWS SigV4. Uma chave de API Bearer do Bedrock não substitui o JSON IAM exigido por esta implementação.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.
Execução do agente e gestão de custos
Permissão para invocar um modelo não comprova acesso a relatórios financeiros. No conector de execução, mantenha o JSON IAM compatível com SigV4. Credenciais temporárias têm validade: defina quem atualiza a sessão, sem presumir renovação automática pela Zild.
Configure e valide o acesso financeiro separadamente em AI Providers. Um teste de conversa não comprova acesso aos relatórios.
Configurar FinOps: credenciais, cobertura e limites por provedor
Um teste para cada acesso
- Execute uma solicitação curta com dados sintéticos e o modelo escolhido. Registre status, horário e conexão, sem copiar o segredo para logs ou mensagens.
- Se ativar FinOps, confira período, moeda, escopo e última sincronização. Compare o relatório com a conta do provedor; ausência de dados não significa custo zero.
- Ao trocar a credencial, teste novamente os fluxos dependentes e coordene a revogação da antiga com o responsável. Salvar não confirma autenticação nem permissões.
Referência oficial de autenticação — consultada em 28/10/2026