AiHummer
Lietuvių▾
PrisijungtiPaskyra
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Turgavietė ir įskiepiai/Integracijos be kodo

Integracijos be kodo

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

Trečiojo lygio papildiniai yra be kodo: jūs suteikiate esamą paslaugą agentams be jokio integracijos kodo rašymo ar diegimo. Yra du šaltinių tipai — OpenAPI ir MCP — ir abu gauna savo paslaptis iš užšifruoto saugyklos, o ne iš aiškiai pateiktos konfigūracijos.

OpenAPI: vienas įrankis vienai operacijai

Nukreipkite AiHummer į bet ką OpenAPI 3.x spec per jo spec_url ir platforma sintetizuoja vieną įrankį kiekvienai operacijai specifikacijoje. Kiekviena operacija tampa kviečiamu įrankiu, kurį agentas gali naudoti funkcijos kvietimo metu — jokio papildomo kodo, jokio kiekvieno galinio taško sujungimo.

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

Manifestas nepateikia įskiepio šliuzo ar pavadinimo — jie gaunami iš katalogo/pakuotės diegimo metu (žr. Įskiepio SDK).

Autentifikacija pagal specifikacijos saugumo schemą

Autentifikacija paimta tiesiogiai iš specifikacijos. AiHummer skaito OpenAPI securityScheme, o tikroji paslaptis paimama iš seifas kvietimo metu – todėl kredencialai niekada nėra įterpiami į manifestą, raginimą ar žurnalus.

[!NOTE] Sintetizuoti įrankiai vykdo paties specifikacijos veiksmus ir saugumą. Laikykite savo OpenAPI dokumentas yra tikslus: operacijos, kurias jis deklaruoja, yra tiksliai tos priemonės, kurias agentas pamatys.

Paruošti asmeniniai integravimai (OAuth kiekvienam vartotojui)

Šis pats OpenAPI mechanizmas palaiko didelį rinkinį paruoštų asmeninės integracijos: kiekvienas yra vartotojui skirtas OAuth integravimas, kurį asmuo prijungia prie savo paskyros, po kurio įrankiai veikia jo vardu. Jau prieinami 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 ir kiti. Kaip prijungti asmeninę paskyrą aptariama jungtys pagal naudotoją.

MCP: prijungti bet kurį serverį

Antrasis šaltinio tipas jungia bet kurį MCP serveris. AiHummer kalbasi su juo per stdio arba http transportas, vadina savo tools/list, ir pateikia agentui grąžintus įrankius. Kaip ir su OpenAPI, tam nereikia jokio integracijos kodo.

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

Stdio-transporto serveris yra sukonfigūruojamas komandą, kuri jį paleidžia, o ne URL:

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

Paslaptys per seifą → aplinka

MCP serveriams, paslaptys teka iš saugyklos į aplinką serveris veikia su. Jūs saugote paslaptį vieną kartą seife; AiHummer įterpia ją kaip aplinkos kintamąjį paleidžiant arba jungiantis prie serverio, todėl paslapties medžiaga lieka ne manifestuose ir ne modelio kontekste.

OpenAPI prieš MCP žvilgsniu

OpenAPI MCP
Įvestis Atviro API 3.x spec_url MCP serveris (stdio arba http)
Pagaminti įrankiai Vienas kiekvienoje operacijoje specifikacijoje Bet kas tools/list grąžina
Autentifikacija Specifikacija securityScheme → seifas Vault → aplinka serveriui
Reikalingas kodas Nėra Nėra

Kada naudoti kurį

  • Siekti OpenAPI kai paslauga jau paskelbia OpenAPI dokumentą — jūs automatiškai gaunate visą jo veikimo įrankių rinkinį.
  • Siekti MCP kai norite prisijungti prie esamo MCP serverio arba paleisti vietinis įrankių serveris per stdio.

[!TIP] Abi šaltinio rūšys apibrėžtos tuo pačiu vieno failo manifest.json kažkas kiekvienas kitas įskiepis — žr. Įskiepio SDK už openapi ir mcp rūšys ir aihummer plugin validate.

Kur toliau