AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплейс ва плагинҳо/Интегратсияҳои бе рамз

Интегратсияҳои бе рамз

v1.2.x · навсозӣ шуд 2026-07-05

Плагинҳои Сатҳ-3 мебошанд бе-рамзшумо хидмати мавҷударо ба агентиҳо дастрас мекунед бе он ки код ё ҳамгироиро нависед ё ба кор андохта равед. Ду намуди манбаъ вуҷуд дорад — 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 → муҳити сервер
Код лозим аст Ҳеҷ Ҳеҷ

Кай кадомро истифода бурдан

  • Расидан ба OpenAPI вақте ки хизматрасонӣ ҳуҷҷати OpenAPI-ро нашр мекунад — Шумо маҷмӯи пурраи амалиётии онро ҳамчун асбобҳо ба таври автоматикӣ мегиред.
  • Расидан ба MCP вақте ки мехоҳед сервери мавҷудаи MCP-ро пайваст кунед, ё иҷро кунед сервери асбоби маҳаллӣ тавассути stdio.

[!TIP] Ҳар ду намуди манбаъҳо аз як файли ягона таъриф шудаанд manifest.json монанди ҳар як плагини дигар — бинед SDK-и васлкунӣ барои openapi ва mcp навъҳо ва aihummer plugin validate.

Баъд ба куҷо