აგენტების აღმოჩენის ფაილი ვერ იკითხება
ფაილი, რომელსაც აგენტები /.well-known/-ში ეძებენ, პასუხობს, მაგრამ ვერ იკითხება: agent-card.json (A2A agent card), mcp.json (MCP სერვერის დესკრიპტორი), api-catalog (RFC 9727) ან, მაღაზიებში, ucp. ის არ არის ვალიდური JSON, ან აკლია საჭირო ველი, მაგალითად agent card-ის name ან API კატალოგის linkset.
რას ნიშნავს
/.well-known/-ში არსებული ფაილი, რომელსაც აგენტები ეძებენ (agent card, MCP დესკრიპტორი, API კატალოგი ან UCP პროფილი), პასუხობს, მაგრამ არავალიდური JSON-ით ან საჭირო ველების გარეშე. აგენტები, რომლებიც მას პოულობენ, აქვე ჩერდებიან. გაასწორეთ ფაილი ან წაშალეთ.
რატომ არის ეს მნიშვნელოვანი AI ძიებისთვის
ეს ფაილები აგენტებს ეუბნებიან, რას სთავაზობს საიტი: აგენტს სასაუბროდ, MCP სერვერს, API-ს, ყიდვის გზას. აგენტი, რომელიც ასეთ ფაილს პოულობს და ვერ არჩევს, ჩერდება და გამოცნობას არ ცდილობს.
საიტების უმეტესობას არცერთი მათგანი არ სჭირდება, ამიტომ ფაილის არარსებობა არასოდეს ფიქსირდება. ფაილი, რომელიც არსებობს, მაგრამ გაუმართავია, ჩვეულებრივ ტესტიდან, შაბლონიდან ან პლაგინიდან რჩება, რომელიც დააყენეს და დაივიწყეს.
როგორ გამოვასწოროთ
- გახსენით თითოეული ფაილი მტკიცებულებიდან და შეამოწმეთ JSON ვალიდატორით.
- გაასწორეთ სინტაქსი და დაამატეთ სავალდებულო ველები ფაილის საკუთარი სპეციფიკაციის მიხედვით.
- მიაწოდეთ ის
Content-Type: application/json-ით (API კატალოგისთვისapplication/linkset+json-ით). - თუ საიტი არ სთავაზობს იმას, რასაც ფაილი აღწერს, წაშალეთ ფაილი. გვერდის რეპორტზე დააჭირეთ „ხელახლა შემოწმება“-ს, რომ შედეგი დაადასტუროთ.
მაგალითი
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} როგორ დავრწმუნდეთ, რომ გამოსწორდა
ცვლილების შემდეგ დააჭირეთ რეპორტში „ხელახლა შემოწმებას“: ის ჩამოთვლის, რა გამოსწორდა და როგორ შეიცვალა ქულა.