AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Маркетплейс ва плагинҳо/Интегратсияҳои бе код

Интегратсияҳои бе код

v1.0.x · навсозӣ шуд 2026-06-26

Плагинҳои Tier-3 бе код мебошанд: шумо як хидмати мавҷударо барои агентҳо дастрас мекунед, бе навиштан ё ҷойгиркунии ягон коди интегратсия. Ду навъи манбаъ вуҷуд дорад — OpenAPI ва MCP — ва ҳарду махфиятҳои худро аз ҳазинаи (vault) рамзгузоришуда мегиранд, на аз конфигуратсия дар намуди кушод.

OpenAPI: як абзор барои ҳар амалиёт

AiHummer-ро ба ҳар спетсификатсияи OpenAPI 3.x тавассути spec_url-и он равона кунед ва платформа барои ҳар амалиёт як абзор месозад дар спетсификатсия. Ҳар амалиёт ба як абзори даъватшаванда табдил меёбад, ки агент метавонад дар як даври даъвати функсияҳо истифода барад — бе коди пайвасткунанда, бе симкашии ҳар нуқтаи интиҳоӣ.

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

Аутентификатсия тавассути securityScheme-и спетсификатсия

Аутентификатсия мустақиман аз спетсификатсия гирифта мешавад. AiHummer securityScheme-и OpenAPI-ро мехонад ва махфияти воқеӣ аз ҳазина (vault) ҳангоми даъват кашида мешавад — бинобар ин маълумоти эътимоднома ҳаргиз ба манифест, дархост ё қайдҳо (logs) дохил карда намешавад.

[!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, ин ба ягон коди интегратсия эҳтиёҷ надорад.

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

Сервери дорои нақлиёти stdio ба ҷои URL тавассути фармоне, ки онро оғоз мекунад, танзим карда мешавад:

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

Махфиятҳо тавассути vault → env

Барои серверҳои MCP, махфиятҳо аз ҳазина (vault) ба муҳите ҷорӣ мешаванд, ки сервер бо он кор мекунад. Шумо махфиятро як бор дар ҳазина нигоҳ медоред; AiHummer онро ҳамчун тағйирёбандаи муҳит ҳангоми оғоз ё пайвастшавӣ ба сервер ворид мекунад, бинобар ин маводи махфӣ берун аз манифест ва берун аз контексти модел мемонад.

OpenAPI бар зидди MCP дар як назар

OpenAPI MCP
Вуруд Як spec_url-и OpenAPI 3.x Як сервери MCP (stdio ё http)
Абзорҳои сохташуда Якто барои ҳар амалиёт дар спетсификатсия Ҳар чизе, ки tools/list бармегардонад
Аутентификатсия securityScheme-и спетсификатсия → vault Vault → env барои сервер
Коди лозимӣ Нест Нест

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

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

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

Минбаъд ба куҷо