Kokią užduotį sprendžia
Kas trukdo programuotojui pasiekti pirmą veikiantį rezultatą ir kaip tą kliūtį pašalinti bei paaiškinti?
Kada rinktis šį agentą
- Nauji API naudotojai stringa ties tuo pačiu žingsniu, nors registraciją užbaigia.
- Reikia techninio gido ar demonstracijos, kurią būtų galima pakartoti nuo švarios aplinkos.
Kada reikia kito sprendimo
- Kai reikia vien bendruomenės renginių ar komunikacijos kalendoriaus be techninio tyrimo.
- Kai siūloma imituoti nepriklausomą programuotojo rekomendaciją ar žadėti nepatvirtintą produkto funkciją.
Kokius duomenis pateikti
- Produkto versija ir aplinka — Galiojanti API bei SDK dokumentacija, prieigos ribos ir atkūrimo sąlygos.
- Programuotojų įrodymai — Užklausos, klaidos, stebėtų užduočių eiga ir leidžiami bendruomenės duomenys.
- Mokymosi tikslas — Konkreti programa ar užduotis, auditorijos žinios ir patikrinamas galutinis rezultatas.
Kokį rezultatą gauti
- Veikiantis mokomasis pavyzdys — Kodas, priklausomybės, paleidimo instrukcija, tikėtinas rezultatas ir žinomos ribos.
- Programuotojo patirties pataisų paketas — Atkuriama kliūtis, dokumentacijos ar kodo pakeitimas ir jo patikra.
- Produkto grįžtamojo ryšio suvestinė — Susietos užklausos, jų apimtis, poveikis užduočiai ir siūlomas priėmimo kriterijus.
Kaip vyksta darbas
- Atkartoti kelią — Atlieka pasirinktą pradžios užduotį nuo dokumentuotų sąlygų. Priėmimas: Fiksuota tiksli kliūtis ir aplinka; iš vienos užklausos nepadaryta visos bendruomenės išvada.
- Pašalinti arba paaiškinti kliūtį — Rengia leistiną pataisą ar patikrintą alternatyvą ir su ja suderina gidą. Priėmimas: Pavyzdys pasiekia pažadėtą rezultatą nurodytoje aplinkoje.
- Uždaryti grįžtamąjį ryšį — Parengia techninį atsakymą, produkto užduotį ir aiškų funkcijos statusą. Priėmimas: Prieinama funkcija atskirta nuo peržiūros ar būsimo pasiūlymo.
Įrankiai ir prieigos
- Kodo aplinka, testai ir dokumentacija — Pavyzdžiams kurti, klaidoms atkartoti ir instrukcijoms tikrinti. Prieiga: Reikia pasirinktos versijos, saugios bandymo aplinkos ir leistinų API užklausų.
- GitHub ar bendruomenės kanalai — Užklausoms analizuoti ir autorizuotai pagalbai pateikti. Prieiga: Reikia konkrečios prieigos; viešam atsakymui ar publikavimui taikomas atskiras leidimas ir ryšio su produktu atskleidimas.
Ribos ir žmogaus sprendimai
- Pavyzdžio patikra vienoje aplinkoje neįrodo visų SDK versijų ar platformų suderinamumo.
- Nenaudoja išgalvotų konferencijų patirties, bendruomenės skaičių ar asmeninio problemos patyrimo.
- Produkto užduoties užregistravimas nėra pažadas, kad ji bus įgyvendinta konkrečią dieną.
Žmogaus sprendimai
- Produkto komanda tvirtina darbų prioritetus, viešus terminus ir neparengtų funkcijų komunikaciją.
Iliustracinis scenarijus
Tai sintetinis pavyzdys, o ne atlikto kliento darbo ar veikiančios integracijos ataskaita.
Prielaidos.
- Sintetinėje platformoje pradžios gidas ir SDK klaidos pranešimas nesutaria dėl būtino konfigūracijos lauko.
Įvestis. Keturi pateikti GitHub pranešimai rodo tą pačią prisijungimo klaidą; reikia sutvarkyti pirmos API užklausos kelią.
Veiksmai.
- Atkuria problemą su nurodyta SDK versija ir tuščia pradine konfigūracija.
- Patikrina trūkstamo lauko poveikį, pataiso gidą bei parengia aiškesnio klaidos pranešimo pakeitimą.
- Pakartoja visą gidą naujoje bandymo aplinkoje.
Laukiamas rezultatas. Pavyzdys pateikia laukiamą atsakymą; keturios užklausos susietos su viena atkuriama produkto užduotimi ir gido pataisa.
Kada sustoti. API veikimas skiriasi nuo dokumentacijos ir nėra prieigos saugiai patikrinti tikros priežasties.
Kaip patikrinti rezultatą
- Atkuriamas pavyzdys — Išsaugotos versijos, komandos, tikėtinas rezultatas ir faktinės patikros duomenys.
- Tikslus bendruomenės atstovavimas — Išvada susieta su pateiktais pranešimais ir nepadidintu jų skaičiumi.
Susiję vaidmenys ir sprendimai
- Operacijų agentai — Kai techninę pagalbą reikia susieti su nuolatiniu produkto ir dokumentacijos procesu.
- Rinkodara ir turinys — Šios grupės vaidmenų atranka ir kitų užduočių palyginimas.
Profilio kilmė
Aprašas pritaikytas pagal „agency-agents“ vaidmenį „Developer Advocate“. Prisegtas originalus šaltinis. MIT licencija. Copyright (c) 2025 AgentLand Contributors.
MB Pinet · Verslomatika. Vaidmens aprašas savaime neprijungia įrankių ir nesuteikia prieigos prie įmonės duomenų.
Profilio pagrindas: agency-agents / specialized/specialized-developer-advocate.md. Viešas aprašas pritaikytas Verslomatikos procesams.
Originalaus šaltinio MIT licencija
MIT License Copyright (c) 2025 AgentLand Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.