AiHummer
Eesti▾
SisselogimineKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Turg ja lisandmoodulid/Nullkoodiga integratsioonid

Nullkoodiga integratsioonid

v1.2.x · uuendatud 2026-07-05

Tippklassi 3 pistikprogrammid on nullkood: te teete olemasoleva teenuse agendile kättesaadavaks, ilma et kirjutaksite või juurutaksite ühtegi integratsioonikoodi. On kaks allika tüüpi — OpenAPI ja MCP — ja mõlemad lahendavad oma saladused krüpteeritud koopast, mitte selgesõnalisest konfiguratsioonist.

OpenAPI: üks tööriist iga toimingu jaoks

Suuna AiHummer suvalisse OpenAPI 3.x spets läbi selle spec_url ja platvorm sünteesib iga töötluse jaoks ühe tööriista spetsifikatsioonis. Iga toiming muutub kutsutavaks tööriistaks, mida agent saab kasutada funktsiooni kutsumise vooru ajal — ei mingit liimkoodi, ei mingit iga lõpp-punkti ühendamist.

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

Manifest ei kanna plugina lühinime ega nime — need tulevad kataloogist/paketist installimisel (vt Plugina SDK).

Autentimine vastavalt spetsifikatsiooni turvaskeemile

Autentimine on võetud otse spetsifikatsioonist. AiHummer loeb OpenAPI-d securityScheme, ja tegelik saladus võetakse vangla kõne ajal — nii et volikirja ei lisata kunagi otse manifesti, viipale ega logidesse.

[!NOTE] Sünteesitud tööriistad järgivad spetsifikatsiooni enda toiminguid ja turvalisust. Hoidke oma OpenAPI dokument täpne: toimingud, mida see deklareerib, on täpselt tööriistad, mida agent näeb.

Valmis isiklikud integratsioonid (kasutaja kohta OAuth)

Sama OpenAPI mehhanism toetab suurt hulka valmis isiklikud integratsioonid: igaüks on üksikkasutaja OAuth integratsioon, mille inimene ühendab oma kontoga, pärast mida tööriistad toimivad tema nimel. Juba on saadaval 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 ja palju muud. Isikliku konto ühendamine on käsitletud kasutaja kohta ühendused.

MCP: ühenda suvalise serveriga

Teine allikatüüp ühendab kõike MCP server. AiHummer räägib sellega üle stdio või http transport, kutsub oma tools/list, ja teeb tagastatud tööriistad agendile kättesaadavaks. Nagu OpenAPI puhul, ei vaja see integratsioonikoodi.

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

stdio-ülekande serverit seadistatakse käsuga, mis selle käivitab, mitte URL-iga:

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

Saladused kaudu vangla → keskkond

MCP serverite jaoks voolavad saladused hoidlast keskkonda server jookseb koos sellega. Salvestate saladuse korra varakambri; AiHummer süstib selle keskkonnamuutujana serveri käivitamisel või sellega ühenduse loomisel, nii et salajane materjal jääb manifestist ja mudeli kontekstist välja.

OpenAPI vs MCP pilguheit

OpenAPI MCP
Sisend Avatud API 3.x spec_url MCP server (stdio või http)
Vahendid toodetud Üks operatsiooni kohta spetsifikatsioonis Mis iganes tools/list tagastab
Autentimine Spetsi securityScheme → pank Vault → serveri keskkond
Kood on nõutav Ükski Ükski

Millal kasutada millist

  • Ulatu OpenAPI kui teenus juba avaldab OpenAPI dokumenti — sa saad selle täieliku toimingute komplekti tööriistadena automaatselt.
  • Ulatu MCP kui soovite ühendada olemasoleva MCP-serveri või käivitada kohalik tööriistaserver üle stdio.

[!TIP] Mõlemad allikatüübid määratletakse samas manifest.json failis nagu iga teinegi plugin — vaata Plugina SDK-d, et kasutada openapi ja mcp liike ning käsku aihummer plugin validate.

Kuhu järgmine