Skip to content

Handle Flexible Agent Data

POST
/api/agent-communication/agent-data-flexible

Handle flexible agent data that can be string, dict, or list - demonstrates Union usage.

Processes various data formats using Union types and utility functions for comprehensive data handling and type demonstration across agent communication.

Args: agent_data (Union[str, Dict[str, object], List[object]]): Flexible input data

Returns: Dict[str, object]: Processed data with type information and validation

Any of:
string

Successful Response

FlexibleAgentDataResponse

Flexible agent data response model with fully typed fields.

Provides response structure for agent data operations with all fields explicitly defined for full type safety. Includes metadata and timestamp fields added during processing.

Fields:

  • status: Operation status (success/error)
  • data: Dictionary containing processed agent data
  • metadata: Dictionary containing processing metadata including:
    • original_data: Original input data
    • validation_passed: Boolean validation result
    • processing_method: Method used for processing
  • timestamp: ISO 8601 timestamp of processing operation

Usage: POST /api/agent-communication/agent-data-flexible returns this response model.

JSON Example:

{
  "status": "success",
  "data": {
    "agentId": "hawken",
    "capabilities": ["creative_writing"],
    "metrics": {"responseTime": 120.5}
  },
  "metadata": {
    "originalData": {"agentId": "hawken"},
    "validationPassed": true,
    "processingMethod": "utility_function"
  },
  "timestamp": "2025-01-31T10:30:00Z"
}
object
status
required
Status

Operation status

string
data
required

Processed agent data

object
key
additional properties
any
metadata
Any of:

Arbitrary JSON-shaped data. Flattened from a recursive type alias for wiki rendering — the live API accepts any JSON-compatible value (string, number, bool, null, array, or nested object).

object
key
additional properties
any
timestamp
Any of:
string

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object