# FinOps: custos dos provedores em um só lugar

Acompanhe custos importados, cobertura e sincronização por conexão, mantendo a assinatura Zild separada do consumo das APIs.

Source: https://zild.ai/pt-BR/docs/apps/zild-admin/updates-finops-provedores

Acompanhe custos importados, cobertura e sincronização por conexão, mantendo a assinatura Zild separada do consumo das APIs.

## Como usar

No Admin, configure o acesso administrativo em AI Providers. Em Provider costs, selecione conexão e mês UTC, sincronize e confira a data da última importação. Compare os valores por dia e serviço com a conta do provedor; inclua o uso realizado fora da Zild nessa conciliação.

## Limites e pré-requisitos

Azure e Bedrock usam orçamentos com alertas: não interrompem consumo. Gemini sincroniza limites, sem importar relatórios de custos e tokens. Ausência de cobertura não significa gasto zero. Relatórios podem chegar com atraso; tokens e requisições não estão disponíveis para todos os provedores.

## Como validar na sua operação

Faça uma importação controlada e compare período, moeda e escopo com a fatura. Defina quem recebe alertas e quem pode alterar orçamentos. Não confunda estimativa financeira com bloqueio técnico.

## Desativar a sincronização não interrompe os agentes

A opção de sincronização automática controla a importação financeira da conexão. Desativá-la não desabilita o conector de execução nem remove limites existentes no provedor. Se a intenção é interromper uma operação, revise o agente, o fluxo e os controles de execução correspondentes; não use a ausência de novas importações como evidência de consumo interrompido.

Da mesma forma, uma falha no teste de execução não apaga automaticamente a configuração financeira. Investigue a mensagem de cada teste separadamente e confira o horário da última verificação.

## Onde consultar cada informação

No Zild Admin, abra FinOps e escolha Custos dos provedores para consultar as importações financeiras por conexão e mês. A aba Sucesso e ROI apresenta os resultados avaliados dos agentes. Use AI Providers para configurar conexões e acessos; as credenciais não são preenchidas na tabela de custos.

Uma falha ao carregar nomes de agentes na aba Sucesso e ROI pode deixar os resultados disponíveis por identificador. Use Tentar novamente para recuperar os nomes e confirme o ID antes de atribuir o resultado a um processo. Esse erro é diferente de uma falha na importação de custos.

## Custos acumulados e média por usuário no dashboard

O custo acumulado do dashboard do Admin reúne os períodos importados no FinOps. Os filtros de uso, como departamento, modelo ou período de atividade, não recortam esse total financeiro. Confira a indicação de total parcial e as importações disponíveis antes de interpretar o valor como cobertura completa.

A média por usuário divide esse custo acumulado pelos usuários com uso de IA nos filtros selecionados. Portanto, alterar um filtro pode mudar o denominador sem mudar o custo. Essa razão não equivale automaticamente ao custo mensal por pessoa nem ao custo do departamento selecionado.

Exemplo sintético: US$ 600 importados e 30 usuários filtrados produzem US$ 20 por usuário. Se um filtro reduzir a lista a 10 usuários, a razão passa a US$ 60, mesmo sem novo gasto. Para comparar áreas ou períodos, concilie primeiro o mesmo escopo de custo, cobertura temporal e população; registre os valores usados fora do indicador resumido.

O gráfico usa custo acumulado por data UTC. Não some seus pontos como se fossem despesas diárias: os pontos já acumulam valores anteriores. Ausência de configuração, importação pendente e falha na consulta também não significam gasto zero.

## Do cadastro ao primeiro teste

- Abra o provedor em AI Providers e confira o conector selecionado. Quando existe exatamente um conector habilitado desse provedor, a tela pode selecioná-lo automaticamente; confirme que é o ambiente desejado.
- Cadastre ou edite o conector de execução e salve o provedor para registrar o vínculo. O teste de acesso pode consultar um conector antes desse salvamento, mas não substitui a gravação da associação.
- Use o teste de execução para verificar acesso ao catálogo. Um resultado positivo não gera uma resposta de IA nem comprova permissão para todos os modelos.
- Sincronize os modelos após salvar e ative os necessários no ModelOps. Se a sincronização falhar, confira a mensagem e o último catálogo válido; salvar o provedor não prova que os modelos foram sincronizados.
- Execute um caso controlado com o modelo escolhido no agente, verificando resposta, ferramentas e custo. Depois configure e teste separadamente a integração financeira, se necessária.

Na edição, o campo de credencial administrativa volta vazio. Deixá-lo vazio preserva a credencial existente; não é um comando para removê-la. Para substituí-la, informe a nova credencial e salve. Testar custos, sincronizar modelos e alterar limites exigem que as alterações pendentes do formulário tenham sido salvas.

Para criar ou editar o conector, além dos acessos de gestão e consulta, são necessárias as permissões CreateConnector ou UpdateConnector, respectivamente. Um botão indisponível pede verificar permissões e estado do formulário antes de trocar a chave.

## Conferência mensal para o responsável pelo processo

- Selecione a conexão financeira e o mês UTC. A lista mostra conexões com custos configurados; ter um conector de execução não garante que ele apareça aqui.
- Confira organização/projeto, cobertura e última importação antes de copiar qualquer número. Uma conexão desabilitada pode manter relatórios antigos e limites já existentes no provedor.
- Abra Custos por serviço para entender o total e Tokens por modelo quando disponível. Tokens em cache já fazem parte dos tokens de entrada: não some as duas colunas para calcular entrada total.
- Compare o valor numérico com o orçamento. A barra percentual do mês atual é limitada a 100%; ela não mostra quanto o gasto excedeu o orçamento. Em meses anteriores, o limite exibido continua sendo o atual, não um orçamento histórico daquele mês.
- Registre o escopo e o horário da conferência junto ao relatório do processo. Se o projeto também atende outras aplicações, o total importado não pode ser atribuído integralmente ao seu piloto.

Exemplo ilustrativo: uma revisão de projetos de engenharia usa uma conta compartilhada com logística. Antes de calcular custo por projeto revisado, separe o consumo atribuível a cada processo por evidências de execução e pelo escopo disponível no provedor. Dividir todo o gasto da conta apenas pelas revisões de engenharia produziria um indicador incorreto.

## Execução e gestão financeira são conexões diferentes

A chave usada pelo agente para executar um modelo não é necessariamente suficiente para consultar custos ou gerenciar orçamentos. Em AI Providers, revise separadamente o conector de execução e a credencial administrativa da integração financeira. Uma conexão de execução pode ser cadastrada antes de ativar os relatórios financeiros.

A configuração financeira pertence à empresa autenticada. Depois de configurada, a identidade de organização/projeto fica fixa para preservar o escopo do histórico. Não reutilize a mesma identidade financeira para empresas diferentes. Trocar a credencial não é o mesmo que trocar o escopo dos relatórios.

## O que cada integração permite acompanhar



<table><thead><tr><th scope="col">Provedor</th><th scope="col">Escopo dos custos</th><th scope="col">Tokens e requisições</th><th scope="col">Controle financeiro</th></tr></thead><tbody><tr><td>OpenAI</td><td>Projeto configurado; inclui uso de outras aplicações nesse projeto.</td><td>Tokens de completions; custos podem incluir outros serviços.</td><td>Limite mensal do projeto; confirme o estado enforcing.</td></tr><tr><td>Anthropic</td><td>Workspace dedicado; Default não é aceito. Priority Tier não integra o relatório importado.</td><td>Tokens por modelo; quantidade de mensagens não é fornecida pelo relatório.</td><td>Configure Spend limits no Console Anthropic. A Zild não confirma nem altera esse teto pela integração.</td></tr><tr><td>Gemini</td><td>Não importa relatórios de custo nesta integração.</td><td>Não importa tokens ou requisições.</td><td>Sincroniza spend cap elegível do projeto; pode haver atraso e ultrapassagem do valor.</td></tr><tr><td>Azure AI Foundry</td><td>Recurso Foundry completo. Search, Storage e outros recursos externos não entram automaticamente.</td><td>Não importa nem estima tokens ou requisições.</td><td>Orçamento com alertas. Não interrompe consumo.</td></tr><tr><td>AWS Bedrock</td><td>Serviço Amazon Bedrock da conta, em todas as regiões comerciais. Exclui cobranças classificadas em outros serviços.</td><td>Não importa nem estima tokens ou requisições.</td><td>AWS Budgets com alertas. Não cria bloqueios de invocação.</td></tr></tbody></table>



## Prepare os identificadores e acessos



<table><thead><tr><th scope="col">Provedor</th><th scope="col">Identificação da conta</th><th scope="col">Credencial administrativa</th></tr></thead><tbody><tr><td>OpenAI</td><td>ID da organização e ID do projeto ativo.</td><td>Chave administrativa autorizada para a conta; separada da chave de execução.</td></tr><tr><td>Anthropic</td><td>ID da organização e workspace dedicado (wrkspc_...).</td><td>Chave administrativa com acesso aos relatórios da organização.</td></tr><tr><td>Gemini</td><td>Conta de faturamento e número canônico do projeto Google Cloud; não use o nome do projeto.</td><td>JSON de conta de serviço. Habilite Cloud Billing Budget, Cloud Billing e Cloud Resource Manager; a conta precisa de acesso de consulta ao projeto e aos budgets exigidos pela operação. A conta de faturamento deve operar em USD.</td></tr><tr><td>Azure AI Foundry</td><td>GUID da assinatura e grupo-de-recursos/nome-do-recurso.</td><td>JSON da aplicação Entra ID com tenantId, clientId e clientSecret. Exige leitura do recurso e permissões Cost Management adequadas. Custos devem estar em USD; não há conversão cambial automática.</td></tr><tr><td>AWS Bedrock</td><td>ID da conta AWS com 12 dígitos e escopo bedrock.</td><td>JSON com accessKeyId, secretAccessKey e sessionToken se temporária. notificationEmail é necessário para criar o budget. Habilite Cost Explorer e acesso IAM ao faturamento; permita consulta de custos e gestão de budgets conforme a operação.</td></tr></tbody></table>



Não compartilhe esses segredos em conversas ou materiais de treinamento. Cadastre-os somente nos campos de configuração apropriados. A integração Bedrock não renova automaticamente tokens temporários: planeje a rotação antes do vencimento.

## Leia os estados antes de tomar uma decisão



<table><thead><tr><th scope="col">Estado</th><th scope="col">Interpretação</th></tr></thead><tbody><tr><td>enforcing</td><td>O provedor confirmou a configuração do teto aplicável. Não implica ausência de atrasos de contabilização.</td></tr><tr><td>alert_only</td><td>Existe orçamento consultivo; o consumo não é bloqueado. Não comprova entrega do e-mail.</td></tr><tr><td>pending / unknown / unconfirmed</td><td>Não há confirmação suficiente do estado final. Reconsulte ou sincronize antes de concluir que a alteração falhou ou foi aplicada.</td></tr><tr><td>unavailable</td><td>A integração não consegue confirmar esse controle. No Anthropic, gerencie o teto no Console.</td></tr><tr><td>blocked / inactive</td><td>No Gemini, blocked indica uso pausado pelo teto; inactive pode indicar espera pelo próximo período. Em budgets, inactive também pode indicar falta de vigência. Interprete conforme o provedor.</td></tr></tbody></table>



## Sincronização, histórico e diagnóstico

- Escolha o mês UTC e confira a última importação bem-sucedida. A rotina importa o mês atual e o anterior; períodos antigos já importados permanecem consultáveis.
- Se houver erro, o painel preserva a importação anterior. Corrija o acesso e sincronize; não interprete dados antigos como atualização concluída.
- No Bedrock, importações automáticas concluídas há menos de seis horas são reaproveitadas. Sincronizar manualmente ignora essa janela e consultas ao Cost Explorer podem gerar cobrança.
- Um mês sem cobertura é diferente de um mês importado sem atividade. No Gemini, a consulta do teto não cria cobertura financeira fictícia.
- Compare a moeda e o escopo do relatório antes de conciliá-lo com a assinatura Zild ou uma fatura consolidada do provedor.

Consultar o dashboard exige AccessReports. Alterar a conexão financeira, sincronizar ou gerenciar limites exige UpdateTenantConfig. A consulta dos conectores de execução também depende de ViewConnectors. Solicite os acessos ao administrador da sua empresa.

## Disponibilidade

Novidade identificada no código da plataforma em outubro de 2026. A disponibilidade depende da versão implantada, das permissões e dos conectores do seu ambiente. Consulte a Zild se o recurso ainda não aparecer.

Documentação revisada: 2026-10-28.

[Ler a novidade no Blog](/pt-BR/blog/finops-provedores)