# Como as equipes podem alocar custos de programação com IA por repositório e projeto? > Aloque custos de programação com IA emitindo credenciais com escopo por um gateway central e anexando IDs imutáveis de repositório, projeto, tarefa, equipe e ambiente a cada evento cobrável. Concilie o uso do provedor em um ledger e separe despesas compartilhadas do trabalho diretamente atribuível. # Como as equipes podem alocar custos de programação com IA por repositório e projeto? A alocação confiável começa na solicitação. Toda chamada deve levar IDs imutáveis de repositório, projeto, tarefa, equipe e ambiente antes de chegar ao provedor. Inferir depois por usuário ou prompt gera relatórios discutíveis. A contabilidade precisa de uma visão estimada quase em tempo real para controles e outra conciliada para finanças. ## Defina uma hierarquia estável Escolha identificadores resistentes a renomeações: | Dimensão | Exemplo | Uso de alocação | |---|---|---| | ID do repositório | `repo_01J...` | Propriedade direta do código | | ID do projeto | `proj_checkout` | Iniciativa ou centro de custo | | ID da tarefa | `task_8421` | Execução individual | | ID da equipe | `team_payments` | Relatório organizacional | | Ambiente | `local`, `ci`, `prod` | Separar experiência e operação | Nomes visíveis são atributos, não chaves. Registre datas quando a propriedade mudar. ## Marque solicitações automaticamente Derive o ID de um registro confiável ligado ao remoto Git normalizado, não da pasta local. Obtenha projeto e tarefa do issue, CI ou plano de controle. Emita credenciais curtas com escopo nessas tags. Permita exceções documentadas e registre quem mudou e por quê. Texto livre manual não deve ser a base. ## Capture um schema único de evento Normalize respostas: ```json { "event_id": "costevt_01J...", "task_id": "task_8421", "repository_id": "repo_01J...", "project_id": "proj_checkout", "team_id": "team_payments", "provider_request_id": "req_...", "model": "provider/model-version", "input_units": 18240, "output_units": 1330, "estimated_cost_usd": 0.084, "final_cost_usd": null, "rate_card_version": "2026-10-01" } ``` Use o mesmo envelope para busca, embeddings, sandboxes e outras ferramentas, com sua unidade. ## Atribua explicitamente trabalho multirrepositório Uma tarefa em vários repositórios deve ter uma tarefa pai e spans filhos. Debite chamadas diretas ao repositório ativo e planejamento realmente compartilhado ao projeto pai. Não divida tudo igualmente por padrão. Se a atribuição exata for impossível, documente a regra e mantenha consistência. ## Separe gasto direto e overhead Chamadas diretas pertencem à tarefa marcada. Gateway, avaliações, observabilidade, caches e engenharia de plataforma pertencem a um pool compartilhado. Distribua com critério visível, como gasto direto, assentos ou tarefas, e publique ambos os totais. | Classe de custo | Método | O proprietário influencia? | |---|---|---| | Inferência | Tags da solicitação | Sim | | Busca e sandbox | Tags da solicitação | Sim | | Gateway compartilhado | Percentual do gasto direto | Parcialmente | | Avaliação central | Repositórios ativos | Parcialmente | | Eventos sem atribuição | Fila de exceções | Requer correção | ## Concilie estimativas com o provedor Use estimativas imediatas para painéis e limites. Diariamente, relacione IDs, substitua estimativas por cobranças e publique ajustes como novas entradas. Não sobrescreva o histórico. Para uso tardio ou reembolso, preserve o evento e adicione ajuste vinculado. Alerte sobre custos sem atribuição, solicitações sem correspondência ou desvio alto. ## Preserve privacidade e auditoria Não é preciso guardar prompts ou código. IDs, modelos, unidades, horários, preços e IDs de solicitação bastam. Governe telemetria de conteúdo separadamente, com retenção menor e acesso restrito. Aplique hash quando finanças precisar apenas de agrupamento. ## Crie relatórios para decisões diferentes Engenharia precisa de custo por tarefa, pull request ou mudança aceita. Finanças precisa de gasto mensal por centro. Plataforma precisa de economia por modelo, cache e falha. Métricas úteis: * custo direto e alocado por repositório; * custo por tarefa bem-sucedida; * desperdício de tentativas e falhas; * combinação de modelos e economia de cache; * percentual sem atribuição; * variação orçamentária por projeto. Não classifique desenvolvedores pelo gasto bruto sem contexto de resultado e complexidade. ## Mantenha portátil a escolha do provedor Um gateway central anexa tags de modo uniforme com vários modelos. Atlas Cloud pode ser uma camada compatível com OpenAI para texto, imagem e vídeo, enquanto o ledger interno mantém a propriedade de repositório e projeto. Assim, muda-se de provedor sem refazer o chargeback. ## Em resumo Aloque custos na solicitação, com IDs estáveis e credenciais com escopo. Concilie cobranças em um ledger append-only, mostre o overhead e trate gasto sem atribuição como erro operacional. ## FAQ ### Quais metadados mínimos são necessários para alocar custos? Registre IDs estáveis de repositório, projeto ou centro de custo, tarefa, equipe, ambiente, modelo, solicitação do provedor, horário, uso e custo. Não dependa apenas de nomes mutáveis. ### Os desenvolvedores devem inserir tags manualmente? Prefira tags automáticas do remoto Git, CI, sistema de tarefas ou chave com escopo. Tags manuais servem como exceção, mas são inconsistentes demais para a contabilidade principal. ### Como alocar custos compartilhados da plataforma? Mantenha a infraestrutura compartilhada em um pool separado e distribua com um critério documentado, como gasto direto, assentos ativos ou volume de tarefas. Não esconda overhead no preço do modelo. ### Como tratar uma tarefa que altera vários repositórios? Use uma tarefa pai com spans filhos por repositório. Atribua chamadas diretas ao repositório ativo e planejamento realmente compartilhado ao projeto pai. ### Relatórios precisam guardar prompts e código? Não. IDs, tokens, modelos, horários e preços bastam para alocação. Governe a retenção de prompts e código separadamente para reduzir risco. ### Com que frequência conciliar custos do provedor? Use estimativas quase em tempo real para controles e conciliação diária para finanças. Relacione IDs de solicitação e registre ajustes tardios sem sobrescrever o histórico.