# Jak zespoły mogą przypisywać koszty programowania z AI do repozytoriów i projektów? > Przypisuj koszty programowania z AI, wydając ograniczone poświadczenia przez centralną bramę i dodając niezmienne znaczniki repozytorium, projektu, zadania, zespołu i środowiska do każdego płatnego zdarzenia. Rozliczaj użycie dostawców w księdze, publikuj raporty i oddzielaj wspólne koszty pośrednie. # Jak zespoły mogą przypisywać koszty programowania z AI do repozytoriów i projektów? Wiarygodne przypisanie zaczyna się w chwili żądania. Każde wywołanie modelu lub płatnego narzędzia musi otrzymać niezmienne identyfikatory repozytorium, projektu, zadania, zespołu i środowiska, zanim dotrze do dostawcy. Późniejsze wnioskowanie na podstawie nazwy użytkownika lub promptu prowadzi do sporów. System rozliczeń potrzebuje dwóch widoków: niemal bieżącego szacunku dla ograniczeń inżynieryjnych oraz uzgodnionego kosztu dla finansów. ## Zdefiniuj stabilną hierarchię przypisania Wybierz identyfikatory odporne na zmiany nazw i reorganizacje: | Wymiar | Przykład | Zastosowanie | |---|---|---| | ID repozytorium | `repo_01J...` | Bezpośrednia własność kodu | | ID projektu | `proj_checkout` | Inicjatywa lub centrum kosztów | | ID zadania | `task_8421` | Pojedynczy przebieg agenta | | ID zespołu | `team_payments` | Raportowanie organizacyjne | | Środowisko | `local`, `ci`, `prod` | Oddzielenie eksperymentów od operacji | Nazwy wyświetlane traktuj jako atrybuty, nie klucze główne. Zapisuj daty obowiązywania przy przenoszeniu repozytorium między zespołami. ## Oznaczaj żądania automatycznie Wyznacz ID repozytorium z zaufanego rejestru opartego na znormalizowanym Git remote, nie na lokalnej nazwie katalogu. ID projektu i zadania pobieraj z issue, zadania CI lub warstwy sterującej agentem. Wydawaj krótkotrwałe poświadczenia ograniczone do tych znaczników. Dopuść udokumentowany wyjątek, ale zapisuj kto i dlaczego zmienił przypisanie. Swobodne ręczne znaczniki nie powinny być domyślne. ## Zbieraj jeden schemat płatnego zdarzenia Normalizuj każdą odpowiedź dostawcy do wspólnego zdarzenia: ```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" } ``` Używaj tej samej koperty dla wyszukiwania, embeddings, sandboxów i innych płatnych narzędzi, z odpowiednim typem jednostki. ## Jawnie przypisuj pracę wielorepozytoryjną Zadanie zmieniające kilka repozytoriów powinno mieć zadanie nadrzędne i odcinki podrzędne per repozytorium. Wywołania podczas inspekcji lub modyfikacji przypisuj odpowiedniemu odcinkowi. Wspólne planowanie księguj w nadrzędnym projekcie. Nie dziel automatycznie każdego wspólnego wywołania po równo. Jeśli jedno repozytorium spowodowało większość pracy, taki podział zniekształca wynik. Gdy dokładność jest niemożliwa, oznacz regułę i stosuj ją konsekwentnie. ## Oddziel wydatki bezpośrednie od wspólnych kosztów Bezpośrednie wywołania modeli i narzędzi należą do oznaczonego zadania. Hosting bramy, ewaluacje, obserwowalność, wspólne cache i inżynieria platformy należą do puli kosztów pośrednich. Rozdzielaj ją według widocznego klucza, na przykład wydatków bezpośrednich, aktywnych stanowisk lub liczby zadań. Pokazuj osobno koszty bezpośrednie i przydzielone. | Klasa kosztu | Metoda przypisania | Czy właściciel ma wpływ? | |---|---|---| | Inference modelu | Znaczniki żądania | Tak | | Płatne wyszukiwanie i sandbox | Znaczniki żądania | Tak | | Wspólna brama | Procent wydatków bezpośrednich | Częściowo | | Centralna ewaluacja | Liczba aktywnych repozytoriów | Częściowo | | Zdarzenia bez przypisania | Kolejka wyjątków | Wymaga naprawy | ## Uzgadniaj szacunki z danymi dostawcy Do dashboardów i limitów używaj natychmiastowych szacunków tokenów lub jednostek. Codziennie dopasowuj ID żądań dostawcy, zastępuj szacunki ostatecznymi opłatami i zapisuj korekty jako nowe pozycje księgi. Nie nadpisuj historii. Przy późnym użyciu lub zwrocie zachowaj pierwotne zdarzenie i dodaj powiązaną korektę. Alarmuj po przekroczeniu progów kosztu bez przypisania, niedopasowanych żądań lub odchylenia szacunków. ## Zachowaj prywatność i audytowalność Przypisanie kosztów nie wymaga przechowywania promptów ani kodu. Dla większości raportów wystarczą identyfikatory, modele, jednostki użycia, czas, ceny i ID żądań. Telemetrią treści zarządzaj osobno, z krótszą retencją i ściślejszym dostępem. Haszuj wrażliwe identyfikatory zewnętrzne, jeśli finanse potrzebują tylko stabilnego grupowania. ## Twórz raporty dla różnych decyzji Inżynieria potrzebuje kosztu na ukończone zadanie, pull request lub zaakceptowaną zmianę. Finanse potrzebują miesięcznych kosztów według centrum. Platforma potrzebuje ekonomiki jednostkowej według modelu, cache i typu awarii. Przydatne miary to: * koszt bezpośredni i przydzielony per repozytorium; * koszt udanego zadania agenta; * straty na ponowieniach i nieudanych przebiegach; * miks modeli i oszczędności cache; * procent wydatków bez przypisania; * odchylenie budżetu według projektu. Nie oceniaj programistów według surowych wydatków bez kontekstu rezultatu i trudności zadania. ## Zachowaj przenośność wyboru dostawcy Centralna brama może spójnie dodawać znaczniki przy wielu modelach. Atlas Cloud może stanowić jedną warstwę zgodną z OpenAI dla modeli tekstowych, obrazowych i wideo, a wewnętrzna księga pozostaje źródłem prawdy o własności repozytoriów i projektów. Takie rozdzielenie umożliwia zmianę dostawcy bez przebudowy logiki rozliczeń. ## Podsumowanie Przypisuj koszty AI w chwili żądania, używając stabilnych ID i ograniczonych poświadczeń. Uzgadniaj końcowe opłaty w księdze append-only, pokazuj wspólne koszty i traktuj brak przypisania jako błąd operacyjny. ## FAQ ### Jakie minimum metadanych jest potrzebne do przypisywania kosztów AI? Zapisuj stabilny identyfikator repozytorium, projektu lub centrum kosztów, zadania, zespołu, środowisko, model, identyfikator żądania dostawcy, czas, użycie i koszt. Nie polegaj wyłącznie na zmiennych nazwach repozytoriów. ### Czy programiści powinni ręcznie wpisywać znaczniki projektu? Preferuj automatyczne znaczniki z remote repozytorium, kontekstu CI, systemu zadań lub ograniczonego klucza API. Ręczne znaczniki są przydatne jako wyjątek, ale zbyt niespójne do głównej księgowości. ### Jak rozdzielać wspólne koszty platformy agentowej? Trzymaj wspólną infrastrukturę w osobnej puli i rozdzielaj ją według udokumentowanego klucza, na przykład bezpośrednich wydatków AI, aktywnych stanowisk lub liczby zadań. Nie ukrywaj jej w cenach modeli. ### Jak obsłużyć zadanie obejmujące kilka repozytoriów? Użyj zadania nadrzędnego z odcinkami podrzędnymi dla repozytoriów. Bezpośrednie wywołania przypisuj aktywnemu repozytorium, a wspólne planowanie do nadrzędnego projektu. ### Czy raport kosztów wymaga treści promptów i kodu? Nie. Wystarczą identyfikatory, liczby tokenów, nazwy modeli, znaczniki czasu i ceny. Retencję promptów i kodu zarządzaj osobno, aby ograniczyć ryzyko prywatności i bezpieczeństwa. ### Jak często uzgadniać koszty dostawców? Używaj szacunków prawie w czasie rzeczywistym do ograniczeń i codziennego uzgodnienia dla finansów. Dopasowuj identyfikatory żądań i zapisuj późne korekty bez nadpisywania historii.