அனைத்து முறைகளும் JSON-RPC 2.0-ஐப் பயன்படுத்தி https://www.magisterium.com/api/v1/a2a-க்கு POST மூலம் அழைக்கப்படுகின்றன. ஒவ்வொரு கோரிக்கையிலும் Authorization: Bearer $MAGISTERIUM_TOKEN (ஒரு OAuth-ஆல் வழங்கப்பட்ட பயனர் டோக்கன் — அங்கீகாரம் பார்க்கவும்) மற்றும் Content-Type: application/json இருக்க வேண்டும்.

முறைகள்

message/send

ஒரு திறனுக்கு ஒரு செய்தியை அனுப்பி, முடிக்கப்பட்ட பணியைப் பெறவும். அனைத்து Magisterium திறன்களும் ஒத்திசைவானவை — பதிலில் முடிவான பணி நிலை (completed அல்லது failed) உள்ளது, ஒருபோதும் இடைநிலை working நிலை இல்லை.

Params:

புலம்	வகை	தேவை	விளக்கம்
message	Message	ஆம்	பகுதிகள் மற்றும் விருப்ப metadata-உடன் பயனர் செய்தி.
message.role	string	ஆம்	"user" ஆக இருக்க வேண்டும்.
message.messageId	string	ஆம்	இந்த செய்திக்கான தனித்துவமான ID.
message.kind	string	ஆம்	"message" ஆக இருக்க வேண்டும்.
message.parts	Part[]	ஆம்	குறைந்தபட்சம் ஒரு பகுதி (உரை அல்லது தரவு).
message.metadata.skillId	string	இல்லை	அழைக்க வேண்டிய திறன். இயல்புநிலை catholic_qa.
message.contextId	string	இல்லை	தொடர்புடைய பணிகளை குழுவாக்குவதற்கான விருப்ப சூழல் ID. தவிர்க்கப்பட்டால், சர்வர் ஒன்றை உருவாக்குகிறது.
configuration	object	இல்லை	எதிர்கால பயன்பாட்டுக்காக ஒதுக்கப்பட்டது.

திருப்பித் தருகிறது: kind: "task" உடன் ஒரு Task பொருள்.

tasks/get

முன்பு உருவாக்கப்பட்ட பணியை அதன் ID மூலம் மீட்டெடுக்கவும்.

Params:

புலம்	வகை	தேவை	விளக்கம்
id	string	ஆம்	message/send-இலிருந்து திரும்பிய பணி ID.

திருப்பித் தருகிறது: Task பொருள், அல்லது காலாவதியானால் அல்லது காணாமல் போனால் TASK_NOT_FOUND பிழை. பணிகள் 24 மணி நேரம் சேமிக்கப்படுகின்றன.

tasks/cancel

பணி ரத்து செய்யக்கூடிய நிலையில் இருந்தால் அதை ரத்து செய்யவும். எல்லா திறன்களும் ஒத்திசைவாக தீர்க்கப்படுவதால், பெரும்பாலான பணிகள் பதில் திரும்பும் போது ஏற்கனவே முடிவு நிலையில் (completed / failed) உள்ளன — ஒரு முடிவு நிலை பணியை ரத்து செய்ய முயற்சிப்பது Invalid state transition செய்தியுடன் INVALID_PARAMS-ஐ திருப்பித் தரும்.

Params:

புலம்	வகை	தேவை	விளக்கம்
id	string	ஆம்	ரத்து செய்ய வேண்டிய பணி ID.

திருப்பித் தருகிறது: status.state: "canceled" உடன் புதுப்பிக்கப்பட்ட Task பொருள்.

பணி வாழ்க்கைச் சுழற்சி

Magisterium-இன் திறன்கள் ஒத்திசைவாக இயங்குகின்றன, எனவே திறன் முடிந்த பிறகு மட்டுமே பணி சேமிப்பகத்தில் சேமிக்கப்படுகிறது — எப்போதும் ஒரு முடிவு நிலையில். submitted மற்றும் working நிலைகள் பரந்த A2A விவரக்குறிப்பின் ஒரு பகுதியாக இருந்தாலும், Magisterium-இன் செயலாக்கம் அவற்றை ஒருபோதும் உருவாக்குவதில்லை; கீழே உள்ள மூன்று முடிவு நிலைகளில் ஒன்றை மட்டுமே நீங்கள் காண்பீர்கள்.

நிலை	பொருள்
completed	முடிவு — முடிவுகள் artifacts-இல் உள்ளன. திறன் வெற்றிகரமாக முடிந்தால் message/send மூலம் திருப்பித் தரப்படும்.
failed	முடிவு — status.message தோல்வியின் காரணத்தைக் கொண்டுள்ளது. திறன் ஒரு விதிவிலக்கை வீசும்போது message/send மூலம் திருப்பித் தரப்படும்.
canceled	முடிவு — முடிவு-அல்லாத பணியில் tasks/cancel-ஐ அழைப்பதன் மூலம் மட்டுமே அடையக்கூடியது. message/send திரும்புவதற்குள் பணிகள் ஏற்கனவே முடிவு நிலையில் இருப்பதால், நடைமுறையில் உங்களிடம் கைப்பிடி உள்ள எந்தவொரு பணிக்கும் ரத்து செய்தல் INVALID_PARAMS-உடன் நிராகரிக்கப்படுகிறது.

ஒவ்வொரு பணியும் இவற்றைத் தாங்குகிறது:

• contextId — தொடர்புடைய பணிகளை இணைக்க பின்தொடர்தல் செய்திகளில் நீங்கள் மீண்டும் பயன்படுத்தக்கூடிய குழுவாக்கல் அடையாளங்காட்டி.
• history — பணியின் ஆர்டிஃபேக்ட்களை உருவாக்கிய பயனர் மற்றும் முகவர் செய்திகளின் வரிசைப்படுத்தப்பட்ட பட்டியல்.

பிழை குறியீடுகள்

குறியீடு	பெயர்	விளக்கம்
-32700	Parse error	தவறான JSON உடல்.
-32600	Invalid request	jsonrpc, method, அல்லது id புலங்கள் இல்லை.
-32601	Method not found	தெரியாத JSON-RPC முறை.
-32602	Invalid params	காணாமல் போன அல்லது தவறான அளவுருக்கள் (தவறான tasks/cancel நிலை மாற்றங்களுக்கும் திருப்பப்படுகிறது).
-32603	Internal error	எதிர்பாராத சர்வர்-பக்க தோல்வி.
-32001	Task not found	பணி ID இல்லை அல்லது காலாவதியானது.
-32002	Skill not found	செய்தி metadata-இல் தெரியாத skillId.
-32003	Rate limit exceeded	அதிக கோரிக்கைகள். பிழையின் data-இல் retryAfter (வினாடிகள்) சரிபார்க்கவும்.
-32004	Unauthorized	காணாமல் போன அல்லது தவறான Bearer டோக்கன்.
-32005	Paid plan required	A2A-க்கு Pro, Organization, அல்லது Enterprise திட்டம் தேவை.

HTTP நிலை பிழை வகையைப் பிரதிபலிக்கிறது: UNAUTHORIZED-க்கு 401, PLAN_REQUIRED-க்கு 403, RATE_LIMITED-க்கு 429, மற்றும் மற்ற எல்லா JSON-RPC பிழைகளுக்கும் 200 (JSON-RPC மரபுப்படி error உடலுடன் 200-ஐ திருப்பித் தருவது).

ரேட் வரம்புகள்

A2A MCP-உடன் ஒரே ரேட்-லிமிட் குளத்தைப் பகிர்ந்து கொள்கிறது — ஒவ்வொரு திட்டத்திற்கான கோரிக்கை வரம்புகளுக்கு MCP விலை நிர்ணயம் பார்க்கவும்.

இரண்டு மாறுபாடுகள் செயல்படுத்தப்படுகின்றன:

• இயல்புநிலை — document_search, document_fetch, liturgical_readings, மற்றும் saints_of_the_day-க்கு பொருந்தும்.
• விலையுயர்ந்த — catholic_qa-க்கு மட்டுமே பொருந்தும், ஏனெனில் அது LLM-ஆதரவு பதில் பைப்லைனை இயக்குகிறது. இந்த மாறுபாடு கடுமையான, குறைந்த வரம்பைப் பயன்படுத்துகிறது.

நீங்கள் ஒரு வரம்பை அடையும்போது, பிழையின் data பொருள் வினாடிகளில் retryAfter-ஐக் கொண்டுள்ளது. மீண்டும் முயற்சி செய்வதற்கு முன் அழைப்பாளர்கள் அந்த இடைவெளிக்கு பின்வாங்க வேண்டும்.

CORS

எண்ட்பாயிண்ட் OPTIONS preflight கோரிக்கைகளுக்கு பதிலளிக்கிறது மற்றும் அனுமதிக்கப்பட்ட CORS தலைப்புகளைத் திருப்பித் தருகிறது (Access-Control-Allow-Origin: *, Allow-Methods: POST, OPTIONS, Allow-Headers: Content-Type, Authorization), எனவே A2A ஒரு ப்ராக்ஸி இல்லாமல் உலாவி-அடிப்படையிலான ஆர்கெஸ்ட்ரேட்டர்களிலிருந்து அழைக்கப்படலாம்.