AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marketplace və plaginlər/Sıfır-kod inteqrasiyaları

Sıfır-kod inteqrasiyaları

v1.1.x · yeniləndi 2026-07-05

Tier-3 əlavələri sıfır-kod: siz hər hansı bir inteqrasiya kodu yazmadan və ya yerləşdirmədən mövcud xidməti agentlərin istifadəsinə təqdim edirsiniz. İki mənbə növü var — OpenAPI və MCP — və hər ikisi konfiqurasiyadan açıq şəkildə deyil, şifrəli seyfdən sirlərin həllini tapırlar.

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

AiHummer-i istənilən yerə yönəldin OpenAPI 3.x spez öz vasitəsilə spec_url və platforma hər əməliyyat üçün bir alət sintezləşdirir spesifikasiyada. Hər bir əməliyyat agentin funksiya çağırışı zamanı istifadə edə biləcəyi çağırıla bilən bir alətə çevrilir — əlavə kod yoxdur, hər uç nöqtəyə ayrıca qoşulma yoxdur.

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

Manifest plaginin slugunu və ya adını daşımır — onlar quraşdırma zamanı kataloqdan/komplektdən gəlir (bax Plugin SDK).

Spesifikasiyanın securityScheme vasitəsilə avtorizasiya

Doğrulama birbaşa spesifikasiyadan götürülür. AiHummer OpenAPI-ni oxuyur securityScheme, və əsl sır onun içərisindən çəkilir dəyişməz otaq çağırış zamanı — beləliklə, etimadnamə heç vaxt manifestə, istemə pəncərəsinə və ya jurnallara daxil edilmir.

[!NOTE] Sintez edilmiş alətlər spesifikasiyanın öz əməliyyatlarına və təhlükəsizliyinə əməl edir. Saxlayın OpenAPI sənədi dəqiqdir: elan etdiyi əməliyyatlar tam olaraq alətlərdir agent görəcək.

Hazır şəxsi inteqrasiyalar (hər istifadəçi üçün OAuth)

Eyni OpenAPI mexanizmi geniş hazırlanmış bir sıra dəstəkləyir şəxsi inteqrasiyalar: hər biri istifadəçinin öz hesabına qoşduğu per-İstifadəçi OAuth inteqrasiyasıdır, bundan sonra alətlər onun adından fəaliyyət göstərir. Artıq mövcud olanlar Gmail, Google Təqvim, Google Kontaktlar, Google Tapşırıqlar, Google Drive, YouTube, Outlook Mail, Outlook Təqvim, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings və daha çoxdur. Şəxsi hesabın qoşulması burada əhatə olunur istifadəçi başına bağlantılar.

MCP: hər hansı serverə qoşul

İkinci mənbə növü hər hansı birini birləşdirir MCP server. AiHummer bununla əlaqə saxlayır stdio və ya http nəqli, deyir onun tools/list, və geri qaytarılmış alətləri agentə təqdim edir. OpenAPI kimi, bunun heç bir inteqrasiya koduna ehtiyacı yoxdur.

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

Stdio-daşıma serveri onu işə salan əmr ilə, URL əvəzinə konfiqurasiya olunur:

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

Gizli məlumatlar ehtiyat → mühit

MCP serverləri üçün, sirlər axır kassadan ətrafa server ilə işləyir. Sirri bir dəfə anbara saxlayırsınız; AiHummer serveri işə saldıqda və ya ona qoşulduqda bunu mühit dəyişəni kimi vurur, beləliklə sirr materialı manifestdən və model kontekstindən kənarda qalır.

OpenAPI və MCP-ə bir baxış

OpenAPI MCP
Giriş OpenAPI 3.x spec_url Bir MCP serveri (stdio və ya http)
İstehsal olunmuş alətlər Spesifikasiyada əməliyyat başına biri Nəyisə tools/list qaytarır
Avt Texniki şərtlər securityScheme → kassa Vault → server üçün env
Kod tələb olunur Heç biri Heç biri

Hansı vaxt hansını istifadə etmək

  • Əl uzatmaq OpenAPI xidmət artıq OpenAPI sənədi yayımladıqda — siz onun bütün əməliyyat dəstini avtomatik olaraq alırsınız.
  • Əl uzatmaq MCP mövcud MCP serverinə qoşulmaq istədiyiniz zaman və ya işlətmək istədiyiniz zaman stdio üzərindən yerli alət serveri.

[!TIP] Hər iki mənbə növü eyni bir fayl tərəfindən müəyyən edilir manifest.json hər kimi digər plugin — bax Plugin SDK üçün openapi və mcp növlər və aihummer plugin validate.

Növbəti haradır