AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
Marketplace və plaginlər/Kodsuz inteqrasiyalar

Kodsuz inteqrasiyalar

v1.0.x · yeniləndi 2026-06-26

Tier-3 plaginləri kodsuzdur: mövcud xidməti agentlər üçün heç bir inteqrasiya kodu yazmadan və ya yerləşdirmədən əlçatan edirsiniz. İki mənbə tipi var — OpenAPI və MCP — və hər ikisi secret-lərini açıq konfiqurasiyadan deyil, şifrələnmiş vault-dan həll edir.

OpenAPI: hər əməliyyat üçün bir alət

AiHummer-i spec_url-i vasitəsilə istənilən OpenAPI 3.x spesifikasiyasına işarə edin və platforma spesifikasiyada hər əməliyyat üçün bir alət sintez edir. Hər əməliyyat agentin funksiya çağırışı növbəsi zamanı istifadə edə biləcəyi çağırıla bilən alətə çevrilir — yapışdırıcı kod yoxdur, hər endpoint üçün ayrıca qoşulma yoxdur.

{
  "slug": "acme-api",
  "name": "Acme API",
  "version": "1.0.0",
  "kind": "openapi",
  "spec_url": "https://api.acme.example/openapi.json"
}

Spesifikasiyanın securityScheme-i ilə autentifikasiya

Autentifikasiya birbaşa spesifikasiyadan götürülür. AiHummer OpenAPI securityScheme-ni oxuyur və faktiki secret çağırış zamanı vault-dan çəkilir — beləliklə etibarnamə heç vaxt manifestə, prompt-a və ya log-lara daxil edilmir.

[!NOTE] Sintez edilmiş alətlər spesifikasiyanın öz əməliyyatlarını və təhlükəsizliyini izləyir. OpenAPI sənədinizi dəqiq saxlayın: onun bəyan etdiyi əməliyyatlar agentin görəcəyi dəqiq alətlərdir.

Hazır şəxsi inteqrasiyalar (istifadəçi başına OAuth)

Bu eyni OpenAPI mexanizmi geniş bir hazır şəxsi inteqrasiyalar dəstini dəstəkləyir: hər biri bir şəxsin öz hesabına qoşduğu istifadəçi başına OAuth inteqrasiyasıdır, ondan sonra alətlər onun adından hərəkət edir. Artıq mövcud olanlar: 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 və daha çox. Şəxsi hesabın qoşulması burada izah olunur: istifadəçi başına Qoşulmalar.

MCP: istənilən serveri qoşun

İkinci mənbə tipi istənilən MCP serverini qoşur. AiHummer onunla stdio və ya http transport üzərindən danışır, onun tools/list-ini çağırır və qaytarılan alətləri agentə açır. OpenAPI-də olduğu kimi, bu da inteqrasiya kodu tələb etmir.

{
  "slug": "acme-mcp",
  "name": "Acme MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "http",
  "url": "https://mcp.acme.example/"
}

stdio-transport server URL əvəzinə onu başladan əmrlə konfiqurasiya edilir:

{
  "slug": "local-mcp",
  "name": "Local MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "stdio",
  "command": "my-mcp-server"
}

Secret-lər vault → env vasitəsilə

MCP serverləri üçün secret-lər vault-dan serverin işlədiyi mühitə axır. Secret-i vault-da bir dəfə saxlayırsınız; AiHummer serveri başladarkən və ya ona qoşularkən onu mühit dəyişəni kimi inyeksiya edir, beləliklə secret material manifestdən və model kontekstindən kənarda qalır.

OpenAPI vs MCP bir baxışda

OpenAPI MCP
Giriş OpenAPI 3.x spec_url MCP serveri (stdio və ya http)
İstehsal edilən alətlər Spesifikasiyada hər əməliyyat üçün bir tools/list nə qaytarırsa
Autentifikasiya Spesifikasiyanın securityScheme-i → vault Server üçün vault → env
Tələb olunan kod Yoxdur Yoxdur

Hansını nə vaxt istifadə etməli

  • Xidmət artıq OpenAPI sənədi dərc edirsə OpenAPI-yə müraciət edin — onun tam əməliyyat dəstini avtomatik olaraq alət kimi alırsınız.
  • Mövcud MCP serverini qoşmaq və ya stdio üzərindən lokal alət serveri işə salmaq istəyirsinizsə MCP-yə müraciət edin.

[!TIP] Hər iki mənbə tipi hər digər plagin kimi eyni birfayllı manifest.json ilə müəyyən edilir — openapi və mcp növləri və aihummer plugin validate üçün baxın: Plagin SDK.

Sonra haraya