# Demand from the agent and get a fast ack response, use callback to receive the completion response

Requests Wabee AI Agent to answer a question asynchronously.
    If a callback_url is provided, the agent will send the response to the given URL.
    
    The agent can make use of any of the available tools along with its own reasoning to complete the given task, depending on its complexity, the response might take some time to be returned to the user.
    
    Note: session_id field on request body is kept for compatibility purposes, it will be overwritten with the header value during request processing
    Note: stream filed on request body is kept for compatibility purposes, it will be ignored during request processing

Endpoint: POST /core/v1/chain_async
Version: v1
Security: APIKeyHeader

## Request fields (application/json):

  - `specversion` (string, required)
    The version of the CloudEvents spec.
    Example: "1.0"

  - `type` (string)
    The type of the event. Use the value 'ai.wabee.agent.chain' for chain requests.

  - `source` (string, required)
    The source of the event.
    Example: "https://wabee.ai/agent"

  - `id` (string, required)
    A unique identifier for the event.
    Example: "A234-1234-1234"

  - `time` (string, required)
    The time the event was created.
    Example: "2018-04-05T17:31:00Z"

  - `data` (object, required)
    The data of the event.

  - `data.messages` (array, required)
    List of messages to be processed by the agent
    Example: [{"content":"What is the economic outlook?","role":"user"}]

  - `data.messages.role` (string, required)
    defines the role associated with the message
    Example: "assistant"

  - `data.messages.content` (string, required)
    message content
    Example: "Hello, I am your virtual assistant"

  - `data.data_filter_hints` (any)
    Special metadata-like hints to be passed to the agent in order to instruct him on how to filter the data on some tools that support filter
    Example: [{"filter_key":"unitname","filter_type":"equals","filter_value":"Unit 1","tool_name":"bubble_data"}]

  - `data.auto_memory_retain` (boolean)
    Indicates whether the agent should automatically retain information from the session in memory. When enabled, allows the agent to learn from experiences and feedback.

  - `data.context_files` (any)
    The path for files which the agent already has access to and should be considered by it when processing the messages
    Example: ["inputs/chat-files/test123/file.pdf"]

  - `data.images` (any)
    List of images associated with the message

  - `data.session_id` (any)
    An optional session ID to associate with the chain. This can be used to track multiple interactions with the chain across different requests. If not provided, a session ID will be generated.

  - `data.callback_url` (any)
    An optional callback URL to send the response to.

## Response 422 fields (application/json):

  - `body` (string, required)
    Error message or description

  - `status_code` (integer, required)
    HTTP status code
    Example: 400

  - `details` (any)
    Additional error details if available