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

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

ნაბიჯი	ინსტრუმენტი	ტოკენი
პარამეტრების წაკითხვა	get_workspace_settings	ნებისმიერი, საკმარისია "მხოლოდ კითხვა"
პარამეტრების შეცვლა	update_workspace_settings	კითხვა და შეფასებების მონახაზები

პარამეტრების წაკითხვა

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

• სამუშაო სივრცის ნაგულისხმევი ვალუტით;
• მნიშვნელობებით, რომლებიც სამუშაო სივრცეში პირდაპირ არის მითითებული (overrides): ცარიელი მნიშვნელობა ნიშნავს, რომ მოქმედებს Dead Point-ის სტანდარტი;
• ახალი შეფასებებისთვის მოქმედი მნიშვნელობებით (effective): შრომის ერთეული, ქულების შკალა, საათობრივი განაკვეთი ან გუნდის ღირებულება თვეში;
• თითოეული გუნდის ქულების შკალით.

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

პარამეტრების შეცვლა

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

ველი	რას განსაზღვრავს
hour_rate	საათობრივი განაკვეთი საათებში გამოთვლილი ახალი შეფასებებისთვის
team_cost_per_month	გუნდის ღირებულება თვეში
buffer_percent	ბუფერი, %
rounding_scale	ათწილადი ნიშნები თანხებში, რიცხვი 0-დან 6-მდე
estimate_type	ყველა გუნდის ქულების შკალა: not_in_use, linear, fibonacci, exponential ან t_shirt
default_currency_code	ნაგულისხმევი ვალუტა, სამასოიანი კოდი, მაგალითად USD
work_hours_per_day	სამუშაო საათები დღეში
work_days	კვირის სამუშაო დღეები რიცხვებით
cycle_days	ციკლის ხანგრძლივობა დღეებში

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

რომ hour_rate, team_cost_per_month, buffer_percent ან rounding_scale Dead Point-ის სტანდარტს დაუბრუნდეს, აგენტი მათ სახელებს reset_fields-ში გადასცემს. სხვა სახელს reset_fields-ში და დაუშვებელ მნიშვნელობას აგენტი იღებს პასუხით invalid_params მინიშნებით, რომელი მნიშვნელობებია დაშვებული.

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

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

• applied უდრის false-ს;
• changes ჩამოთვლის ველებს: რა იყო (before) და რა გახდება (after);
• affected_teams აჩვენებს, რამდენ გუნდს შეეცვლება ქულების შკალა.

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

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

არსებული შეფასებები

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

ვის შეუძლია პარამეტრების შეცვლა

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

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

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

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

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

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

ქულები და შკალები ოთხი შკალა, გუნდის წარმადობა და ღირებულება

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