AiHummer
Română▾
AutentificareCont personal
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marketplace și pluginuri/Integrări fără cod

Integrări fără cod

v1.0.x · actualizat 2026-07-05

Pluginurile de nivel 3 sunt fără cod: faci un serviciu existent disponibil pentru agenți fără a scrie sau a implementa vreun cod de integrare. Există două tipuri de surse — OpenAPI și MCP — și ambele își rezolvă secretele din seiful criptat, mai degrabă decât din configurația clară.

OpenAPI: un instrument pentru fiecare operațiune

Îndreaptă AiHummer către orice OpenAPI 3.x spec prin intermediul său spec_url și platforma sintezează un instrument per operațiune în specificație. Fiecare operațiune devine un instrument apelabil pe care agentul îl poate folosi în timpul unui tur de apelare a funcției — fără cod de lipire, fără conectare per endpoint.

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

Manifestul nu poartă slug-ul sau numele pluginului — acestea provin din catalog/pachet la momentul instalării (vezi SDK pentru plugin).

Autentificare prin securityScheme-ul specificației

Autentificarea este preluată direct din specificație. AiHummer citește OpenAPI. securityScheme, iar secretul real este extras din seif la momentul apelului — astfel încât acreditivul să nu fie niciodată inclus direct în manifest, în prompt sau în jurnale.

[!NOTE] Instrumentele sintetizate urmează propriile operațiuni și securitate ale specificației. Păstrează-ți Document OpenAPI exact: operațiunile pe care le declară sunt exact instrumentele pe care agentul va vedea.

Integrări personale gata făcute (OAuth pentru fiecare utilizator)

Același mecanism OpenAPI susține un set mare de soluții gata făcute integrări personale: fiecare este o integrare OAuth per utilizator pe care o persoană o conectează la propriul cont, după care uneltele acționează în numele lor. Sunt deja disponibile 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 și altele. Conectarea unui cont personal este acoperită în Conexiuni per utilizator.

MCP: conectează orice server

Al doilea tip de sursă conectează orice server MCP. AiHummer vorbește cu el peste o transport stdio sau http, îi spune tools/list, și expune instrumentele returnate agentului. La fel ca în cazul OpenAPI, acest lucru nu necesită cod de integrare.

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

Un server de transport stdio este configurat prin comanda care îl lansează, în loc printr-un URL:

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

Secrete prin seif → env

Pentru serverele MCP, secretele circulă din seif în mediu serverul rulează cu. Salvezi secretul o dată în seif; AiHummer îl injectează ca o variabilă de mediu atunci când pornește sau se conectează la server, astfel încât materialul secret rămâne în afara manifestului și în afara contextului modelului.

OpenAPI vs MCP într-o privire

OpenAPI MCP
Intrare Un OpenAPI 3.x spec_url Un server MCP (stdio sau http)
Unelte produse Unul per operație în specificație Oricare tools/list returnează
Autentificare Specificația securityScheme → seif Vault → env pentru server
Cod necesar Nimic Nimic

Când să folosești care

  • Întinde-te după OpenAPI când serviciul publică deja un document OpenAPI — primești setul său complet de operațiuni ca unelte automat.
  • Întinde-te după MCP când doriți să vă conectați la un server MCP existent sau să rulați un server de instrument local peste stdio.

[!TIP] Ambele tipuri de sursă sunt definite de același fișier manifest.json ca fiecare alt plugin — vezi SDK pentru plugin pentru openapi și mcp tipuri și aihummer plugin validate.

Unde următor?