Kodsiz integratsiyalar

v1.0.x · yangilandi 2026-07-05

Tier-3 plaginlari nol-kod: siz mavjud xizmatni agentlar uchun integratsiya kodini yozmasdan yoki joylashtirmasdan foydalanishga taqdim qilasiz. Ikki xil manba turi mavjud — OpenAPI va MCP — va ikkalasi ham o’z sirlarini ochiq konfiguratsiyadan emas, shifrlangan ombordan hal qiladilar.

OpenAPI: har bir operatsiya uchun bitta vosita

AiHummer ni istalgan narsaga yo’naltiring OpenAPI 3.x spec uning orqali spec_url va platforma har bir operatsiya uchun bitta vositani sintez qiladi har bir amalda. Har bir operatsiya agent funktsiya chaqirish navbati davomida ishlatishi mumkin bo‘lgan chaqiriladigan vositaga aylanadi — hech qanday ip kod, hech qanday har bir endpoint uchun ulash ishlari yo‘q.

{
  "version": "1.0.0",
  "kind": "openapi",
  "scope": "shared",
  "openapi": {
    "spec_url": "https://api.acme.example/openapi.json"
  }
}

Manifest plaginning slug yoki nomini o‘zida saqlamaydi — ular o‘rnatish vaqtida katalog/komplektdan keladi (qarang Plagin SDK).

Spec securityScheme orqali autentifikatsiya

Autentifikatsiya toʻgʻridan-toʻgʻri spetsifikatsiyadan olinadi. AiHummer OpenAPI ni oʻqiydi securityScheme, va haqiqiy sir shundan olinadi seif chaqirish vaqtida — shuning uchun credential hech qachon manifestga, promptga yoki loglarga joylashtirilmaydi.

[!NOTE] Sintetik vositalar spetsifikatsiyaning o‘z operatsiyalari va xavfsizligini kuzatadi. Oʻzingizni saqlang OpenAPI hujjati aniq: u e’lon qilgan operatsiyalar aynan vositalardir agent ko’radi.

Tayyor shaxsiy integratsiyalar (foydalanuvchi bo‘yicha OAuth)

Xuddi shu OpenAPI mexanizmi katta miqdordagi tayyor mahsulotlarni qo‘llab-quvvatlaydi shaxsiy integratsiyalar: har biri foydalanuvchi uchun OAuth integratsiyasi bo‘lib, biror kishi uni o‘z hisobiga ulanadi, shundan so‘ng vositalar uning nomidan harakat qiladi. Allaqachon mavjud bo‘lganlari: 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 quyidagida qamrab olingan foydalanuvchi boshiga ulanishlar.

MCP: har qanday serverga ulaning

Ikkinchi manba turi har qanday narsani bog‘laydi MCP server. AiHummer buning bilan gaplashadi stdio yoki http transport, uni chaqiradi tools/list, va agentga qaytarilgan vositalarni ochib beradi. OpenAPI dagi kabi, buning uchun hech qanday integratsiya kodi kerak emas.

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.acme.example/"
  }
}

Stdio-transport serveri URL o‘rniga uni ishga tushiradigan buyruq orqali sozlanadi:

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "stdio",
    "command": "my-mcp-server"
  }
}

Maxfiy ma’lumotlar kassadan → muhitga

MCP serverlari uchun sirlar oqadi g’orgondan atrof-muhitga server bilan ishlaydi. Siz sirni bir marta guvohnomada saqlaysiz; AiHummer uni serverni ishga tushirayotganda yoki unga ulanayotganda atrof-muhit o‘zgaruvchisi sifatida qo‘shadi, shuning uchun sir material manifestda va model kontekstida qolmaydi.

OpenAPI va MCP qisqacha ko’rinish

	OpenAPI	MCP
Kiritish	OpenAPI 3.x `spec_url`	MCP serveri (stdio yoki http)
Ishlangan asboblar	Spetsifikatsiyada har bir operatsiyada bittadan	Qanday bo‘lmasin `tools/list` qaytaradi
Autentifikatsiya	Texnik tavsiflari `securityScheme` → seyf	Vault → server uchun env
Kod talab qilinadi	Hech biri	Hech biri

Qachon qaysisini ishlatish kerak

Yetib olish OpenAPI xizmat allaqachon OpenAPI hujjatini e’lon qilganda — siz uning to’liq ishlash to’plamini vositalar sifatida avtomatik ravishda olasiz.
Yetib olish MCP mavjud MCP serveriga ulanishni xohlaganingizda, yoki birini ishga tushirish mahalliy vosita serveri stdio orqali.

[!TIP] Ikkala manba turi ham bir xil bitta fayl tomonidan aniqlanadi manifest.json har bir sifatida boshqa plagin — qarang Plagin SDK uchun openapi va mcp turlari va aihummer plugin validate.

Keyingi qayerga

Plagin SDK — maydonlarni namoyish etish uchun openapi va mcp.
Bozorning umumiy ko‘rinishi va darajalari — qayerda zero-kod (3-daraja) o‘tiradi.
Shaxsiy va umumiy ma’lumotlar — qanday Ushbu asboblar ishlatadigan saqlash sirlarining doirasi aniqlangan.