Водич и увид

Рутирање на нивоу услуге у АИ АПИ мрежном пролазу: брзо, стандардно, обезбеђено и групно без добављача чврстог кодирања

Практична архитектура за излагање АИ нивоа радног оптерећења неутралног провајдера на мрежном пролазу, затим мапирање сваког захтева у брзи, стандардни, обезбеђени или пакетни капацитет са контролама закупаца, аналитиком и записима о наплати.

<п>Рутирање на нивоу услуге је слој политике који одлучује да ли захтев АИ заслужује врхунски капацитет са малим кашњењем, нормалан капацитет на захтев, резервисани проток или дисконтовану асинхрону обраду. Без тог слоја, тимови за апликације обично кодирају заставице специфичне за провајдера, имена примене и крајње тачке серије директно у коду производа. То отежава управљање кашњењем, трошковима, квотама и понашањем наплате станара. <п>Гатеваи треба да изложи намеру радног оптерећења, а не механику добављача. Тим производа би требало да буде у стању да каже „ово је интерактивни одговор подршке“ или „ово је ноћни посао обогаћивања“, док мрежни пролаз пресликава ту намеру на одговарајућу опцију капацитета узводно и бележи шта се заправо догодило. <х2>Проблем читача: класе капацитета постају логика апликације <п>Тимови који користе више од једног добављача модела често почињу са једноставним усмеравањем модела: пошаљите ИД овог модела овом добављачу. Рутирање постаје теже када провајдери излажу различите класе капацитета: <ул> <ли>Премијум руковање захтевима са малим кашњењем за путање према кориснику. <ли>Стандардни дељени капацитет за обичан синхрони саобраћај. <ли>Намјенски или обезбеђени капацитет за предвидљиву пропусност. <ли>Пакетни или асинхрони АПИ-ји за радна оптерећења која су толерантна на кашњење. <ли>Понашање преливања када је резервисани капацитет исцрпљен. <п>Ако свака апликација сама решава ове изборе, организација губи контролу над четири ствари: ко може да користи премиум капацитет, колико кошта, шта се дешава када капацитет није доступан и да ли је изабрани ниво довољно побољшао производ да оправда потрошњу. <п>Практичан образац је да се слој квалитета услуге који је неутралан од добављача стави унутар АИ АПИ мрежног пролаза. <х2>Чињенице на којима треба надограђивати <п>Детаљи се разликују у зависности од добављача, али неколико видљивих чињеница подржава дизајн на нивоу мрежног пролаза. <ул> <ли><стронг>Чињеница: Неки добављачи излажу ниво услуге по захтеву за премијум обраду. ОпенАИ описује Брзи режим као опцију по захтеву користећи параметар <цоде>сервице_тиер и каже да се наплаћује са премиумом у односу на стандардну обраду. ОпенАИ такође наводи да је приоритетна обрада преименована у Брзи режим 30. јула 2026, док су и <цоде>сервице_тиер=приорити и <цоде>сервице_тиер=фаст прихваћени за АПИ захтеве. <ли><стронг>Чињеница: Руковање премијум захтевима можда није посебан универзум квота. ОпенАИ напомиње да се ограничења брзине у брзом режиму деле са другим нивоима услуга и да брзо повећање саобраћаја може да изазове понашање повећања брзине где се део саобраћаја уместо тога може послати у стандардну обраду. <ли><стронг>Чињеница: Ниво услуге може бити аспект извештавања и обрачуна. ОпенАИ каже да клијенти АПИ-ја могу да групишу податке контролне табле коришћења према нивоу услуге и ставци. Антропски документи <цоде>стандард, <цоде>приоритет и <цоде>батцх као вредности нивоа услуге у извештавању о коришћењу АПИ-ја. <ли><стронг>Чињеница: Батцх АПИ-ји могу значајно да смање трошкове за асинхрони рад. Антропска документација о ценама каже да његов пакетни АПИ подржава асинхрону обраду великог обима уз попуст од 50% на улазне и излазне токене. Гоогле-ова документација Гемини Батцх АПИ-ја описује велика асинхрона радна оптерећења по 50% стандардне цене, са компромисима као што је до 24 сата за неке послове великог обима. <ли><стронг>Чињеница: Обезбеђена пропусност је посебан модел капацитета. Мицрософт документује Азуре ОпенАИ обезбеђену пропусност као наменски капацитет, за разлику од стандардних имплементација где се капацитет дели и пропусност може да варира у зависности од потражње. Мицрософт такође документује преливање са обезбеђених имплементација на стандардне примене у истом Азуре ОпенАИ ресурсу. <п>Препорука је да не одражавате сваки термин добављача у коду апликације. Препорука је да се ови механизми нормализују у нивое мрежног пролаза оријентисане на пословање. <х2>Дефинишите нивое мрежног пролаза неутралног провајдера <п>Почните са именовањем нивоа за понашање радног оптерећења, а не терминологију добављача. Корисна прва таксономија је: <табле> <тхеад> <тр> <тх>Ниво мрежног пролаза <тх>Типично радно оптерећење <тх>Очекивање кашњења <тх>Стање трошкова <тх>Подразумевано понашање на старију верзију <тбоди> <тр> <тд><цоде>интерацтиве_фаст <тд>Гласовне петље, ћаскање уживо, радње корисника високе вредности <тд>Најмање практично кашњење <тд>Премијум је дозвољен <тд>Наставите по стандарду или не успете брзо, у зависности од тока посла <тр> <тд><цоде>интерактивни_стандард <тд>Уобичајено ћаскање, подршка за израду нацрта, интерни копилоти <тд>Синхрони <тд>Подразумевана цена <тд>Пробајте поново, резервни или вратите контролисану грешку <тр><тд><цоде>ресервед_цапацити <тд>Предвидљив производни промет са стабилним коришћењем <тд>Предвидљива пропусност <тд>Унапред плаћени или ангажовани капацитет <тд>Прелијте само када то дозвољава политика <тр> <тд><цоде>позадински_попуст <тд>Евалуације, обогаћивање, сумирање, уградња, извештаји <тд>Асинхрони <тд>Пожељни попуст <тд>Чекај у реду док серијска путања не буде доступна <тр> <тд><цоде>емергенци_фаллбацк <тд>Реакција на инцидент или привремена ескалација клијената <тд>Зависно од политике <тд>Контролисани изузетак <тд>Аутоматски истиче након периода одобрења <п>Ова листа нивоа је намерно мала. Ако направите двадесет нивоа, програмери ће заобићи систем. Мрежни пролаз и даље може интерно мапирати један неутрални ниво на неколико механизама специфичних за добављача. <х2>Одвојите тражени ниво од изабраног нивоа <п>Позивалац треба да пошаље тражени ниво, али мрежни пролаз треба да сними и тражени ниво и стварни изабрани ниво. Они нису увек исти. <п>Пример метаподатака захтева: <пре><цоде>{ "модел": "подршка-чет-подразумевано", "поруке": [...], "метаподаци": { "ток посла": "цустомер_суппорт_репли", "тенант_ид": "тенант_123", "рекуестед_гатеваи_тиер": "интерацтиве_фаст", "енд_усер_ид": "у_789" } } <п>Пример записа о отпреми: <пре><цоде>{ "рекуест_ид": "рек_абц", "тенант_ид": "тенант_123", "апи_кеи_ид": "кеи_ливе_456", "ток посла": "цустомер_суппорт_репли", "модел_алиас": "подразумевана подршка за ћаскање", "рекуестед_гатеваи_тиер": "интерацтиве_фаст", "селецтед_провидер": "провидер_а", "селецтед_провидер_тиер": "брзо", "тиер_оутцоме": "селецтед_ас_рекуестед", "довнграде_реасон": нулл, "инпут_токенс": 1840, "оутпут_токенс": 420, "латенци_мс": 1420, "естиматед_цост_усд": "0,0312", "сеттлед_цост_усд": "0,0308" } <п>Ако се премиум захтев пошаље на стандардну обраду због ограничења рампе или правила о буџету закупца, то мора да буде видљиво: <пре><цоде>{ "рекуестед_гатеваи_тиер": "интерацтиве_фаст", "селецтед_провидер_тиер": "стандард", "тиер_оутцоме": "понижено", "довнграде_реасон": "тенант_премиум_будгет_екхаустед" } <п>Ова разлика спречава обмањујуће аналитике. Ако контролне табле приказују само оно што је позивалац захтевао, финансије ће видети премиум намеру, али не и премијум извршење. Ако контролне табле приказују само претходни резултат, тимови производа неће знати када је њихов радни ток осетљив на кашњење ускраћен за премиум капацитет. <х2>Направите матрицу могућности пре рутирања <п>Рутеру на нивоу услуге је потребна матрица могућности. Матрица треба да одговори: за дати модел, регион, закупца и ток посла, који су механизми капацитета доступни? <п>Минимум поља: <ул> <ли><цоде>провајдер <ли><цоде>модел_ор_деплоимент <ли><цоде>региони <ли><цоде>суппортс_синц <ли><цоде>суппортс_батцх <ли><цоде>суппортс_премиум_тиер <ли><цоде>суппортс_провисионед_цапацити <ли><цоде>суппортс_спилловер <ли><цоде>провидер_тиер_валуес <ли><цоде>биллинг_лине_итемс <ли><цоде>кновн_довнграде_бехавиор <ли><цоде>тенант_алловлист <п>Поједностављени пример: <пре><цоде>гатеваи_тиер_мап: интерактивно_брзо: преферирано: - провајдер: опенаи рекуест_парамс: сервице_тиер: брзо - провајдер: антропски рекуест_парамс: сервице_тиер: приоритет резервни: - гатеваи_тиер: интерактивни_стандард дозвољено_када: полици.алловс_стандард_довнграде бацкгроунд_дисцоунт: преферирано: - провајдер: антропски режим: серија - провајдер: близанци режим: серија резервни: - ред: одложен_поновни покушај дозвољено_када: истина резервисани_капацитет: преферирано: - провајдер: азуре_опенаи деплоимент_цласс: обезбеђено резервни: - провајдер: азуре_опенаи деплоимент_цласс: стандард дозвољено_када: полици.алловс_спилловер <п>Ова матрица треба да буде конфигурациона, а не расути код. Промене имена провајдера, регионална доступност и третман наплате ће се временом мењати. Ажурирање смерница мрежног пролаза је безбедније од поновног постављања сваке апликације која позива АПИ. <х2>Класификујте радна оптерећења пре него што изаберете капацитет <п>Најтежи део није мапирање добављача. Одлучује који захтеви заслужују који ниво. <х3>Добри кандидати за <цоде>интерацтиве_фаст <ул> <ли>Гласовни асистенти код којих кашњење прекида разговор. <ли>Ћаскање окренуто клијентима на путевима конверзије или задржавања високе вредности.<ли>Операције човека у петљи где агент активно чека. <ли>Производни инциденти у којима кашњење директно утиче на ублажавање. <х3>Добри кандидати за <цоде>интерацтиве_стандард <ул> <ли>Интерни копилоти. <ли>Подржати израду нацрта где човек може да толерише нормално време одговора. <ли>Функције производа код којих је време одговора битно, али није критично. <х3>Добри кандидати за <цоде>бацкгроунд_дисцоунт <ул> <ли>Ноћни резиме. <ли>Велико обогаћивање документа. <ли>Ванлајн евалуације. <ли>Групно уграђивање се освежава. <ли>Означавање аналитике и генерисање извештаја. <х3>Добри кандидати за <цоде>ресервед_цапацити <ул> <ли>Стално оптерећење производње великог обима. <ли>Уговорено радно оптерећење клијената са предвидљивим обавезама за проток. <ли>Саобраћај који не може да толерише варијације суседа са буком и има довољно искоришћења да оправда наменски капацитет. <п>Једноставно правило је: не дозволите позиваоцима да бирају премијум капацитет само зато што више воле брзину. Захтевајте декларисани ток посла, дозволу станара и буџетску коверту. <х2>Примени дозволе закупца и АПИ кључа <п>Сваки закупац и АПИ кључ треба да имају постављен дозвољени ниво. Нови кључеви би требало да подразумевају стандардне и позадинске нивое, а не премиум нивое. <п>Пример политике закупца: <пре><цоде>{ "тенант_ид": "тенант_123", "алловед_гатеваи_тиерс": [ "интерактивни_стандард", "бацкгроунд_дисцоунт" ], "премиум_тиер": { "енаблед": фалсе, "монтхли_будгет_усд": "0,00", "аппровал_рекуиред": тачно }, "ресервед_цапацити": { "енаблед": истина, "деплоимент_поол": "суппорт-прод-пту", "аллов_спилловер_то_стандард": истина, "спилловер_монтхли_будгет_усд": "500,00" } } <п>Пример замене на нивоу кључа: <пре><цоде>{ "апи_кеи_ид": "кеи_воице_прод", "алловед_гатеваи_тиерс": ["интерацтиве_фаст"], "воркфлов_алловлист": ["воице_цонтрол_лооп"], "премиум_даили_будгет_усд": "75,00", „мак_премиум_траффиц_перцент“: 15 } <п>Смернице на нивоу кључа спречавају случајно проширење. Програмер не може да узме кључ намењен за гласовни саобраћај и да га користи за скрипту за групно сумирање осим ако је ток посла такође дозвољен. <х2>Изричито дизајнирајте понашање на ниже и преливање <п>Понашање на старију верзију је одлука о производу, а не само одлука о инфраструктури. Када премијум или обезбеђени капацитет није доступан, мрежни пролаз треба да изабере једну од четири путање: <ул> <ли><стронг>Наставите по стандарду: Корисно када је доступност важнија од конзистентности кашњења. <ли><стронг>Редо: Корисно за послове у позадини и групна оптерећења. <ли><стронг>Брзо неуспешно: Корисно када би спор одговор био гори од недостатка одговора, као што су уске петље у реалном времену. <ли><стронг>Замоли позиваоца да покуша поново: Корисно када клијент може безбедно да покуша поново са повлачењем и сачуваним кључем идемпотенције. <п>Пример смерница: <пре><цоде>довнграде_полици: воице_цонтрол_лооп: захтевани_ниво: интерактивни_брзи ако_брзо_недоступно: неуспешно_брзо еррор_цоде: ниво_цапацити_унаваилабле цустомер_суппорт_репли: захтевани_ниво: интерактивни_брзи иф_фаст_унаваилабле: настави_на_стандардном рецорд_оутцоме: деградиран нигхтли_доцумент_енрицхмент: захтевани_ниво: бацкгроунд_дисцоунт иф_батцх_унаваилабле: ред мак_куеуе_делаи_хоурс: 24 цонтрацтед_апи_цустомер: захтевани_тиер: резервисани_капацитет иф_ресервед_екхаустед: преливање_на_стандард рекуире_спилловер_будгет: труе <п>Не скривајте преливање. Преливање може побољшати доступност, али мења цену и СЛО тумачење. Фактуре и аналитика треба да покажу захтев за резервисаним капацитетом, догађај преливања, стандардни капацитет који се стварно користи и разлог. <х2>Повежите рутирање нивоа услуге са обрачуном <п>Гатеваи не може да контролише премиум потрошњу ако избор нивоа није део књиге. Сачувајте ова поља за сваки захтев или посао: <ул> <ли>Затражени ниво мрежног пролаза. <ли>Изабрани ниво добављача или класа капацитета. <ли>Исход нивоа: изабрано, деградирано, надограђено, у реду чекања, преливање, одбијено. <ли>Разлог исхода. <ли>Идентификатори закупца, АПИ кључа, корисника и тока посла. <ли>Псеудоним модела и претходни модел или имплементација. <ли>Процењена цена пре отпреме. <ли>Измирени трошкови након што је провајдер познат. <ли>Број кашњења и поновних покушаја за синхроне захтеве. <ли>Време подношења серије, време завршетка и статус уноса резултата за асинхроне послове. <п>Са тим пољима, мрежни пролаз може да одговори на питања која ће поставити финансије и инжењеринг: <ул> <ли>Који закупци су користили премиум капацитет ове недеље?<ли>Који токови посла су изазвали највећу потрошњу? <ли>Колико често су премијум захтеви прелазили на стандардне? <ли>Да ли је <цоде>интерацтиве_фаст довољно побољшао кашњење п95 да оправда премију? <ли>Колико је позадинска групна обрада уштедела у поређењу са синхроном стандардном обрадом? <ли>Колико стандардног преливања је генерисао обезбеђени капацитет? <п>Важна препорука: фактуришите стварни ниво који се користи, а такође приказује тражени ниво за оперативни контекст. У супротном, станари ће бити или изненађени трошковима или заведени у погледу квалитета услуге. <х2>Додајте заштитне ограде тако да премиум не постане подразумевани <п>Када тимови открију бржи ниво, могу га претерано користити. Поставите ограничења на мрежни пролаз пре широког увођења. <ул> <ли><стронг>Премијум буџет по закупцу: Тешки месечни и дневни плафони. <ли><стронг>Одобрење тока посла: Премијум је дозвољен само за именоване токове посла. <ли><стронг>Ограничење удела у саобраћају: На пример, највише 10% синхроних захтева закупца може да користи <цоде>интерацтиве_фаст без одобрења. <ли><стронг>Упозорење од стандардног до премиум: Упозорење када се надогради ток посла који обично користи стандард. <ли><стронг>Упозорење о премијум стопи сагоревања: Упозорење када пројектована потрошња премашује одобрени оквир. <ли><стронг>Аутоматски истек: Привремене хитне замене треба да истекну без ручног чишћења. <ли><стронг>Провере квалификованости групе: Блокирајте групне послове са синхроних премијум нивоа када испуњавају критеријуме серије. <п>Ограде треба да буду реверзибилне. Током инцидента, овлашћени оператер ће можда морати да одобри привремену премију. То замењивање треба да има разлог, одобраваоца, буџет, време истека и евиденцију ревизије. <х2>Секвенца имплементације <п>Сигурно увођење не почиње укључивањем премиум рутирања свуда. Почните са мерењем. <х3>1. Додајте класификацију нивоа сенке <п>Сваки захтев класификујте у предложени ниво мрежног пролаза, али још увек немојте мењати рутирање. Забележите предложени ниво поред постојећег кашњења, трошкова и метаподатака о току посла. Ово открива колико би саобраћаја прешло на премиум, групни или резервисани капацитет да се смернице примењују. <х3>2. Креирајте матрицу способности <п>Наведите механизме добављача, подржане моделе, регионе, ограничења, поља за извештавање и познато понашање на ниже верзије. Третирајте непознато понашање на старију верзију као ризик док се не тестира. <х3>3. Примените дозволе станара у режиму рада на суво <п>Евидентирај да ли би сваки захтев био дозвољен, поништен, стављен у ред чекања или одбијен. Поделите резултате са власницима производа пре примене. <х3>4. Омогући један ниво за једну кохорту <п>Одаберите уски ток посла, као што је путања одговора подршке уживо или ноћни посао резимирања. Омогућите релевантни ниво мрежног пролаза за малу кохорту закупаца. Измерите кашњење п50, кашњење п95, цену, стопу на старију верзију, стопу грешака и пословне метрике окренуте корисницима где су доступне. <х3>5. Проширите само када подаци то подржавају <п>Ако премиум ниво побољшава кашњење, али не и резултате производа, ограничите га. Ако серијска обрада смањује трошкове без нарушавања понашања производа, проширите је. Ако обезбеђени капацитет мирује, поново посетите обавезу или усмерите предвидљивији саобраћај у њега. <х2>Разговарање о експлицитности <ул> <ли><стронг>Премијум нивои са малим кашњењем могу да побољшају одзив, али могу да деле ограничења брзине или да покрену ограничења рампе. Они нису замена за обликовање ограничења брзине. <ли><стронг>Обезбеђени капацитет побољшава предвидљивост, али може да троши новац када је искоришћеност ниска. Стандардни или групни капацитет може бити бољи за нагли саобраћај или саобраћај који толерише кашњење. <ли><стронг>Серијална обрада може да смањи цену токена, али мења понашање производа јер су одговори асинхрони и могу стићи много касније. <ли><стронг>Имена нивоа који су неутрални за добављаче поједностављују код апликације, али мрежни пролаз мора да одржава ажурну матрицу могућности јер провајдери користе различита имена, ограничења, линије за обрачун и понашање на старију верзију. <ли><стронг>Аутоматска нижа верзија побољшава доступност, али може да замагли очекивања СЛО и обрачуна осим ако мрежни пролаз не забележи стварни коришћени ниво. <ли><стронг>Строге контроле закупаца спречавају изненађујућу потрошњу, али престроге смернице могу да блокирају хитне производне токове рада осим ако не постоји контролисана путања замене. <х2>Предвиђање: ниво услуге ће постати првокласна димензија рутирања<п><стронг>Предвиђање: Како АПИ-ји модела буду сазревали, ниво услуге ће постати важан за АИ рутирање као и избор модела, региона и контекста. Тимови неће питати само „који модел треба да одговори на ово?“ Они ће питати „који модел, под којом класом капацитета, за који буџет станара, са којом политиком смањења?“ <п><стронг>Препорука: Дизајнирајте приступну књигу и модел политике сада тако да нове класе капацитета добављача могу да се додају без промене кода апликације. Чак и ако почнете само са стандардним и групним, од почетка користите поља као што су <цоде>рекуестед_гатеваи_тиер, <цоде>селецтед_провидер_тиер и <цоде>тиер_оутцоме. <х2>Контролна листа на коју се може радити <ул> <ли>Дефинишите највише пет нивоа мрежног пролаза који су неутрални од добављача. <ли>Захтевајте сваки АПИ кључ да бисте навели које нивое и токове посла може да користи. <ли>Направите матрицу могућности добављача за премиум, стандард, обезбеђено, групно и преливање понашања. <ли>Забележите захтевани ниво, изабрани ниво, исход на нижу верзију или преливање, кашњење, коришћење и измирене трошкове. <ли>Подразумевани нови кључеви за стандардне или позадинске нивое. <ли>Додајте премијум буџете, ограничења удела саобраћаја и упозорења. <ли>Учините понашање на ниже верзије експлицитним по току посла. <ли>Почните са показатељима у сенци пре примене. <ли>Прво уведите премијум или обезбеђен капацитет за малу кохорту. <ли>Проширите само када кашњење, поузданост или пословни показатељи оправдавају цену. <х2>Закључак <п>Рутирање на нивоу услуге припада АИ АПИ мрежном пролазу јер је одлука о политици која се односи на различите секторе. То утиче на кашњење, трошкове, квоте, дозволе закупца, фактуре и оперативна очекивања. Тимови за апликације не би требало да чврсто кодирају називе нивоа или класе примене специфичних за добављаче само да би изразили хитност радног оптерећења. <п>Практичан мрежни пролаз открива неутралне нивое као што су <цоде>интерацтиве_фаст, <цоде>интерацтиве_стандард, <цоде>ресервед_цапацити и <цоде>бацкгроунд_дисцоунт. Он мапира те нивое у механизме специфичне за провајдера, примењује дозволе закупца, бележи стварни исход и чини премиум капацитет намерним изузетком, а не подразумеваном путањом.<х2>Повезано читање<ул><ли><а хреф="хттпс://модел-гате.цом/ен/блог/рате-лимит-аваре-аи-апи-гатеваис-рпм-тпм-тенант-фаирнесс-17/">обликовање ограничења брзине пре 429 с<ли><а хреф="хттпс://модел-гате.цом/ен/блог/унифиед-батцх-јобс-аи-апи-гатеваи-22/">трајни образац мрежног пролаза за асинхроне групне послове<ли><а хреф="хттпс://модел-гате.цом/ен/блог/аи-апи-биллинг-биллинг-ресерве-1/биллинг-ресерве4-сее"> књига за котирање, резервисање, поравнање и помирење
FAQ

Често постављана питања

Да ли апликације треба директно да бирају нивое услуга специфичних за провајдера?
Обично не. Апликације треба да шаљу намеру радног оптерећења или ниво мрежног пролаза који је неутралан од провајдера. Мрежни пролаз би то требало да преведе у параметре специфичне за добављача, имплементације, пакетне АПИ-је или правила преливања.
Да ли је врхунски капацитет са малим кашњењем замена за управљање ограничењем брзине?
Не. Премиум нивои могу и даље да деле ограничења стопе или да на њих утиче понашање рампе. Гатеваи-у је и даље потребна процена квоте, изједначавање рафала, правичност станара и политика поновног покушаја.
Када радно оптерећење треба да користи пакет уместо синхроног стандардног капацитета?
Користите серију када производ може да толерише асинхроно довршавање: офлајн евалуације, обогаћивање докумената, ноћни резимеи, групно уграђивање и генерисање извештаја су уобичајени кандидати.
Шта треба евидентирати за наплату?
Забележите захтевани ниво мрежног пролаза, стварни ниво добављача или класу капацитета, исход на ниже или преливање, разлог, закупца, кључ, ток посла, употребу токена, кашњење, процењени трошак и измирени трошак.