Amazon Bedrock SWAIG tool webhook
Sent to a tool’s web_hook_url (or the SWAIG defaults.web_hook_url) when an
amazon_bedrock agent calls one of your functions.
Your endpoint runs the function and replies with a JSON object. Both fields are optional, so {}
is a valid reply:
response— the result the agent reads next. A plain string only here; the{tool_result, tool_prompt}object form thataiagents accept is not read. Omit it and the agent reads a default result.action— a single action object or an array of them, executed on the live call.
There is no post_process: a Bedrock agent always defers actions until after it has spoken.
Bedrock agents send a different payload from ai agents. Notably
content_type is text/json rather than text/swaig, argument carries no substituted value,
there is no version, description, or argument_desc, and the call’s timing and caller fields
are named differently. Write your handler against this payload, not the
AI SWAIG tool webhook.
Payload
The ID of the AI session on the call. Matches call_id for Bedrock agents.
The name of your Bedrock application. Defaults to bedrock.
The agent’s current global_data. Alongside anything you seeded, the session adds
caller_id_name and caller_id_number when the call carries them.
The content type of the request body. Always text/json.
How the body is delivered. Always agent.function for a function call.
The kind of conversation the agent is running. Always voice.
What the request is asking of you. Always fetch_conversation for a function call; the
end-of-call conversation report sends post_conversation instead.
The token that scopes meta_data. This is the meta_data_token you set on the function, or an
MD5 of the function’s name when you did not set one.
Metadata scoped to meta_data_token. An empty object when the function has none yet.
When the call was answered, as a Unix timestamp in microseconds. 0 when it never was.
When the call ended, as a Unix timestamp in microseconds. 0 while the call is still up.
Per-response performance metrics for the session so far. Included once the agent has any.