Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@
"group": "Providers",
"pages": [
"openhands/usage/llms/openhands-llms",
"openhands/usage/llms/aws-bedrock",
"openhands/usage/llms/azure-llms",
"openhands/usage/llms/google-llms",
"openhands/usage/llms/groq",
Expand Down
48 changes: 45 additions & 3 deletions openapi/agent-sdk.json
Original file line number Diff line number Diff line change
Expand Up @@ -1489,14 +1489,14 @@
}
}
},
"/api/bash/execute_bash_command": {
"/api/bash/start_bash_command": {
"post": {
"tags": [
"Bash"
],
"summary": "Start Bash Command",
"description": "Execute a bash command",
"operationId": "start_bash_command_api_bash_execute_bash_command_post",
"description": "Execute a bash command in the background",
"operationId": "start_bash_command_api_bash_start_bash_command_post",
"requestBody": {
"content": {
"application/json": {
Expand Down Expand Up @@ -1531,6 +1531,48 @@
}
}
},
"/api/bash/execute_bash_command": {
"post": {
"tags": [
"Bash"
],
"summary": "Execute Bash Command",
"description": "Execute a bash command and wait for a result",
"operationId": "execute_bash_command_api_bash_execute_bash_command_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ExecuteBashRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BashOutput"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/bash/bash_events": {
"delete": {
"tags": [
Expand Down
25 changes: 25 additions & 0 deletions openhands/usage/llms/aws-bedrock.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: AWS Bedrock
description: OpenHands can work with AWS Bedrock models using an OpenAI-compatible API endpoint.
---

## Configuration

AWS Bedrock provides OpenAI-compatible API endpoints for their models. You can find their documentation on using the OpenAI Chat Completions API [here](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-chat-completions.html).

To configure OpenHands to use AWS Bedrock:

1. In the OpenHands UI, navigate to Settings under the `LLM` tab
2. Enable `Advanced` options
3. Set the following:
- `Custom Model` to `openai/{model_name}` (e.g. `openai/anthropic.claude-3-5-sonnet-20240620-v1:0`)
- `Base URL` to `https://bedrock-runtime.{region}.amazonaws.com/openai/v1` (e.g. `https://bedrock-runtime.us-west-2.amazonaws.com/openai/v1`)
- `API Key` to your AWS Bedrock API key

<Note>
The `openai/` prefix in the Custom Model field indicates that OpenHands should use an OpenAI-compatible API format. It does not mean you are directly calling the OpenAI provider.
</Note>

<Note>
Replace `{region}` with your desired AWS region (e.g., `us-west-2`, `us-east-1`). Ensure the region you specify matches where your Bedrock models are available.
</Note>