{"info":{"_postman_id":"4e97faa9-c587-4199-8d51-bfa226e93b60","name":"Health Tips AI Agent","description":"

Health Tips AI Agent collection provides endpoints for interacting with the HealthAI assistant via a JSON-RPC style API. Use the requests in this collection to validate health agent availability, execute message workflows, and inspect artifacts. Configure base_url via environment or globals.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"38639286","collectionId":"4e97faa9-c587-4199-8d51-bfa226e93b60","publishedId":"2sB3WpPzvj","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-31T14:27:21.000Z"},"item":[{"name":"Health Check","id":"6b357810-9c55-412b-97d5-2a515c21b919","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{base_url}}/health","description":"

Purpose:

This GET request checks the health status of the Health Tips AI Agent service. It is typically used for monitoring and verifying that the service is operational and responsive.

Endpoint:

GET {{base_url}}/health\n\n

Headers:

Content-Type: application/json

Response:

Status Code: 200 OK (when the service is healthy)
\n
Body Structure (JSON):
\n
```
  {\n    \"status\": \"healthy\",\n    \"service\": \"health_tips_agent\",\n    \"timestamp\": \"2025-10-31T14:30:52.339793+00:00\"\n  }\n\n
```
\n
- status: Indicates the health of the service (e.g., \"healthy\").
  \n
- service: The name of the service being checked.
  \n
- timestamp: The time at which the health check was performed (ISO 8601 format).
  \n
\n

Usage Notes:

Use this endpoint for automated health checks or uptime monitoring.
\n
A non-200 response may indicate the service is down or experiencing issues.
\n

For more details, refer to the Health Tips AI Agent collection.

\n","urlObject":{"path":["health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6b357810-9c55-412b-97d5-2a515c21b919"},{"name":"A2A Execute Method Test","id":"79a84032-f07f-431e-af58-80017ba96b0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"execute-test-002\",\n \"method\": \"execute\",\n \"params\": {\n \"messages\": [\n {\n \"parts\": [\n {\n \"kind\": \"text\",\n \"text\": \"What are healthy breakfast options?\"\n }\n ]\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/a2a/health","description":"

Purpose:
This endpoint invokes the A2A agent execute method for conversational queries (health topic). Use it to send a user message to the Health Tips AI Agent and receive agent-composed responses and artifacts.

Request format (POST JSON-RPC):

Content-Type: application/json
\n
URL: {{base_url}}/a2a/health
\n
Body (raw JSON):
{
\"jsonrpc\": \"2.0\",
\"id\": \"execute-test-002\",
\"method\": \"execute\",
\"params\": {
\"messages\": [
\n
```
{\"parts\": [{\"kind\": \"text\", \"text\": \"What are healthy breakfast options?\"}]}\n\n
```
]
}
}
\n

Expected response (success 200):

A JSON-RPC 2.0 style response containing result.task metadata, status, history, and artifacts. Example response (truncated):
{
\"jsonrpc\": \"2.0\",
\"id\": \"execute-test-002\",
\"result\": {
\"id\": \"99a03854-...\",
\"contextId\": \"6a2d892c-...\",
\"status\": {\"state\": \"completed\", \"timestamp\": \"2025-11-01T19:43:09Z\", \"message\": {...}},
\"artifacts\": [{\"artifactId\": \"5291...\", \"name\": \"health_response\", \"parts\": [{\"kind\": \"text\", \"text\": \"A healthy breakfast could include...\"}]}]
}
}

Notes:

Ensure the {{base_url}} variable is set in the environment or globals (globals include baseURL, base_url).
\n
Header Content-Type: application/json required.
\n
Request id should be unique per call if tracking is needed.
\n

Use-cases:

QA testing agent responses for health queries.
\n
Automating health tip generations and validating artifacts.
\n
Building integrations that need agent-generated content for a health topic.
\n

References:

Collection: Health Tips AI Agent (collection link)
\n
Request: A2A Execute Method Test (request link)
\n

\n","urlObject":{"path":["a2a","health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"79a84032-f07f-431e-af58-80017ba96b0f"},{"name":"A2A Message/Send - Health Topic Test","id":"1f8b07d9-487f-4f4e-a215-061a0a6ed5b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"health-test-001\",\n \"method\": \"message/send\",\n \"params\": {\n \"message\": {\n \"parts\": [\n {\n \"kind\": \"text\",\n \"text\": \"I have mouth pain, what should i do?\"\n }\n ]\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/a2a/health","description":"

Purpose
Send a health-related message to the A2A (agent-to-agent) service using JSON-RPC 2.0. This endpoint queues and processes a message and returns the task status and the agent’s response content when available.

HTTP
POST {{base_url}}/a2a/health

Headers

Content-Type: application/json

Variables

base_url (required): The API host, e.g., https://api.example.com

Request format (JSON-RPC 2.0)

jsonrpc: Must be \"2.0\"
\n
id: Your client-supplied correlation ID (string)
\n
method: \"message/send\"
\n
params.message.parts: Array of content parts. For a simple text prompt, send one part with kind \"text\" and a text value.
\n

Example request body
{
\"jsonrpc\": \"2.0\",
\"id\": \"health-test-001\",
\"method\": \"message/send\",
\"params\": {
\"message\": {
\"parts\": [
{ \"kind\": \"text\", \"text\": \"How can I improve my sleep quality?\" }
]
}
}
}

Successful response (200)
Returns a JSON-RPC 2.0 envelope with a task/result payload. Based on a prior run, a typical response looks like:
{
\"jsonrpc\": \"2.0\",
\"id\": \"health-test-001\",
\"result\": {
\"id\": \"\",
\"contextId\": \"\",
\"status\": {
\"state\": \"completed\", // or \"running\", etc.
\"timestamp\": \"2025-11-01T19:38:51.798411Z\",
\"message\": {
\"messageId\": \"\",
\"role\": \"agent\",
\"parts\": [
{ \"kind\": \"text\", \"text\": \"To improve sleep quality, ...\" }
]
}
},
\"artifacts\": [ { ... } ],
\"history\": [ { ... } ],
\"kind\": \"task\"
}
}
Notes

The top-level id in the response mirrors the request id you sent.
\n
status.state \"completed\" indicates the agent has produced an answer. When present, status.message.parts[0].text contains the agent’s reply.
\n

Use cases

Ask for a health tip (e.g., sleep hygiene, hydration, nutrition basics).
\n
Request short actionable guidance for daily wellness.
\n
Generate content for a “Daily Health Tip” feature.
\n

Error handling

4xx/5xx responses will include standard HTTP errors. Ensure Content-Type is set and base_url is correct.
\n
If your integration expects streaming or intermediate states, poll/retry using the returned task id until status.state is \"completed\".
\n

\n","urlObject":{"path":["a2a","health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1f8b07d9-487f-4f4e-a215-061a0a6ed5b7"},{"name":"Off-Topic Redirection Test","id":"3be3066a-4b50-4b4c-b35b-c3428d931724","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"offtopic-test-003\",\n \"method\": \"message/send\",\n \"params\": {\n \"message\": {\n \"parts\": [\n {\n \"kind\": \"text\",\n \"text\": \"Tell me about football\"\n }\n ]\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/a2a/health","description":"

Off-Topic Redirection Test

Purpose:
This POST request sends a JSON-RPC 2.0 message to the AI agent health endpoint to test how the agent handles off-topic user input. The agent is configured to redirect or refuse non-health queries. Use this request to verify redirection and response structure.

URL and variables:

URL: {{base_url}}/a2a/health
\n
Variable: base_url — set in environment or globals to point to the API host.
\n

Headers:

Content-Type: application/json

Request body (JSON-RPC):
Example body: {
\"jsonrpc\": \"2.0\",
\"id\": \"offtopic-test-003\",
\"method\": \"message/send\",
\"params\": {
\"message\": {
\"parts\": [ { \"kind\": \"text\", \"text\": \"Tell me about football\" } ]
}
}
}
Notes:

id can be any client-generated string. Use unique ids for correlation.
\n
method should follow the AI agent's RPC methods (e.g., message/send, execute).
\n

Expected response (200):
A JSON-RPC 2.0 response containing task id, contextId, status and agent message. Example (truncated):
{
\"jsonrpc\": \"2.0\",
\"id\": \"offtopic-test-003\",
\"result\": {
\"id\": \"f543c65e-...\",
\"contextId\": \"b00c7f9d-...\",
\"status\": { \"state\": \"completed\", ... },
\"artifacts\": [ { \"name\": \"health_response\", \"parts\": [ {\"kind\":\"text\",\"text\":\"I specialize only in health and wellness...\"} ] } ]
}
}

Usage tips:

Change the message text to test other off-topic inputs.
\n
Use the response to confirm the agent refuses or redirects non-health queries.
\n

Saved examples: None currently.

\n","urlObject":{"path":["a2a","health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3be3066a-4b50-4b4c-b35b-c3428d931724"},{"name":"Error Handling - Invalid JSON-RPC","id":"808abee4-7390-4acf-aa77-03e75b301a96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"1.0\",\n \"id\": \"error-test-005\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/a2a/health","description":"

Purpose
Checks the health of the A2A service over a JSON‑RPC 2.0 interface. Useful for monitoring, readiness checks, and verifying server connectivity and request validation.

Endpoint
POST {{base_url}}/a2a/health
Header: Content-Type: application/json

JSON‑RPC 2.0 Request Shape

jsonrpc (string, required): Must be exactly \"2.0\".
\n
id (string|number|null, required): Correlates request/response. Must be unique per call within a client session.
\n
method (string, required): The RPC method to call. For health checks, typically \"health\" or \"ping\" depending on server implementation.
\n
params (object|array, optional): Parameters for the method. Often omitted for health.
\n

Required Fields

jsonrpc = \"2.0\"
\n
id present (any non-undefined value is acceptable; string is typical)
\n
method present (e.g., \"health\")
\n

Example: Valid Request
{
\"jsonrpc\": \"2.0\",
\"id\": \"health-test-001\",
\"method\": \"health\"
}

Example: Invalid Request (current body in tab)
{
\"jsonrpc\": \"1.0\",
\"id\": \"error-test-005\"
}

Expected Responses

Success (JSON‑RPC 2.0):
200 OK
{
\"jsonrpc\": \"2.0\",
\"id\": \"health-test-001\",
\"result\": {
\n
```
\"status\": \"ok\",\n\"uptime\": 12345\n\n
```
}
}
Notes: The shape of result is server-defined; common fields include status, version, uptime.
\n
Validation/Error (observed):
200 OK
{
\"jsonrpc\": \"2.0\",
\"id\": \"error-test-005\",
\"error\": {
\n
```
\"code\": -32600,\n\"message\": \"Invalid Request\",\n\"data\": {\n  \"details\": \"jsonrpc must be '2.0' and id is required\"\n}\n\n
```
}
}
Meaning: The server accepted the HTTP request but the JSON‑RPC payload was invalid (code -32600 per JSON‑RPC spec).
\n

Troubleshooting

Ensure jsonrpc is exactly \"2.0\" (string, not number).
\n
Include id and method fields. If this endpoint expects a specific method (e.g., \"health\"), provide it.
\n
Verify Content-Type header is application/json.
\n
Remove trailing commas and ensure valid JSON encoding.
\n
If you receive -32601 (Method not found), check the method name.
\n
If you receive -32602 (Invalid params), provide or correct params per server contract.
\n

Variables

base_url: Set this in your globals/environment. Example: https://api.example.com

\n","urlObject":{"path":["a2a","health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"808abee4-7390-4acf-aa77-03e75b301a96"},{"name":"Method Not Found Test","id":"bd1f0f7d-4e8a-42c8-a602-32142c1d285b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"method-test-006\",\n \"method\": \"invalid/method\",\n \"params\": {}\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/a2a/health","description":"

Purpose: This request verifies A2A JSON-RPC error handling when a client calls a non-existent RPC method. It sends a JSON-RPC 2.0 POST to /api/a2a/health.

Request body schema:\n{\n \"jsonrpc\": \"2.0\",\n \"id\": string (client-generated request id),\n \"method\": string (RPC method name, e.g. 'execute' or 'health-check'),\n \"params\": object (method parameters; may be empty)\n}

Valid method examples:

'execute'
'health.check'
'health.status'
'status'\n(Check API docs for full list.)

Expected responses:

Success (200 with result): {\"jsonrpc\":\"2.0\",\"id\":,\"result\":{...}}
Method not found (200 with error): {\"jsonrpc\":\"2.0\",\"id\":,\"error\":{\"code\":-32601,\"message\":\"Method not found\",\"data\":{}}}
Invalid Request (400 or 200 with error code -32600)
Parse error (400 or error code -32700)

Troubleshooting:

Ensure {{base_url}} is set to the correct environment variable (global: base_url or baseURL).
Confirm the method name is supported by the server.
Check Content-Type header is application/json.
Use the collection's valid example ids: execute-test-002, health-test-001, test-004 for id field when reproducing tests.

Notes: This request currently intentionally uses an invalid method to demonstrate the 'Method not found' error. Update the 'method' field to a supported RPC method to test successful responses.

\n","urlObject":{"path":["a2a","health"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bd1f0f7d-4e8a-42c8-a602-32142c1d285b"}]}