კოდის გარეშე ინტეგრაციები

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

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

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

მესამე დონესის პლაგინები **კოდის გარეშე**: თქვენ გიხსნით არსებული სერვისის ხელმისაწვდომობას აგენტებისთვის ინტეგრაციის კოდის ჩაწერის ან განთავსების გარეშე. არსებობს ორ ტიპის წყარო — **OpenAPI** და **MCP** — და ორივე იღებს თავის საიდუმლო ინფორმაციას დაშიფრულ საცავში, არა კი ღია კონფიგურაციიდან. ## OpenAPI: ერთი ინსტრუმენტი თითო ოპერაციისთვის გაააქტიურეთ AiHummer ნებისმიერ მიმართულებაზე **OpenAPI 3.x** სპეციფიკაცია მისი საშუალებით `spec_url` და პლატფორმა **სინიეთეზირებს ერთ ხელსაწყოს ერთ ოპერაციაზე** სპეციფიკაციაში. თითოეული ოპერაცია ხდება გამოძახებადი ინსტრუმენტი, რომლის გამოყენებაც აგენტს შეუძლია ფუნქციის გამოძახების დროს — დამატებითი კოდის გარეშე, თითოეულ წერტილთან კავშირის გარეშე. ```json { "version": "1.0.0", "kind": "openapi", "scope": "shared", "openapi": { "spec_url": "https://api.acme.example/openapi.json" } } ``` მანიფესტში არ არის მითითებული პლაგინის იდენტიფიკატორი ან სახელი — ისინი აღებულად ეთვლება კატალოგიდან/პაკეტიდან ინსტალაციის დროს (იხილეთ [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk)). ### ავტენტიფიკაცია securityScheme სპეციფიკაციის მიხედვით ავტენტიფიკაცია პირდაპირ SPEC-იდან არის აღებული. AiHummer კითხულობს OpenAPI-ს `securityScheme`, ხოლო ფაქტობრივი საიდუმლო გამოტანილია **სეიფი** ზარის დროს — ასე რომ ავტორიზაციის მონაცემები არასოდეს იწყება მანიფესტში, მითითებაში ან ლოგებში. > [!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 და სხვები. პირადი ანგარიშის დაკავშირება აღწერილია [მოვაჭრეებთან დაკავშირება](/ka/v1.0/access/connections-oauth2). ## MCP: მიერთება ნებისმიერ სერვერზე მეორე ტიპის წყარო უკავშირდება ნებისმიერ **MCP სერვერი**. AiHummer ლაპარაკობს მისთან **stdio ან http ტრანსპორტი**, უწოდებს თავის `tools/list`, და აგენტს უბრუნებს აღდგენილ ხელსაწყოებს. როგორც OpenAPI-ის შემთხვევაში, ამისთვის ინტეგრაციის კოდი არ არის საჭირო. ```json { "version": "1.0.0", "kind": "mcp", "scope": "shared", "mcp": { "transport": "http", "url": "https://mcp.acme.example/" } } ``` stdio ტრანსპორტის სერვერი იფარება ბრძანებით, რომელიც მას აფირმებს, არა URL-ით: ```json { "version": "1.0.0", "kind": "mcp", "scope": "shared", "mcp": { "transport": "stdio", "command": "my-mcp-server" } } ``` ### საიდუმლოებები საცავში → env MCP სერვერებისთვის საიდუმლო ნაკადები **საწყობიდან გარემოში** სერვერი მუშაობს ასე. თქვენ ინახავთ საიდუმლოს ერთხელ საცავში; AiHummer აჩენს მას როგორც გარემოს ცვლადს სტარტისას ან სერვერთან კავშირის დროს, იმისათვის რომ საიდუმლო მასალა დარჩეს მანიფესტის გარეთ და გარეთ მოდელის კონტექსტი. ## OpenAPI ებრძვის MCP-ს პირველად თვალში | | OpenAPI | MCP | |---|---|---| | შეყვანა | OpenAPI 3.x `spec_url` | MCP სერვერი (stdio ან http) | | წარმოებული ხელსაწყოები | ერთი ოპერაციაზე სპეციფიკაციაში | რაც გინდა `tools/list` აბრუნებს | | ავტენტიფიკაცია | სპეციფიკაცია `securityScheme` → საცავი | Vault → სერვერის გარემოს ცვლადები | | კოდი საჭიროა | არაფერი | არაფერი | ## როდის გამოიყენოს რომელის - გაწვდუნება **OpenAPI** როდესაც სერვისი უკვე აქვეყნებს OpenAPI დოკუმენტს — თქვენ ავტომატურად იღებთ მის ყველა ოპერაციას ინსტრუმენტების სახით. - გაწვდუნება **MCP** როდის გსურთ არსებული MCP სერვერის დაკავშირება ან გაშვება ლოკალური ხელსაწყოების სერვერი stdio-ის მეშვეობით. > [!TIP] > ორივე ტიპის წყარო განსაზღვრება ერთსა და იმავე ფაილით `manifest.json` როგორც ყველა > სხვა პლაგინი — ნახეთ [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk) თვის > `openapi` და `mcp` სახეობები და `aihummer plugin validate`. ## სად შემდეგ? - [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk) — წარსადგინებელი სფეროების `openapi` და `mcp`. - [სავაჭრო პლატფორმის მიმოხილვა და დონეები](/ka/v1.0/marketplace/overview-tiers) — სად zero-code (საფეხური 3) მდებარეობს. - [პირადი და საერთო სერთიფიკატები](/ka/v1.0/access/personal-vs-shared) — როგორ განცადოების საიდუმლოებები, რომელსაც ეს ინსტრუმენტები იყენებენ, აქვთ გამოყენების სფერო.