Ish maydoni uchun AI yordamchini sozlash
Kim uchun: ish maydoni administratorlari (bulut va mahalliy oʻrnatish) · Vaqt: oʻrnatilgan yordamchi uchun 5 daqiqa, kompaniyaning oʻz AI sini ulash uchun taxminan 15 daqiqa
Umumiy maʼlumot
AI yordamchi ish maydoni haqidagi savollarga javob beradi, yozuvlarni qisqacha bayon qiladi va matnlarni tarjima qiladi — ingliz, rus va oʻzbek tillarida. Xodimlar undan uch joyda foydalanadi:
- AI dan soʻrash: yuqori paneldagi tugma (yoki Ctrl+J) savollar panelini ochadi, masalan «Bu oy qaysi bitimlar yopiladi?». Javoblarda maʼlumot olingan hisobot va yozuvlarga havolalar boʻladi.
- Qisqacha: bitimlar, tashkilotlar, murojaatlar va loyihalarda — yozuv qayerda turgani, xavflar va keyingi qadam haqida qisqa xulosa.
- Tarjima qilish: murojaatlar va bilimlar bazasi maqolalarida — oʻquvchi tiliga tarjima.
Yordamchi ilovaning oʻz huquq tekshiruvlari orqali faqat soʻrovchi allaqachon koʻra oladigan narsani oʻqiydi. U hech qachon maʼlumotlaringizni oʻzgartirmaydi.
Siz ikki narsani hal qilasiz: javoblar qayerdan keladi (AI provayderi) va kim qaysi funksiyalardan foydalanadi. Ikkalasi ham Ish maydoni sozlamalari → AI yordamchi boʻlimida.
Boshlashdan oldin
- Siz ish maydoni administratorisiz.
- Kompaniyaning oʻz AI sini ulash uchun uning maʼlumotlarini tayyorlang: URL manzil, model nomi va xizmat talab qilsa API kalit. Ularni IT jamoangiz yoki AI yetkazib beruvchingiz beradi.
1-qism. AI provayderini tanlang
Ish maydoni sozlamalari → AI yordamchini oching. AI provayderi kartasida toʻrt variantdan birini tanlang:
| Variant | Qachon tanlash kerak | Nimani kiritasiz |
|---|---|---|
| Oʻrnatilgan | Digital Workspace bilan birga keladigan yordamchi kerak. Hech narsa sozlash shart emas. | Hech narsa. Baʼzi mahalliy serverlarda IT jamoa kompaniyaning oʻz AI sini oʻrnatilgan variant qilib qoʻygan boʻladi — karta buni koʻrsatadi. |
| Anthropic (oʻz kalitingiz) | Toʻlovi oʻz Anthropic hisobingizdan boʻladigan Claude modellari kerak. | API kalit. Ixtiyoriy: Asosiy URL (kompaniya proksisi), Model, Tarjimalar uchun model. |
| OpenAI bilan mos | OpenAI yoki Azure OpenAI dan foydalanasiz yoki modelni oʻzingiz ishga tushirasiz: Ollama, vLLM, LM Studio, LocalAI yoki korporativ AI shlyuzi. | Asosiy URL va Model. Ixtiyoriy: API kalit, Kalit sarlavhasi, Tarjimalar uchun model. |
| Oʻz agentingiz | Kompaniyangizning oʻz AI yordamchisi yoki agenti bor va xodimlar undan toʻgʻridan-toʻgʻri Digital Workspace ichida foydalanishini xohlaysiz. | Agent URL manzili. Ixtiyoriy: API kalit, Kalit sarlavhasi, Agentga ish maydoni maʼlumotlarini oʻqishga ruxsat berish. |
Xohlasangiz, Yordamchi nomini kiriting — masalan, kompaniyangiz yordamchisining nomi. U yuqori paneldagi tugma va savollar panelida «AI dan soʻrash» oʻrniga koʻrsatiladi hamda xulosalar va tarjimalarga yorliq boʻladi.
Soʻng Ulanishni tekshirishni bosing. Tekshiruv ekrandagi sozlamalar bilan bitta qisqa soʻrov yuboradi (hech narsa saqlanmaydi va limitga hisoblanmaydi) va quyidagilarni koʻrsatadi:
- hammasi ishlasa, … ms da ulandi va javob namunasi;
- model ish maydoni maʼlumotlarini vositalar orqali oʻqiy oladimi. Bu imkoniyati yoʻq modellar ham javob beradi, lekin faqat umumiy savollarga; ularga raqamlarni oʻylab topish taqiqlangan.
Tekshiruv muvaffaqiyatli oʻtgach, Provayderni saqlashni bosing. Yordamchi darhol yangi provayder orqali ishlay boshlaydi.
OpenAI bilan mos xizmatlar uchun misollar
| Xizmat | Asosiy URL | Model | Kalit sarlavhasi |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 | masalan, gpt-4.1 | (boʻsh qoldiring) |
| Azure OpenAI | toʻliq URL: https://<resurs>.openai.azure.com/openai/deployments/<joylashtirish>/chat/completions?api-version=… | joylashtirish nomi | api-key |
| Ollama (mahalliy) | http://ollama.yourcompany.local:11434/v1 | masalan, llama3.1:70b | (kalitsiz) |
| vLLM / LM Studio (mahalliy) | http://ai-server.yourcompany.local:8000/v1 | serverdagi model nomi | (sozlanganidek) |
/v1 bilan tugaydigan manzilni kiriting; /chat/completions ni Digital Workspace oʻzi qoʻshadi. Yordamchi ish maydoni maʼlumotlarini oʻqiy olishi uchun model vositalarni chaqirishni (function calling) qoʻllab-quvvatlashi kerak.
Bulut versiyasida manzil ochiq boʻlishi va https:// bilan boshlanishi kerak. Yordamchini ichki tizimlarga yoʻnaltirib boʻlmasligi uchun ichki manzillar qabul qilinmaydi. Mahalliy oʻrnatishda ichki manzillar va http:// dan foydalanish mumkin.
2-qism. Kompaniyaning oʻz agentini ulang
Kompaniyangizda oʻz AI yordamchisi allaqachon ishlayotgan boʻlsa, Oʻz agentingizni tanlang. Digital Workspace har bir savol, xulosa va tarjima soʻrovini Agent URL manziliga yuboradi va agent javobini koʻrsatadi. Ushbu tavsifni dasturchilaringizga bering; toʻliq format kartadagi Agentingiz nimani oladi va qaytaradi blokida ham bor.
- Soʻrov. JSON bilan
POST:task(ask, summary, translation yoki test),instructions,messages(suhbat),workspace(nom, slug) vauser(ism, til). - Javob.
{ "answer": "…" }bilan200qaytaring. Oddiy matn ham boʻladi. - Autentifikatsiya. API kalit
Authorization: Bearer <kalit>sifatida yoki Kalit sarlavhasi maydonida koʻrsatilgan sarlavhada yuboriladi. - Yuboruvchini tekshirish. Kalit oʻrnatilgan boʻlsa, har bir soʻrovda
X-DW-TimestampvaX-DW-Signatureboʻladi. Imzo — busha256=va kalitingiz bilan vaqt belgisi + "." + soʻrov matni dan olingan HMAC-SHA256 (hex). Agent imzoni tekshirishi va besh daqiqadan eski vaqt belgilarini rad etishi kerak.
Agentga ish maydoni maʼlumotlarini oʻqishga ruxsat berish (standart holatda oʻchiq): yoqilsa, soʻrovda oʻrnatilgan yordamchining vositalari ham boʻladi — hisobotlar, yozuvlar va yordam maqolalari. Agent javob oʻrniga { "tool_calls": [ … ] } qaytarishi mumkin. Digital Workspace bu vositalarni soʻrovchi nomidan, uning huquqlari bilan bajaradi va natijalarni agent javob bermaguncha tool xabarlari sifatida qaytarib yuboradi. Agent hech qachon maʼlumotlar bazangizga ulanmaydi. Kalit oʻchiq boʻlsa, agent faqat suhbatni, xulosa yoki tarjima qilinadigan matnni va kim soʻrayotganini oladi.
3-qism. Kim nimadan foydalanishini belgilang
- Bu ish maydonida AI yordamchi yoqilgan — asosiy kalit. Oʻchiq boʻlsa, yordamchini hech kim koʻrmaydi.
- Funksiyalar: Ish maydonidan soʻrash, Xulosalar va Tarjimani alohida yoqing yoki oʻchiring.
- Kim foydalana oladi: Ish maydonidagi hamma yoki Faqat shu rollar. Ish maydoni administratorlari har doim foydalana oladi.
- Oylik soʻrovlar: tarif boʻyicha qiymatni qoldiring yoki Boshqa qiymatni tanlang. Chiziq shu oydagi foydalanishni koʻrsatadi.
- Saqlashni bosing.
Bu qoidalar qaysi provayder tanlanganidan qatʼi nazar amal qiladi.
Maxfiylik va xavfsizlik
- Yordamchi faqat soʻrovchiga ochiq narsani koʻradi. Maosh hech qachon yuborilmaydi. Kadrlar maʼlumotlari faqat HR huquqi borlarga, maxfiy hujjatlar esa faqat ularni ocha oladiganlarga koʻrinadi.
- API kalitlar shifrlangan holda saqlanadi, keyin faqat ••••1234 koʻrinishida koʻrsatiladi va hech qachon brauzerga yuborilmaydi. Kalitni almashtirish uchun yangisini kiriting; oʻchirish uchun Saqlangan kalitni oʻchirishni belgilang.
- Sahifa pastidagi Soʻrovlar jurnali har bir soʻrovni koʻrsatadi: qachon, kim, qaysi funksiya, qaysi yozuvlar oʻqilgani va qaysi provayder javob bergani.
Oʻz serveringizda (on-premise): maʼlumotlaringiz qayerga borishi mumkinligini hal qiling
Bulutli provayderda (Anthropic, OpenAI yoki boshqa onlayn xizmat) xodimlar bergan savollar va yordamchi ularga javob berish uchun oʻqigan yozuvlar oʻsha provayderga yuboriladi. Hammasini tarmogʻingiz ichida saqlash uchun kompaniyangizning oʻz AI serverini ulang (masalan Ollama yoki vLLM). Qaysi provayderlarga ruxsat berilishini IT jamoangiz bilan kelishib oling. On-premise administrator qoʻllanmasidagi "Serveringizdan qanday maʼlumotlar chiqadi" maqolasiga qarang.
IT jamoa uchun: butun server uchun bitta sozlama (mahalliy oʻrnatish)
Mahalliy serverda IT jamoa muhit oʻzgaruvchilari orqali kompaniyaning oʻz AI sini barcha ish maydonlari uchun Oʻrnatilgan variant qilishi va soʻng ilovani qayta ishga tushirishi mumkin:
| Oʻzgaruvchi | Qiymat |
|---|---|
AI_PROVIDER | openai (OpenAI bilan mos) yoki agent (oʻz agentingiz). ANTHROPIC_API_KEY bilan Anthropic uchun belgilamang. |
AI_BASE_URL | Xizmat yoki agent URL manzili. |
AI_API_KEY | Kerak boʻlsa, kalit. |
AI_MODEL_SMART / AI_MODEL_FAST | Model va (ixtiyoriy) tarjimalar uchun arzonroq model. |
AI_AUTH_HEADER | Kalit uchun ixtiyoriy sarlavha nomi (masalan, api-key). |
AI_AGENT_TOOLS | Agent ish maydoni maʼlumotlarini oʻqiy olishi uchun 1. |
Ish maydoni administratorlari baribir oʻz ish maydoni uchun boshqa provayderni tanlashi mumkin.
Muammolarni hal qilish
| Xabar | Nima qilish kerak |
|---|---|
| AI yordamchi hali sozlanmagan. | AI provayderi kartasida provayderni tanlang va Provayderni saqlashni bosing. Oʻrnatilgan variantida Bu serverda mavjud emas deb yozilgan boʻlsa, oʻz AI ingizni ulang. |
| The provider rejected the API key. | Kalitni tekshiring. Azure OpenAI uchun Kalit sarlavhasi maydoniga api-key kiriting. |
| Not found at this URL or for this model. | Asosiy URL /v1 bilan tugashini (yoki toʻliq Chat Completions URL ekanini) va model nomi xizmatingizdagidek aniq yozilganini tekshiring. |
| Use an https:// URL. / This address isn’t reachable from the cloud. | Bulut versiyasida xizmat yoki agent uchun ochiq HTTPS manzil kiriting. |
| The AI endpoint didn’t answer in time. | Xizmat 90 soniya ichida javob bermadi. Ishlayotganini tekshiring yoki tezroq modelni tanlang. |
| Tekshiruv oʻtadi, lekin yordamchi ish maydoni maʼlumotlarini koʻrmayotganini aytadi. | Model vositalarni chaqirishni qoʻllab-quvvatlamaydi. Qoʻllab-quvvatlaydigan modelni tanlang yoki oʻz agentingiz uchun Agentga ish maydoni maʼlumotlarini oʻqishga ruxsat berishni yoqing va tool_calls ni qayta ishlang. |
| The agent replied without an answer. | Agent answer maydonli JSON (yoki oddiy matn), vositalarga ruxsat berilgan boʻlsa esa tool_calls qaytarishi kerak. |
| Bu ish maydoni shu oylik AI soʻrovlarini tugatgan. | Oylik soʻrovlarni oshiring yoki keyingi oyning 1-sanasini kuting. |
| Xodim AI dan soʻrash tugmasini koʻrmayapti. | Uning roli Kim foydalana oladi blokida borligini, Ish maydonidan soʻrash yoqilganini va oylik limit tugamaganini tekshiring. |
Bu maqolalar yangilangandan soʻng oʻz serveringizdagi Bilimlar bazasida ham mavjud.