Kodsiz integratsiyalar
3-daraja plaginlari kodsiz: siz mavjud xizmatni biror integratsiya kodini yozmasdan yoki joylashtirmasdan agentlar uchun mavjud qilasiz. Ikki manba turi mavjud — OpenAPI va MCP — va ikkalasi ham o‘z sirlarini ochiq konfiguratsiyadan emas, balki shifrlangan saqlovdan oladi.
OpenAPI: har bir operatsiya uchun bitta vosita
AiHummer’ni istalgan OpenAPI 3.x spetsifikatsiyasiga uning spec_url’i
orqali ko‘rsating va platforma spetsifikatsiyadagi har bir operatsiya uchun
bitta vosita sintez qiladi. Har bir operatsiya agent funksiya-chaqiruv navbati
davomida foydalanishi mumkin bo‘lgan chaqiriladigan vositaga aylanadi — yelimlovchi
kodsiz, har bir so‘nggi nuqta uchun ulanishsiz.
{
"slug": "acme-api",
"name": "Acme API",
"version": "1.0.0",
"kind": "openapi",
"spec_url": "https://api.acme.example/openapi.json"
}
Spetsifikatsiyaning securityScheme’i orqali autentifikatsiya
Autentifikatsiya to‘g‘ridan-to‘g‘ri spetsifikatsiyadan olinadi. AiHummer OpenAPI
securityScheme’ni o‘qiydi va haqiqiy sir chaqiruv vaqtida saqlovdan olinadi —
shunday qilib hisob ma’lumoti hech qachon manifest, prompt yoki loglarga ichki
qo‘yilmaydi.
[!NOTE] Sintez qilingan vositalar spetsifikatsiyaning o‘z operatsiyalari va xavfsizligiga amal qiladi. OpenAPI hujjatingizni aniq saqlang: u e’lon qiladigan operatsiyalar aynan agent ko‘radigan vositalardir.
Tayyor shaxsiy integratsiyalar (foydalanuvchi bo‘yicha OAuth)
Aynan shu OpenAPI mexanizmi katta to‘plamdagi tayyor shaxsiy integratsiyalarni qo‘llab-quvvatlaydi: har biri foydalanuvchi bo‘yicha OAuth integratsiyasi bo‘lib, shaxs uni o‘z hisobiga ulaydi, shundan keyin vositalar uning nomidan harakat qiladi. Allaqachon mavjud bo‘lganlar: Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings va boshqalar. Shaxsiy hisobni ulash foydalanuvchi bo‘yicha Connections sahifasida yoritilgan.
MCP: istalgan serverni ulang
Ikkinchi manba turi istalgan MCP serverini ulaydi. AiHummer u bilan stdio
yoki http transporti orqali muloqot qiladi, uning tools/list’ini chaqiradi
va qaytarilgan vositalarni agentga namoyon etadi. OpenAPI’dagi kabi, buning
uchun integratsiya kodi kerak emas.
{
"slug": "acme-mcp",
"name": "Acme MCP",
"version": "1.0.0",
"kind": "mcp",
"transport": "http",
"url": "https://mcp.acme.example/"
}
Stdio transportli server URL o‘rniga uni ishga tushiradigan buyruq bilan sozlanadi:
{
"slug": "local-mcp",
"name": "Local MCP",
"version": "1.0.0",
"kind": "mcp",
"transport": "stdio",
"command": "my-mcp-server"
}
Sirlar saqlov → env orqali
MCP serverlari uchun sirlar saqlovdan server ishlaydigan muhitga oqadi. Sirni saqlovda bir marta saqlaysiz; AiHummer serverni ishga tushirishda yoki unga ulanishda uni muhit o‘zgaruvchisi sifatida kiritadi, shunday qilib sir materiali manifestdan tashqarida va model kontekstidan tashqarida qoladi.
OpenAPI vs MCP bir qarashda
| OpenAPI | MCP | |
|---|---|---|
| Kirish | OpenAPI 3.x spec_url |
MCP serveri (stdio yoki http) |
| Ishlab chiqarilgan vositalar | Spetsifikatsiyadagi har bir operatsiya uchun bittadan | tools/list nimani qaytarsa |
| Autentifikatsiya | Spetsifikatsiyaning securityScheme’i → saqlov |
Saqlov → server uchun env |
| Kod talab qilinadi | Yo‘q | Yo‘q |
Qaysisini qachon ishlatish kerak
- Xizmat allaqachon OpenAPI hujjatini nashr qilganda OpenAPI’ga murojaat qiling — uning to‘liq operatsiya to‘plamini vositalar sifatida avtomatik olasiz.
- Mavjud MCP serverini ulashni xohlaganingizda yoki lokal vosita serverini stdio orqali ishga tushirganingizda MCP’ga murojaat qiling.
[!TIP] Ikkala manba turi ham boshqa har qanday plagin kabi xuddi shu bir fayllik
manifest.jsonbilan aniqlanadi —openapivamcpturlari vaaihummer plugin validateuchun Plagin SDK sahifasiga qarang.
Keyin qayerga
- Plagin SDK —
openapivamcpuchun manifest maydonlari. - Marketplace umumiy ko‘rinishi va darajalari — kodsiz (3-daraja) qayerda joylashgan.
- Shaxsiy vs umumiy hisob ma’lumotlari — bu vositalar foydalanadigan saqlov sirlari qanday qamrab olinadi.