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.
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
| Provedor | Escopo dos custos | Tokens e requisições | Controle financeiro |
|---|---|---|---|
| OpenAI | Projeto configurado; inclui uso de outras aplicações nesse projeto. | Tokens de completions; custos podem incluir outros serviços. | Limite mensal do projeto; confirme o estado enforcing. |
| Anthropic | Workspace dedicado; Default não é aceito. Priority Tier não integra o relatório importado. | Tokens por modelo; quantidade de mensagens não é fornecida pelo relatório. | Configure Spend limits no Console Anthropic. A Zild não confirma nem altera esse teto pela integração. |
| Gemini | Não importa relatórios de custo nesta integração. | Não importa tokens ou requisições. | Sincroniza spend cap elegível do projeto; pode haver atraso e ultrapassagem do valor. |
| Azure AI Foundry | Recurso Foundry completo. Search, Storage e outros recursos externos não entram automaticamente. | Não importa nem estima tokens ou requisições. | Orçamento com alertas. Não interrompe consumo. |
| AWS Bedrock | Serviço Amazon Bedrock da conta, em todas as regiões comerciais. Exclui cobranças classificadas em outros serviços. | Não importa nem estima tokens ou requisições. | AWS Budgets com alertas. Não cria bloqueios de invocação. |
Prepare os identificadores e acessos
| Provedor | Identificação da conta | Credencial administrativa |
|---|---|---|
| OpenAI | ID da organização e ID do projeto ativo. | Chave administrativa autorizada para a conta; separada da chave de execução. |
| Anthropic | ID da organização e workspace dedicado (wrkspc_...). | Chave administrativa com acesso aos relatórios da organização. |
| Gemini | Conta de faturamento e número canônico do projeto Google Cloud; não use o nome do projeto. | 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. |
| Azure AI Foundry | GUID da assinatura e grupo-de-recursos/nome-do-recurso. | 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. |
| AWS Bedrock | ID da conta AWS com 12 dígitos e escopo bedrock. | 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. |
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
| Estado | Interpretação |
|---|---|
| enforcing | O provedor confirmou a configuração do teto aplicável. Não implica ausência de atrasos de contabilização. |
| alert_only | Existe orçamento consultivo; o consumo não é bloqueado. Não comprova entrega do e-mail. |
| pending / unknown / unconfirmed | Não há confirmação suficiente do estado final. Reconsulte ou sincronize antes de concluir que a alteração falhou ou foi aplicada. |
| unavailable | A integração não consegue confirmar esse controle. No Anthropic, gerencie o teto no Console. |
| blocked / inactive | 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. |
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.