წინადადება დამკვეთს აგენტის მეშვეობით

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

ნაბიჯი	ინსტრუმენტი	ტოკენი
ვერსიის გამოქვეყნება	publish_estimate_version	კითხვა და შეფასებების მონახაზები
დამკვეთის ბმულის შექმნა	create_share_link	კითხვა და შეფასებების მონახაზები
დამტკიცების სტატუსის გაგება	get_approval_status	ნებისმიერი, საკმარისია "მხოლოდ კითხვა"

რა გჭირდებათ

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

ვერსიის გამოქვეყნება

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

• იმავე იდემპოტენტურობის გასაღებით გამეორება იმავე ვერსიას დააბრუნებს.
• გასაღების გარეშე ყოველი გამოძახება ახალ ვერსიას ქმნის.
• თუ MCP-ის ლიმიტი ამოიწურა, აგენტი იღებს პასუხს quota_exceeded განულების თარიღით.

დამკვეთის ბმულის შექმნა

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

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

ბმული პაროლით

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

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

ბმულის განმეორებითი მოთხოვნა

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

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

დამმტკიცებელი

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

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

დამტკიცების სტატუსი

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

• დამტკიცების მდგომარეობა;
• როდის უპასუხა დამკვეთმა;
• რამდენჯერ გაიხსნა ბმული და როდის ბოლოს.

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

მდგომარეობა პასუხში	სტატუსი აპლიკაციაში
approval_disabled	მიმღები არ არის მითითებული
awaiting_response	პასუხს ელოდება
approved	დამტკიცებულია
changes_requested	მოთხოვნილია ცვლილებები
expired_offer	წინადადების ვადა ამოიწურა
expired_link	ბმულის ვადა ამოიწურა
revoked	ბმული გაუქმებულია
superseded	არსებობს უფრო ახალი ვერსია

პაროლიანი ბმულის გახსნების მთვლელმა შეიძლება ერთბაშად 2-ით მოიმატოს: გვერდი და პაროლის შემდეგ ანგარიში ცალ-ცალკე ითვლება.

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

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

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

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

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

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

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