6টি কপি-প্রস্তুত JSON টেমপ্লেট · A2A v1.0

A2A Agent Card উদাহরণ

ব্যবহারিক A2A v1.0 টেমপ্লেট ব্রাউজ করুন, তাদের ডিজাইন সিদ্ধান্তগুলি বুঝুন, তারপর আপনার নিজের এজেন্টের জন্য যেকোনো উদাহরণ অভিযোজিত করুন।

পাবলিক এজেন্ট আবিষ্কার

অন্য একটি A2A ক্লায়েন্ট আপনার এজেন্ট একটি কাজ সম্পন্ন করতে পারে কিনা তা নির্ধারণ করার আগে যে JSON আনে তা তৈরি করতে এই উদাহরণগুলি ব্যবহার করুন।

মার্কেটপ্লেস জমা

প্রোভাইডার, স্কিল, ট্যাগ, ক্ষমতা, এবং নিরাপত্তা মেটাডেটা অভিযোজিত করুন যাতে পর্যালোচকরা বুঝতে পারেন এজেন্ট কী করে এবং কে এটি পরিচালনা করে।

অভ্যন্তরীণ এজেন্ট ক্যাটালগ

দলগুলি ওয়ার্কফ্লোতে একীভূত করার আগে অভ্যন্তরীণ এজেন্ট জুড়ে এন্ডপয়েন্ট, প্রমাণীকরণ, এবং স্কিল বিবরণ মানসম্মত করুন।

JSON টেমপ্লেট

সাপোর্ট, বুকিং, শপিং, কোডিং, গবেষণা, এবং ওয়ার্কফ্লো এজেন্টদের জন্য উদাহরণ Agent Card।

একটি টেমপ্লেট যাচাই করুন
ফিল্টার

গ্রাহক সহায়তা এজেন্ট

পণ্য প্রশ্ন, অর্ডার অনুসন্ধান, রিটার্ন, এবং এস্কেলেশন হ্যান্ডঅফ পরিচালনা করে।

কেন এভাবে তৈরি করা হয়েছে

  • OAuth 2.0 ক্লায়েন্ট ক্রেডেনশিয়াল অর্ডার ডেটা রক্ষা করে: Agent Card টোকেন URL এবং স্কোপ ঘোষণা করে যাতে ক্লায়েন্টরা আউট-অফ-ব্যান্ড ডকুমেন্টেশন ছাড়াই প্রমাণীকরণ করতে পারে।
  • streaming এবং pushNotifications উভয়ই true কারণ সহায়তা কথোপকথন দীর্ঘস্থায়ী এবং সমাধান আপডেট অ্যাসিঙ্ক্রোনাসভাবে আসে।
  • একক স্কিলটি একটি অস্পষ্ট "গ্রাহকদের সাহায্য করুন" বিবরণের পরিবর্তে একটি কাজের সীমার (শ্রেণীবদ্ধ করা, সমাধান করা, এস্কেলেট করা) মধ্যে সীমাবদ্ধ, যাতে রাউটাররা এটি সঠিকভাবে মেলাতে পারে।
customer-support.json
{
  "name": "গ্রাহক সহায়তা এজেন্ট",
  "description": "গ্রাহক সহায়তার প্রশ্নের উত্তর দেয়, অর্ডারের প্রসঙ্গ পুনরুদ্ধার করে এবং অমীমাংসিত সমস্যাগুলি মানব দলের কাছে বাড়িয়ে দেয়।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/customer-support",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "resolve-customer-support-request",
      "name": "গ্রাহক সমর্থন অনুরোধ সমাধান করুন",
      "description": "একটি গ্রাহক সহায়তা অনুরোধকে শ্রেণীবদ্ধ করে, প্রয়োজনীয় প্রসঙ্গ সংগ্রহ করে, একটি রেজোলিউশন প্রস্তাব করে এবং আত্মবিশ্বাস কম হলে তা বৃদ্ধি পায়।",
      "tags": [
        "support",
        "orders",
        "returns"
      ],
      "examples": [
        "আমাকে আমার অর্ডার ফেরত সাহায্য করুন."
      ]
    }
  ],
  "securitySchemes": {
    "oauth2": {
      "oauth2SecurityScheme": {
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://api.example.com/a2a/customer-support/oauth/token",
            "scopes": {
              "agent.invoke": "Invoke agent skills"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": [
        "agent.invoke"
      ]
    }
  ]
}

বুকিং এজেন্ট

উপলব্ধ অ্যাপয়েন্টমেন্ট স্লট খুঁজে বের করে এবং বুকিং নিশ্চিতকরণ প্রস্তুত করে।

কেন এভাবে তৈরি করা হয়েছে

  • একটি হেডারে একটি API কী এখানে যথেষ্ট: বুকিং টেন্যান্ট-স্কোপড কিন্তু OAuth যে প্রতিনিধিত্বকারী-ব্যবহারকারীর সম্মতি সমস্যা সমাধান করে তা বহন করে না।
  • defaultOutputModes শুধুমাত্র application/json, যা নির্দেশ করে যে কলাররা গদ্যের পরিবর্তে কাঠামোগত সংরক্ষণ প্রস্তাব পায়।
  • pushNotifications true যাতে স্লট-ধারণকারী ব্যাকএন্ড নিষ্পত্তি হওয়ার পরে এজেন্ট ক্লায়েন্ট পোলিং ছাড়াই একটি সংরক্ষণ নিশ্চিত করতে পারে।
booking.json
{
  "name": "বুকিং এজেন্ট",
  "description": "প্রাপ্যতা অনুসন্ধান করে, বুকিং বিকল্পের প্রস্তাব করে এবং অনুমোদনের জন্য অ্যাপয়েন্টমেন্ট সংরক্ষণ প্রস্তুত করে।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/booking",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "find-and-prepare-booking",
      "name": "খুঁজুন এবং বুকিং প্রস্তুত",
      "description": "রিসোর্সের প্রাপ্যতা চেক করে, বুকিং উইন্ডোর তুলনা করে এবং একটি স্ট্রাকচার্ড রিজার্ভেশন প্রস্তাব ফেরত দেয়।",
      "tags": [
        "booking",
        "calendar",
        "availability"
      ],
      "examples": [
        "আগামীকাল বিকেলে 30-মিনিটের অ্যাপয়েন্টমেন্ট খুঁজুন।"
      ]
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "apiKeySecurityScheme": {
        "location": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ]
}

শপিং এজেন্ট

পণ্য, প্রাপ্যতা, মূল্য, এবং ক্রয় সীমাবদ্ধতা তুলনা করে।

কেন এভাবে তৈরি করা হয়েছে

  • র‍্যাঙ্ক করা সুপারিশগুলি গণনা করার সাথে সাথে স্ট্রিম হয়, তাই streaming true যখন pushNotifications false থাকে — প্রতিক্রিয়া সম্পূর্ণ হওয়ার পরে কিছুই ঘটে না।
  • স্কিল বিবরণ ট্রেডঅফ এবং যুক্তি ফেরত দিতে প্রতিশ্রুতিবদ্ধ, যা অর্কেস্ট্রেটরদের বলে যে এই এজেন্ট শুধু পণ্য তালিকাভুক্ত করার পরিবর্তে র‍্যাঙ্কিং ব্যাখ্যা করে।
  • OAuth স্কোপগুলি ক্রয়-সংলগ্ন ডেটা গেট করে; একটি পাবলিক শপিং ডেমো নিরাপত্তা সম্পূর্ণভাবে বাদ দিতে পারে এবং তবুও একটি বৈধ Agent Card থাকতে পারে।
shopping.json
{
  "name": "শপিং এজেন্ট",
  "description": "ব্যবহারকারীর সীমাবদ্ধতার সাথে পণ্যের তুলনা করে এবং ট্রেডঅফের সাথে র‌্যাঙ্ক করা ক্রয় বিকল্পগুলি ফেরত দেয়।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/shopping",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "compare-shopping-options",
      "name": "কেনাকাটার বিকল্পগুলি তুলনা করুন",
      "description": "প্রার্থীর পণ্যের মূল্যায়ন করে, সীমাবদ্ধতার দ্বারা ফিল্টার করে এবং যৌক্তিকতার সাথে র‌্যাঙ্ক করা সুপারিশ প্রদান করে।",
      "tags": [
        "shopping",
        "commerce",
        "recommendations"
      ],
      "examples": [
        "1,200 ডলারের নিচে হালকা ওজনের ল্যাপটপের তুলনা করুন।"
      ]
    }
  ],
  "securitySchemes": {
    "oauth2": {
      "oauth2SecurityScheme": {
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://api.example.com/a2a/shopping/oauth/token",
            "scopes": {
              "agent.invoke": "Invoke agent skills"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": [
        "agent.invoke"
      ]
    }
  ]
}

কোডিং এজেন্ট

কোড কাজ পর্যালোচনা করে, প্যাচ প্রস্তাব করে, এবং বাস্তবায়ন সিদ্ধান্ত ব্যাখ্যা করে।

কেন এভাবে তৈরি করা হয়েছে

  • extendedAgentCard true: পাবলিক Agent Card একটি সাধারণ "কোড পরিবর্তন বাস্তবায়ন" স্কিল তালিকাভুক্ত করে, যখন রিপোজিটরি-নির্দিষ্ট স্কিলগুলি শুধুমাত্র GetExtendedAgentCard-এর মাধ্যমে প্রমাণীকৃত ক্লায়েন্টদের কাছে প্রকাশিত হয়।
  • text/plain এবং application/json উভয় আউটপুট ঘোষিত হয়েছে কারণ এজেন্ট মেশিন-প্রয়োগযোগ্য প্যাচের পাশাপাশি মানব-পাঠযোগ্য ব্যাখ্যা ফেরত দেয়।
  • দীর্ঘ কম্পাইল-এবং-টেস্ট লুপের জন্য স্ট্রিমিং গুরুত্বপূর্ণ; ক্লায়েন্টরা একটি নীরব বহু-মিনিটের কলের পরিবর্তে মধ্যবর্তী অগ্রগতি দেখতে পায়।
coding.json
{
  "name": "কোডিং এজেন্ট",
  "description": "কোড বিশ্লেষণ করে, পরিবর্তনের প্রস্তাব করে এবং বাস্তবায়ন নোট ফেরত দিয়ে সফ্টওয়্যার ইঞ্জিনিয়ারিং কাজগুলিতে সহায়তা করে।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/coding",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "extendedAgentCard": true
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "implement-code-change",
      "name": "কোড পরিবর্তন বাস্তবায়ন",
      "description": "একটি কোডিং অনুরোধ পড়ে, প্রাসঙ্গিক ফাইলগুলি পরিদর্শন করে, একটি প্যাচ প্রস্তাব ফেরত দেয় এবং যাচাইকরণের পদক্ষেপগুলির সংক্ষিপ্ত বিবরণ দেয়৷",
      "tags": [
        "coding",
        "review",
        "patches"
      ],
      "examples": [
        "ব্যবহারকারীদের API এ পৃষ্ঠা সংখ্যা যোগ করুন।"
      ]
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "apiKeySecurityScheme": {
        "location": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ]
}

গবেষণা এজেন্ট

উৎস সংগ্রহ করে, প্রমাণ নিষ্কাশন করে, এবং কাঠামোগত গবেষণা নোট ফেরত দেয়।

কেন এভাবে তৈরি করা হয়েছে

  • একদমই কোনো securitySchemes নেই: এন্ডপয়েন্ট ইচ্ছাকৃতভাবে পাবলিক, এবং ফিল্ডটি বাদ দেওয়া তা বলার সঠিক উপায় — একটি খালি স্কিম ম্যাপ অস্পষ্ট হবে।
  • ইনপুট শুধুমাত্র text/plain, কারণ গবেষণা সংক্ষিপ্তসার প্রাকৃতিক-ভাষার প্রশ্ন থেকে শুরু হয়; কাঠামোগত আউটপুট application/json নোট হিসাবে আসে।
  • এটি ন্যূনতম উপযোগী v1.0 Agent Card: পরিচয়, একটি ইন্টারফেস, ক্ষমতা, মোড, এবং একটি ভালোভাবে ট্যাগ করা স্কিল।
research.json
{
  "name": "গবেষণা এজেন্ট",
  "description": "উত্স উপাদান সংগ্রহ করে, প্রমাণ বের করে এবং উদ্ধৃতি সহ কাঠামোগত গবেষণা নোট তৈরি করে।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/research",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "prepare-research-brief",
      "name": "গবেষণা সংক্ষিপ্ত প্রস্তুত",
      "description": "অনুমোদিত উত্স অনুসন্ধান করে, দাবি এবং প্রমাণ বের করে এবং একটি সংক্ষিপ্ত গবেষণা সংক্ষিপ্ত বিবরণ প্রদান করে।",
      "tags": [
        "research",
        "evidence",
        "citations"
      ],
      "examples": [
        "নবায়নযোগ্য-শক্তি নীতির উপর একটি উদ্ধৃত সংক্ষিপ্ত বিবরণ প্রস্তুত করুন।"
      ]
    }
  ]
}

অভ্যন্তরীণ ওয়ার্কফ্লো এজেন্ট

অনুমোদন, স্ট্যাটাস চেক, এবং ব্যাক-অফিস ওয়ার্কফ্লো আপডেট সমন্বয় করে।

কেন এভাবে তৈরি করা হয়েছে

  • application/json একমাত্র ইনপুট এবং আউটপুট মোড: এই এজেন্টকে অন্যান্য সিস্টেম দ্বারা কল করা হয়, গদ্য টাইপ করা মানুষের দ্বারা কখনোই নয়।
  • OAuth 2.0 প্লাস extendedAgentCard এন্টারপ্রাইজ অডিটের জন্য উপযুক্ত — নিরাপত্তা দলগুলি প্রকাশ্যে প্রমাণীকরণ প্রয়োজনীয়তা দেখতে পারে যখন সংবেদনশীল ওয়ার্কফ্লো স্কিলগুলি প্রমাণীকরণের পিছনে থাকে।
  • pushNotifications অপরিহার্য কারণ অনুমোদন চেইনগুলি ঘণ্টা বা দিন সময় নেয়; ওয়েবহুকগুলি স্ট্যাটাস পরিবর্তনের জন্য পোলিংয়ের প্রতিস্থাপন করে।
internal-workflow.json
{
  "name": "অভ্যন্তরীণ ওয়ার্কফ্লো এজেন্ট",
  "description": "অভ্যন্তরীণ অনুমোদন সমন্বয় করে, সিস্টেমের স্থিতি পরীক্ষা করে এবং অপারেশন টিমের জন্য ওয়ার্কফ্লো আপডেট প্রস্তুত করে।",
  "supportedInterfaces": [
    {
      "url": "https://api.example.com/a2a/workflow",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "উদাহরণ Inc.",
    "url": "https://example.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true,
    "extendedAgentCard": true
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "coordinate-internal-workflow",
      "name": "অভ্যন্তরীণ কর্মপ্রবাহ সমন্বয় করুন",
      "description": "কর্মপ্রবাহের অভিপ্রায় গ্রহণ করে, নীতির প্রয়োজনীয়তা পরীক্ষা করে, অনুমোদন সংগ্রহ করে এবং চূড়ান্ত অবস্থার প্রতিবেদন করে।",
      "tags": [
        "workflow",
        "operations",
        "approval"
      ],
      "examples": [
        "বেতনের আপডেট স্থাপনের জন্য অনুমোদনের অনুরোধ করুন।"
      ]
    }
  ],
  "securitySchemes": {
    "oauth2": {
      "oauth2SecurityScheme": {
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://api.example.com/a2a/workflow/oauth/token",
            "scopes": {
              "agent.invoke": "Invoke agent skills"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": [
        "agent.invoke"
      ]
    }
  ]
}

আত্মবিশ্বাসের সাথে অভিযোজিত করুন

কীভাবে একটি Agent Card উদাহরণ অভিযোজিত করবেন

প্রতিটি Agent Card উদাহরণ ইচ্ছাকৃতভাবে কপি করার জন্য যথেষ্ট সম্পূর্ণ, কিন্তু Agent Card অপরিবর্তিতভাবে প্রকাশ করা উচিত নয়। এটিকে আপনার নিজস্ব A2A সার্ভারের জন্য একটি ফিল্ড ম্যাপ হিসাবে বিবেচনা করুন: পরিচয়, এন্ডপয়েন্ট, প্রোভাইডার, প্রমাণীকরণ, ক্ষমতা, মোড, এবং স্কিল বিবরণ উৎপাদন মানগুলির সাথে প্রতিস্থাপন করুন।

সবচেয়ে শক্তিশালী Agent Card গুলি সরল ভাষা এবং মেশিন-পাঠযোগ্য মেটাডেটা উভয়েই এজেন্টের কাজের সীমা ব্যাখ্যা করে। একজন ক্লায়েন্টের বলতে সক্ষম হওয়া উচিত এজেন্ট কী করতে পারে, কী করতে পারে না, কোন URL কল করতে হবে, এবং ক্রেডেনশিয়াল প্রয়োজন কিনা।

প্রকাশ করার আগে

প্রতিটি example.com URL আপনার স্থাপিত A2A এন্ডপয়েন্ট এবং প্রোভাইডার ওয়েবসাইট দিয়ে প্রতিস্থাপন করুন।

প্রকৃত কাজের সীমার জন্য স্কিল নাম, বিবরণ, ট্যাগ (v1.0-এ প্রয়োজনীয়), এবং উদাহরণ পুনরায় লিখুন।

provider.organization সেট করুন এবং Agent Card বিষয়বস্তু পরিবর্তিত হলেই শীর্ষ-স্তরের version বাড়ান।

এন্ডপয়েন্ট ইচ্ছাকৃতভাবে পাবলিক হলেই কেবল প্রমাণীকরণ ফিল্ড সরান।

defaultInputModes এবং defaultOutputModes আপনার সার্ভার প্রকৃতপক্ষে যা গ্রহণ করে এবং ফেরত দেয় তার সাথে সামঞ্জস্যপূর্ণ রাখুন।

চূড়ান্ত JSON যাচাই করুন এবং আপনার সেবা ডোমেইনে /.well-known/agent-card.json-এ এটি প্রকাশ করুন।

তৈরি করতে প্রস্তুত

একটি উদাহরণ দিয়ে শুরু করুন, তারপর এটিকে নিজের করে তুলুন।

Agent Card জেনারেটরে যেকোনো প্যাটার্ন খুলুন, JSON পর্যালোচনা করুন, এবং প্রকাশ করার আগে এটি যাচাই করুন।