Page History

...

1. Create a virtual asset for A2A testing. See Adding Projects Virtual Assets and Responder Suites for more information about creating virtual assets.
2. Add a JSON Message Responder to the virtual asset. This will be the Agent Card.
   • The Agent Card functions as a public, machine-readable JSON metadata document, serving as an agent’s digital “business card” and advertising its identity and capabilities to potential clients.
   • The Agent Card is crucial for enabling agents to find and understand how to interact with one another.
3. To configure the JSON Message Responder to be your Agent Card:
   1. On the Responder Correlation tab under URL Path, set the Path for where your Agent Card is published. This is typically at a well-known URI, often /.well-known/agent-card.json.
      
   2. On the Response tab, add the Response payload for the Agent Card. Be sure you to sure to use the right protocol for "url" callback to your Virtualize server based on how users will access it.
      Image Modified
      
      

      Code Block
      title Sample response payload
      { "name": "My AI Agent", "description": "An agent that processes tasks and returns structured results.", "url": "https://${{=sv:header('host')}}/deploymentPathA2A/my-ai-agent", "version": "1.0.0", "provider": { "organization": "Example Corp", "url": "https://example.com" }, "capabilities": { "streaming": false, "pushNotifications": false, "stateTransitionHistory": false }, "authentication": { "schemes": ["Bearer"] }, "defaultInputModes": ["text/plain", "application/json"], "defaultOutputModes": ["text/plain", "application/json"], "skills": [ { "id": "data-analysis", "name": "Data Analysis", "description": "Analyzes structured data and returns insights.", "tags": ["data", "analytics"], "examples": [ "Analyze this CSV and summarize trends", "Find anomalies in this dataset" ], "inputModes": ["application/json", "text/csv"], "outputModes": ["application/json"] }, { "id": "text-summarization", "name": "Text Summarization", "description": "Summarizes long-form text content.", "tags": ["nlp", "summarization"], "examples": [ "Summarize this article in 3 bullet points" ], "inputModes": ["text/plain"], "outputModes": ["text/plain"] } ] }

4. Add a JSON Files Responder to the virtual asset. This will be the Agent.
   • If your A2A server is using gRPC then install the gRPC extensions from the Parasoft Marketplace and configure the virtual asset on your Virtualize Server to use gRPC listener. See gRPC Extensions and Protobuf Extension for more information.
5. To configure the JSON Files Responder to be your Agent:
   1. On the Responder Correlation tab under URL Path, set the Path to be the same as the value from the Agent Card response (for example, in the sample payload above, this is "/my-ai-agent").
      
   2. On the Response tab:
      • Set the location of the directory to use for request and response files under Request/Response Files. 
      • Disable Files start with a message headers section....
      • Set exclude patterns for id and messageId as needed under Exclude Patterns for Request Message Correlation.
        Image Modified
6. Create a Data Generator Tool chained to the incoming request to generate two random, unique ID Strings for messageId and contextId.
   • Use Pattern: &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& for messageId.
   • Use Pattern: &&&&&&&&-&&&&-&&&&-&&&&-&&&&&&&&&&&& for contextId.
   • Use Character map: 1234567890abcdef for both.
   • Be sure to configure the corresponding Data Source Column for each String.
7. Save your changes.
8. In the directory you set for Request/Response Files, add the following files:
   • agent_request1example_request.txt
     

     Code Block
     title Sample agent_request1example_request.txt file
     { "jsonrpc": "2.0", "id": "req-001", "method": "message/send", "params": { "message": { "role": "ROLE_USER", "parts": [{ "text": "Check drug interactions for warfarin and aspirin" }], "messageId": "fec59aef01e660f0e0794740be2c907d" }, "configuration": { "acceptedOutputModes": ["text/plain", "application/json"], "historyLength": 10, "returnImmediately": false } } }

   • agent_example_response1response.txt
     

     Code Block
     title Sample agent_example_response1response.txt file
     { "jsonrpc": "2.0", "id": "${{=/root/id/text()#fec59aef01e660f0e0794740be2c907d#req-001}}",   "result": { "message": {       "messageId": "${messageId}", "contextId": "${contextId}",       "role": "ROLE_AGENT", "parts": [{ "text": "Combining warfarin and aspirin carries a major risk of severe bleeding and should only be done under strict medical supervision, as both medications thin the blood." }] } } }

   • agent_default_request.txt

     Code Block
     title Sample agent_default_request.txt file
     {*}

   • agent_default_response.txt
     

     Code Block
     title Sample agent_default_response.txt file
     { "jsonrpc": "2.0", "id": "${{=/root/id/text()#fec59aef01e660f0e0794740be2c907d#req-001}}",   "result": { "message": {       "messageId": "${messageId}", "contextId": "${contextId}",       "role": "ROLE_AGENT", "parts": [{ "text": "I'm sorry, I didn't understand the request or your request couldn't be processed right now." }] } } }

...