ვალუტა და პროექტის ასლი აგენტის მეშვეობით

MCP-ზე წვდომის მქონე აგენტი პროექტის შეფასებებს სხვა ვალუტაში გადაიყვანს და პროექტს მთლიანად აკოპირებს. ორივე მოქმედება ჯერ გადახედვას აჩვენებს, ჩაწერს კი მხოლოდ თქვენი დადასტურების შემდეგ. ტოკენის გამოშვება და აგენტის დაკავშირება აღწერილია სტატიაში MCP: აგენტის დაკავშირება. ყოველი გამოძახება MCP-ის ლიმიტში ითვლება: თვეში 100 გამოძახება თითო სამუშაო სივრცეზე.

ამოცანა	ინსტრუმენტი	ტოკენი
პროექტის შეფასებების სხვა ვალუტაში გადაყვანა	change_project_currency	კითხვა და შეფასებების მონახაზები
პროექტის კოპირება	copy_project	კითხვა და შეფასებების მონახაზები

პროექტს აგენტი პოულობს project_id-ით, ეს პროექტების სიის იდენტიფიკატორია.

სხვა ვალუტაში გადაყვანა

სთხოვეთ, მაგალითად: "გადაიყვანე სტუდიის საიტის პროექტის შეფასებები USD-ში, 1 USD = 80 RUB". აგენტი იძახებს change_project_currency-ს ველებით project_id და target_currency (სამასოიანი კოდი, მაგალითად USD). ის თავიდან ითვლის საათობრივ განაკვეთს, გუნდის ღირებულებას, ფიქსირებულ ხარჯებს და ორივე სცენარის ჯამებს.

ვალუტას ცვლის მხოლოდ მონახაზები. პროექტის დანარჩენ შეფასებებს აგენტი გამოტოვებს, ისინი მიზეზითურთ ხვდება skipped-ში:

მიზეზი	რას ნიშნავს
published	შეფასება გამოქვეყნებულია
archived	შეფასება დაარქივებულია
already_in_target	შეფასება უკვე საჭირო ვალუტაშია
currency_not_in_rate_pair	შეფასების ვალუტა კურსის წყვილში არ არის

გამოქვეყნებული ვერსიები და დამკვეთის ბმულები უცვლელი რჩება. ვალუტებზე შეფასებაში მეტი: ვალუტები და კურსები.

კურსის მითითება

კურსს აგენტი გადასცემს ველში rate: { base: "USD", quote: "RUB", value: 80 } ნიშნავს 1 USD = 80 RUB. წყვილის რიგი არ აქვს მნიშვნელობა, მაგრამ წყვილში უნდა იყოს შეფასებების მიმდინარე ვალუტა და target_currency. value ნულზე დიდი რიცხვია.

კურსის დასახელება აუცილებელი არ არის. მაშინ აგენტი იყენებს სამუშაო სივრცის საცნობარო კურსს: პასუხში ის აღნიშნულია როგორც reference და ჩანს კურსის წყარო და თარიღი. თქვენი დასახელებული კურსი მოდის ნიშნულით custom.

თუ წყვილი არ ერგება, აგენტი იღებს პასუხს invalid_params. მინიშნებაში ახსნილია, როგორ ჩაიწეროს კურსი, და ჩამოთვლილია პროექტის მონახაზების ვალუტები.

გადახედვა და დადასტურება

პირველი გამოძახება არაფერს ინახავს. პასუხში:

• applied უდრის false-ს;
• თითოეული შეფასებისთვის ნაჩვენებია კურსი (წყვილი, მამრავლი, წყარო) და თანხები "იყო" (before) და "გახდა" (after): საათობრივი განაკვეთი ან გუნდის ღირებულება, ფიქსირებული ხარჯები, შრომატევადობა და თითოეული სცენარის ჯამი;
• skipped ჩამოთვლის გამოტოვებულ შეფასებებს მიზეზით.

აგენტი გიჩვენებთ გადახედვას. თუ თანხები სწორია, დაადასტურეთ: აგენტი იმეორებს გამოძახებას confirm-ით true, და ყველა მონახაზი ერთი ტრანზაქციით გადაიყვანება. ამის შემდეგ ძველ ვალუტაზე დაბრუნება შეუძლებელია, შეგიძლიათ მხოლოდ ახალი კურსით ხელახლა გადაიყვანოთ.

• იდემპოტენტურობის გასაღები (idempotency_key) გადაეცემა მხოლოდ confirm-თან true-ს გვერდით. იმავე გასაღებით გამეორება პირველ შედეგს დააბრუნებს და თანხებს მეორედ არ გადაითვლის.
• თუ MCP-ის ლიმიტი ამოიწურა, აგენტი იღებს პასუხს quota_exceeded განულების თარიღით.

პროექტის კოპირება

სთხოვეთ, მაგალითად: "დააკოპირე სტუდიის საიტის პროექტი". აგენტი იძახებს copy_project-ს ველით project_id. ასლის სახელი თავად შეირჩევა, მაგალითად "სტუდიის საიტი (ასლი 1)".

პირველი გამოძახება გეგმას აჩვენებს და არაფერს ქმნის. პასუხში:

• applied უდრის false-ს;
• project_name: მომავალი ასლის სახელი;
• estimates_to_copy: შეფასებები, რომლებიც ასლში მოხვდება (იდენტიფიკატორი და სახელი);
• skipped: შეფასებები, რომლებიც ასლში არ მოხვდება, მიზეზით archived;
• not_copied: რამდენი მონაწილე (participants), ამოცანა (issues) და მოქმედი ბმული დამკვეთისთვის (active_shares) არ გადავა ასლში.

თქვენი დადასტურების შემდეგ აგენტი იმეორებს გამოძახებას confirm-ით true. ასლი იქმნება ერთი ტრანზაქციით, პასუხში applied უდრის true-ს, არის ახალი ასლის project_id და project_name და estimates_copied: დაკოპირებული შეფასებების რაოდენობა. idempotency_key მუშაობს ისე, როგორც ვალუტის შეცვლისას: მასთან გამეორება მეორე ასლს არ შექმნის.

რა კოპირდება და რა არა

ასლში ხვდება:

• პროექტის პარამეტრები: ხატულა, ტეგები, ქულების შკალა, ციკლები და დროის სარტყელი;
• მონახაზები და გამოქვეყნებული შეფასებები: თითოეული ასლში ჩნდება ახალ მონახაზად ნიშნულით "შექმნილია MCP-ით".

ასლში არ ხვდება:

• მონაწილეები: ასლში თქვენ ერთადერთი მონაწილე ხართ;
• ამოცანები;
• პროექტის აღწერა და თარიღები;
• დაარქივებული შეფასებები;
• შეფასებების ვერსიები: ასლს ისტორია არ აქვს;
• დამკვეთის ბმულები და დამკვეთის მონაცემები.

აპლიკაციის ღილაკი "პროექტის კოპირება" სხვანაირად მუშაობს, მაგალითად ის პროექტის აღწერასაც გადაიტანს. მას აღწერს სტატია პროექტის კოპირება.

ვის შეუძლია

ორივე მოქმედებისთვის საჭიროა ჩაწერის უფლების მქონე ტოკენი. ვალუტის გადაყვანა შეუძლია მას, ვისაც პროექტის შეფასებების რედაქტირების უფლება აქვს. პროექტის დაკოპირება შეუძლია პროექტის ხელმძღვანელს, რომელიც ამავე დროს სამუშაო სივრცის მფლობელია. სხვა შემთხვევაში აგენტი იღებს უარს და არაფერი იცვლება.

რას არ აკეთებს აგენტი

• არ ცვლის გამოქვეყნებული და დაარქივებული შეფასებების ვალუტას და არ ეხება გამოქვეყნებულ ვერსიებს.
• არ აკოპირებს მონაწილეებს, ამოცანებს, აღწერას, თარიღებს, ვერსიებს, ბმულებს და დამკვეთის მონაცემებს.
• არ ითვლის თანხებს თავიდან და არ ქმნის ასლს confirm-ის გარეშე true მნიშვნელობით.

იხილეთ აგრეთვე

MCP: აგენტის დაკავშირება ტოკენი, წვდომა, ლიმიტები და შეფასების მონახაზი ტექნიკური დავალებიდან

ვალუტები და კურსები შეფასების ვალუტა, კურსები და სხვა ვალუტის სტრიქონები

პროექტის კოპირება კოპირების ღილაკი აპლიკაციაში და რას გადაიტანს ის