MCP сервер
Zammad има сопствени сервер за Model Context Protocol (MCP). Повежите са њим AI клијент који већ користите, на пример апликацију за ћаскање или алатку за програмирање, и одатле читајте, претражујте и мењајте своје тикете. Сервер је део сваке инсталације, не морате ништа додатно да инсталирате нити покрећете.
Да ли сервер прихвата везе, одлучује ваш администратор. Ако веза са https://zammad.example.com/mcp не успе, питајте администратора да ли је сервер укључен.
Повезивање AI клијента
За повезивање у AI клијент уносите лични приступни кључ и адресу сервера.
Креирање личног приступног кључа
AI клијент се повезује помоћу личног приступног кључа вашег налога. Отворите свој профил и његов одељак Приступ путем кључа (погледајте лична подешавања) и креирајте кључ са дозволом ticket.agent, како би AI клијент могао да ради са тикетима. Кључу можете доделити датум истека. Ископирајте кључ који вам Zammad прикаже приликом његовог креирања.
Додавање Zammad-а у AI клијент
Додајте Zammad у AI клијент као MCP сервер. AI клијенту су потребни MCP транспорт Streamable HTTP и могућност да уз сваки захтев шаље фиксно заглавље Authorization: Bearer. Сама подршка за транспорт није довољна. Таква подешавања траже исте три ставке:
- адреса сервера: домен на ком отварате Zammad и иза њега
/mcp, као уhttps://zammad.example.com/mcp - транспорт, Streamable HTTP
- кључ, који се шаље као HTTP заглавље уз сваки захтев:
Authorization: Bearer {your_token}
AI клијенти који читају JSON подешавања, а многи то раде, додају Zammad као сервер са адресом и заглављем. Замените zammad.example.com доменом на ком отварате Zammad, а {your_token} кључем који сте ископирали:
{
"mcpServers": {
"zammad": {
"type": "http",
"url": "https://zammad.example.com/mcp",
"headers": {
"Authorization": "Bearer {your_token}"
}
}
}
}WARNING
Кључ функционише као ваша лозинка. Не стављајте га у датотеку подешавања коју други могу да прочитају или која заврши у репозиторијуму. Држите датотеку приватном или користите упућивање на сачувану тајну тамо где ваш AI клијент то подржава.
Други AI клијенти траже иста три податка у сопственом облику. Када веза проради, први захтев као што је „Прикажи моје додељене тикете” показује да ли AI клијент успоставља везу са Zammad-ом.
Zammad одговара само на адреси за коју је подешен, оној преко које отварате Zammad. Ако повезивање не успе, проверите да ли AI клијент користи тачно ту адресу.
Шта AI клијент може да ради
Повезани AI клијент ради са вашим дозволама: може да ради тачно оно што смеју кључ и ваш налог, ништа више, и бележи своје измене као да сте их ви направили. Корисник без дозвола оператера, као што је клијент, не добија од сервера никакве алатке. Комплетан списак алатки, са приступом и ограничењима сваке од њих, налази се у референци Алатке MCP сервера.
- Отварање тикета по броју, ID или налепљеној вези, и читање његових порука, интерних напомена, прилога, историјата и заједничког нацрта.
- Читање клијента и организације тикета.
- Проналажење тикета по речима и називима, као што су клијент, организација, стање, власник, група или приоритет тикета.
- Излиставање ваших сопствених прегледа и њихових тикета, и сортирање листа, на пример по времену креирања или последњег освежавања, како би AI клијент могао да почне од најстаријег тикета.
- Претраживање корисника, организација и базе знања.
- Читање текста датотека приложених уз поруку: текстуалне датотеке до 10 MB, а остале датотеке се враћају као веза за преузимање.
- Измена атрибута тикета, постављање ознака и додавање интерних напомена.
- Чување и слање заједничких нацрта, и повезивање тикета и одговора базе знања.
- Креирање тикета и писање порука.
Поруке, напомене и нацрти могу бити написани као обичан текст или као HTML. Zammad из HTML-а уклања небезбедне елементе. SMS, Telegram, WhatsApp и Facebook прихватају само обичан текст, HTML се тамо одбија. Датотеке се не могу слати преко AI клијента: ако желите да пошаљете датотеку, додајте је поруци у самом Zammad-у.
Тамо где тикет захтева обрачун времена, AI клијент од вас тражи време и бележи га. Можете му рећи и да не обрачунавате време, и Zammad ће тада сачувати поруку без обрачунатог времена.
Одобравање одлазних порука
Тамо где AI клијент то може да прикаже, Zammad од вас тражи да одобрите поруку пре него што она стигне до клијента. Захтев за одобрење приказује комплетан текст поруке, примаоце и видљивост, а Zammad шаље поруку тек када је прихватите.
Ако одбијете, Zammad ништа не шаље и ништа не мења на тикету. AI клијент тада може да понуди да сачува текст као заједнички нацрт тикета, тамо где група дозвољава заједничке нацрте, како бисте га послали из самог Zammad-а.
AI клијент који не може да прикаже образац за одобрење ослања се на сопствено одобрење позива алатке, као и за сваку другу измену, и Zammad не пита по други пут. Zammad ипак тражи ваше „да” за две измене: замену заједничког нацрта који је већ сачуван и затварање тикета чији списак задатака није комплетан. Оставите одобравање позива алатки укључено у свом AI клијенту, јер AI клијент који их извршава без потврде шаље поруку без икаквог даљег питања.