Zero-code ինտեգրացիաներ
Tier-3 փլագինները zero-code են. դուք առկա ծառայությունը հասանելի եք դարձնում agent-ներին՝ առանց որևէ ինտեգրացիայի կոդ գրելու կամ տեղակայելու։ Կան երկու աղբյուրի տիպ — OpenAPI և MCP — և երկուսն էլ իրենց secret-երը լուծում են ծածկագրված vault-ից, այլ ոչ թե բաց տեքստով կարգավորումից։
OpenAPI. մեկ գործիք յուրաքանչյուր operation-ի համար
Ուղղորդեք AiHummer-ին ցանկացած OpenAPI 3.x spec-ի վրա իր spec_url-ի միջոցով, և հարթակը
սինթեզում է մեկ գործիք յուրաքանչյուր operation-ի համար spec-ում։ Յուրաքանչյուր operation դառնում է
կանչելի գործիք, որ agent-ը կարող է օգտագործել function-calling turn-ի ընթացքում — առանց glue կոդի,
առանց յուրաքանչյուր endpoint-ի համար միացման։
{
"slug": "acme-api",
"name": "Acme API",
"version": "1.0.0",
"kind": "openapi",
"spec_url": "https://api.acme.example/openapi.json"
}
Auth spec-ի securityScheme-ի միջոցով
Նույնականացումը վերցվում է ուղիղ spec-ից։ AiHummer-ը կարդում է OpenAPI
securityScheme-ը, և բուն secret-ը քաշվում է vault-ից կանչի
ժամանակ — այնպես որ հավատարմագիրը երբեք չի inline-վում manifest-ի, prompt-ի կամ
log-երի մեջ։
[!NOTE] Սինթեզված գործիքները հետևում են spec-ի սեփական operation-ներին և անվտանգությանը։ Պահեք ձեր OpenAPI փաստաթուղթը ճշգրիտ. operation-ները, որ այն հայտարարում է, հենց այն գործիքներն են, որ agent-ը կտեսնի։
Պատրաստի անձնական ինտեգրացիաներ (օգտատերերով 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 և այլն։ Անձնական հաշիվ միացնելը նկարագրված է օգտատերերով Connections էջում։
MCP. միացրեք ցանկացած սերվեր
Երկրորդ աղբյուրի տիպը միացնում է ցանկացած MCP սերվեր։ AiHummer-ը նրա հետ խոսում է
stdio կամ http transport-ով, կանչում նրա tools/list-ը, և բացահայտում վերադարձված
գործիքները agent-ին։ Ինչպես OpenAPI-ի դեպքում, սա ինտեգրացիայի կոդ չի պահանջում։
{
"slug": "acme-mcp",
"name": "Acme MCP",
"version": "1.0.0",
"kind": "mcp",
"transport": "http",
"url": "https://mcp.acme.example/"
}
stdio-transport սերվերը կարգավորվում է իրեն գործարկող հրամանով՝ URL-ի փոխարեն.
{
"slug": "local-mcp",
"name": "Local MCP",
"version": "1.0.0",
"kind": "mcp",
"transport": "stdio",
"command": "my-mcp-server"
}
Secret-ներ vault → env-ի միջոցով
MCP սերվերների համար secret-երը հոսում են vault-ից այն environment-ի մեջ, որով սերվերն աշխատում է։ Դուք secret-ը մեկ անգամ պահում եք vault-ում. AiHummer-ը այն ներարկում է որպես environment փոփոխական սերվերը գործարկելու կամ նրան միանալու ժամանակ, այնպես որ secret նյութը մնում է manifest-ից և մոդելի կոնտեքստից դուրս։
OpenAPI ընդդեմ MCP հպանցիկ
| OpenAPI | MCP | |
|---|---|---|
| Մուտք | OpenAPI 3.x spec_url |
MCP սերվեր (stdio կամ http) |
| Արտադրվող գործիքներ | Մեկը՝ spec-ի յուրաքանչյուր operation-ի համար | Ինչ որ tools/list-ը վերադարձնում է |
| Auth | Spec-ի securityScheme → vault |
Vault → env սերվերի համար |
| Պահանջվող կոդ | Չկա | Չկա |
Երբ որն օգտագործել
- Դիմեք OpenAPI-ին, երբ ծառայությունն արդեն հրապարակում է OpenAPI փաստաթուղթ — դուք ստանում եք նրա operation-ների ամբողջ հավաքածուն որպես գործիքներ ավտոմատ կերպով։
- Դիմեք MCP-ին, երբ ուզում եք միացնել առկա MCP սերվեր կամ աշխատեցնել լոկալ գործիքների սերվեր stdio-ով։
[!TIP] Երկու աղբյուրի տիպերն էլ սահմանվում են նույն մեկ-ֆայլանի
manifest.json-ով, ինչ յուրաքանչյուր այլ փլագին — տես Փլագինի SDK՝openapiևmcpkind-երի ևaihummer plugin validate-ի համար։
Ո՞ւր հաջորդիվ
- Փլագինի SDK — manifest-ի դաշտերը
openapiևmcp-ի համար։ - Marketplace-ի ակնարկ և մակարդակներ — որտեղ է գտնվում zero-code-ը (Tier 3)։
- Անձնական ընդդեմ համատեղ հավատարմագրեր — ինչպես են սահմանազատվում vault-ի secret-երը, որոնք օգտագործում են այս գործիքները։