AiHummer
Қазақша▾
КіруЖеке кабинет
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплейс және плагиндер/Кодсыз интеграциялар

Кодсыз интеграциялар

v1.2.x · жаңартылды 2026-07-05

Үшінші деңгейдегі плагиндер нөл-код: сіз бар қызметті агенттерге кез келген интеграция кодын жазбай немесе орналастirmей қолжетімді етесіз. Екі негізгі дереккөз түрі бар — OpenAPI және MCP — және екеуі де құпияларын ашық конфигурациядан емес, шифрланған сақтаудан шешеді.

OpenAPI: әр операцияға бір құрал

AiHummer-ді кез келген жерге бағыттаңыз OpenAPI 3.x оның арқылы спецификация spec_url және платформа әр операция үшін бір құрал синтездейді спецификацияда. Әр операция агент функция шақыру кезеңінде пайдалана алатын шақыруға болатын құралға айналады — қосымша код қажет емес, әрбір соңғы нүктеге қосу қажет емес.

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

Манифест плагиннің слаги немесе атын қамтымайды — олар орнату кезінде каталог/бандлдан келеді (қараңыз Плагин SDK).

Спектрлік securityScheme арқылы аутентификация

Аутентификация спецификациядан тікелей алынады. AiHummer OpenAPI оқиды securityScheme, және нақты құпия алынады қойма қоңырау кезінде — сондықтан құжаттамаға, сұрау терезесіне немесе журналдарға дәлелді деректер ешқашан енгізілмейді.

[!NOTE] Синтезделген құралдар спецификацияның өз операциялары мен қауіпсіздігін ұстанады. Сақтаңыз OpenAPI құжаты дәлірек: ол жариялаған операциялар дәл сол құралдар болып табылады агент көретін болады.

Дайын жеке интеграциялар (пайдаланушы сайын OAuth)

Дәл осы OpenAPI механизмі дайындалған үлкен жиынтығын қолдайды жеке интеграциялар: әрқайсысы пайдаланушының өз есептік жазбасына қосатын әрпайдаланушыға арналған OAuth интеграциясы, одан кейін құралдар олардың атынан әрекет етеді. Қол жетімді құралдарға 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 және тағы басқалары жатады. Жеке есептік жазбаны қосу мына жерде қарастырылған пайдаланушыға арналған қосылыстар.

MCP: кез келген серверге қосылу

Екінші көз түрі кез келген нәрсені қосады MCP сервері. AiHummer оған сөйлеседі stdio немесе http тасымалдау, оны атайды tools/list, және қайтарылған құралдарды агентке ашады. OpenAPI-дегі сияқты, бұл үшін ешқандай интеграциялық код қажет емес.

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

stdio-transport сервері оны іске қосатын пәрменмен URL орнына бапталады:

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

Құпиялар қойма арқылы → қоршаған орта

MCP серверлері үшін құпиялар ағады қоймадан қоршаған ортаға сервер осы арқылы жұмыс істейді. Құпияны бір рет қазынада сақтайсыз; AiHummer оны серверді іске қосқанда немесе оған қосылғанда қоршаған орта айнымалысы ретінде енгізеді, сол арқылы құпия материал манифестте және модель контекстінде болмайды.

OpenAPI мен MCP-ні бір қарап түсіну

OpenAPI MCP
Кіріс OpenAPI 3.x spec_url MCP сервері (stdio немесе http)
Өндірілген құралдар Спецификациядағы әр операцияға біреу Кез келген tools/list қайтарады
Кіру Спектің securityScheme → қазына Vault → сервер үшін ortа
Код қажет Жоқ Жоқ

Қашан қайсын қолдану керек

  • жету OpenAPI қызмет OpenAPI құжатын жариялаған кезде — сіз оған толық операциялар жиынтығын құралдар ретінде автоматты түрде аласыз.
  • жету MCP бар MCP серверіне қосылғыңыз келгенде немесе іске қосқанда stdio арқылы жергілікті құрал сервері.

[!TIP] Екі бастапқы түрлер бір файлмен анықталады manifest.json әрбір ретінде басқа плагин — қараңыз Плагин SDK үшін openapi және mcp түрлері және aihummer plugin validate.

Келесі қайда