უკოდო ინტეგრაციები — AiHummer დოკუმენტაცია

Tier-3 პლაგინები უკოდოა: არსებულ სერვისს აგენტებისთვის ხელმისაწვდომს ხდით ისე, რომ არც ინტეგრაციის კოდს წერთ და არც განათავსებთ. არსებობს ორი წყაროს ტიპი — OpenAPI და MCP — და ორივე გადაჭრის თავის საიდუმლოებს დაშიფრული vault-იდან და არა ღია კონფიგურაციიდან.

OpenAPI: თითო ხელსაწყო თითო ოპერაციაზე

მიუთითეთ AiHummer ნებისმიერ OpenAPI 3.x სპეციფიკაციაზე მისი spec_url-ით და პლატფორმა ააგებს თითო ხელსაწყოს თითო ოპერაციაზე სპეციფიკაციაში. თითოეული ოპერაცია ხდება გამოძახებადი ხელსაწყო, რომელიც აგენტს შეუძლია გამოიყენოს function-calling მსვლელობისას — წებო-კოდის გარეშე, თითო ბოლოწერტილზე შეერთების გარეშე.

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

ავთენტიფიკაცია სპეციფიკაციის securityScheme-ით

ავთენტიფიკაცია აღებულია პირდაპირ სპეციფიკაციიდან. AiHummer კითხულობს OpenAPI securityScheme-ს, ხოლო ფაქტობრივი საიდუმლო ამოღებულია vault-იდან გამოძახების დროს — ასე რომ სერთიფიკატი არასოდეს ჩაიდება მანიფესტში, prompt-ში ან ლოგებში.

[!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 და სხვა. პირადი ანგარიშის დაკავშირება აღწერილია გვერდზე თითო მომხმარებლის Connections.

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-იდან გარემოში, რომელშიც სერვერი მუშაობს. საიდუმლოს ერთხელ ინახავთ vault-ში; AiHummer მას შეჰყავს როგორც გარემოს ცვლადს სერვერის გაშვებისას ან მასთან დაკავშირებისას, ასე რომ საიდუმლო მასალა რჩება მანიფესტის გარეთ და მოდელის კონტექსტის გარეთ.

OpenAPI წინააღმდეგ MCP ერთი შეხედვით

	OpenAPI	MCP
შესვლა	OpenAPI 3.x `spec_url`	MCP სერვერი (stdio ან http)
შექმნილი ხელსაწყოები	თითო ოპერაციაზე სპეციფიკაციაში	რასაც `tools/list` დააბრუნებს
ავთენტიფიკაცია	სპეციფიკაციის `securityScheme` → vault	Vault → env სერვერისთვის
საჭირო კოდი	არ არის	არ არის

როდის რომელი გამოვიყენოთ

მიმართეთ OpenAPI-ს, როცა სერვისს უკვე გამოქვეყნებული აქვს OpenAPI დოკუმენტი — ავტომატურად მიიღებთ მის სრულ ოპერაციათა ნაკრებს როგორც ხელსაწყოებს.
მიმართეთ MCP-ს, როცა გსურთ არსებული MCP სერვერის დაკავშირება, ან ლოკალური ხელსაწყოს სერვერის გაშვება stdio-ით.

[!TIP] ორივე წყაროს ტიპი განსაზღვრულია იმავე ერთ-ფაილიანი manifest.json-ით, რითაც ყველა სხვა პლაგინი — იხილეთ Plugin SDK openapi და mcp სახეობებისა და aihummer plugin validate-ისთვის.

სად შემდეგ

Plugin SDK — მანიფესტის ველები openapi და mcp-ისთვის.
Marketplace-ის მიმოხილვა და დონეები — სად ზის უკოდო (Tier 3).
პირადი წინააღმდეგ საზიარო სერთიფიკატებისა — როგორ არის სამოქმედო არეალში მოქცეული vault-ის საიდუმლოები, რომელსაც ეს ხელსაწყოები იყენებენ.