Overview The /api/chat endpoint invokes an Amazon Bedrock agent with user messages and returns the agent’s streaming response. This endpoint handles session management, AWS authentication, and message processing.
Endpoint Request Body The request must be sent as JSON with the following structure:
AWS region where your Bedrock agent is deployed (e.g., us-east-1)
The unique identifier of your Bedrock agent
The alias ID of your Bedrock agent (e.g., TSTALIASID)
AWS Access Key ID for authentication
AWS Secret Access Key for authentication
Optional AWS Session Token for temporary credentials
Optional session ID for continuing a conversation. If not provided, a new UUID will be generated.
Array of message objects with role (“user” or “assistant”) and content (string)
Request Example { "region" : "us-east-1" , "agentId" : "ABCDEFGHIJ" , "agentAliasId" : "TSTALIASID" , "accessKeyId" : "AKIAIOSFODNN7EXAMPLE" , "secretAccessKey" : "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" , "sessionToken" : "" , "sessionId" : "123e4567-e89b-12d3-a456-426614174000" , "messages" : [ { "role" : "user" , "content" : "What is the capital of France?" } ] }
Response Success Response (200 OK) The agent’s response text, with null bytes removed and whitespace trimmed
The session ID used for this conversation (either provided or generated)
{ "reply" : "The capital of France is Paris." , "sessionId" : "123e4567-e89b-12d3-a456-426614174000" }
Error Responses 400 Bad Request - Missing Parameters { "error" : "Faltan parámetros de configuración del agente Bedrock." }
Returned when required fields (region, agentId, agentAliasId, accessKeyId, or secretAccessKey) are missing.
400 Bad Request - No Messages { "error" : "No hay mensajes para enviar." }
Returned when the messages array is empty or contains no user messages with content.
500 Internal Server Error { "error" : "Error message from AWS or internal error" }
Returned when there’s an error communicating with Bedrock or processing the request.
Implementation Details Message Processing The endpoint extracts the latest user message from the messages array:
const latestUserMessage = [ ... ( body . messages || [])] . reverse () . find (( item ) => item ?. role === 'user' && item ?. content ?. trim ());
Session Management If no sessionId is provided, the endpoint generates a new UUID:
const sessionId = body . sessionId ?. trim () || crypto . randomUUID ();
Streaming Response The endpoint processes the streaming response from Bedrock:
const response = await client . send ( command ); const decoder = new TextDecoder (); let reply = '' ; if ( response . completion ) { for await ( const chunkEvent of response . completion ) { const bytes = chunkEvent . chunk ?. bytes ; if ( bytes ) { reply += decoder . decode ( bytes , { stream: true }); } } reply += decoder . decode (); } const normalizedReply = reply . replace ( / \u0000 / g , '' ). trim ();
cURL Example curl -X POST https://your-domain.com/api/chat \ -H "Content-Type: application/json" \ -d '{ "region": "us-east-1", "agentId": "ABCDEFGHIJ", "agentAliasId": "TSTALIASID", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "messages": [ { "role": "user", "content": "Hello, how are you?" } ] }'
JavaScript Example const response = await fetch ( '/api/chat' , { method: 'POST' , headers: { 'Content-Type' : 'application/json' }, body: JSON . stringify ({ region: 'us-east-1' , agentId: 'ABCDEFGHIJ' , agentAliasId: 'TSTALIASID' , accessKeyId: 'AKIAIOSFODNN7EXAMPLE' , secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY' , sessionId: '123e4567-e89b-12d3-a456-426614174000' , messages: [ { role: 'user' , content: 'What is machine learning?' } ] }) }); const data = await response . json (); console . log ( data . reply ); console . log ( data . sessionId );
Chat Interface Learn about the chat interface that uses this API
Bedrock Agent Configuration Configure your Bedrock agent settings
