[New Service]: aws_bedrockagent

[jgard]

Description

Support for Bedrock Agent configuration

Requested Resource(s) and/or Data Source(s)

resources

• aws_bedrockagent_agent
• aws_bedrockagent_action_group
• aws_bedrockagent_agent_alias
• aws_bedrockagent_knowledge_base
• aws_bedrockagent_agent_knowledge_base_association
• aws_bedrockagent_data_source

(and data sources for each)

Potential Terraform Configuration

resource "aws_bedrockagent" "this" {
  name="my_agent"
  instruction="I am a bedrock agent(...)"
  foundation_model="anthropic.claude-instant-v1"
  description="My agent description"
  idle_session_ttl_seconds=1800
  resource_role_arn = "arn:aws:iam:::roles/myagentrole"
  tags {
    mytag="myvalue"
  }
  #customer_encryption_key_arn = ""
  #prompt_override_configuration {}
}

resource "aws_bedrockagent_action_group" "this" {
  name="my_agent_action_group"
  description="My agent action group description"
  parent_action_group_signature = "AMAZON.UserInput"
  action_group_executor {
    lambda="arn:aws:lambda:region:account:function:my-agent-lambda"
  }
  api_schema = {
    s3 {
      bucket_name="my-agent-bucket"
      key = "my-agent.json"
    }
    #payload = jsonencode({}) #alternative, direct upload
  }
  state="ENABLED"
}

resource "aws_bedrockagent_alias" "this" {
  agent_id = aws_bedrock_agent.this.id
  name = "my_agent_alias"
}

resource "aws_bedrockagent_knowledge_base" "this" {
  name = "my_knowledge_base"
  description = "My bedrock knowledge base"
  role_arn = "arn:aws:iam::account:role/AmazonBedrockExecutionRoleForKnowledgeBase_my_agent"
  configuration {
    type = "VECTOR"
    vector_knowledge_base_configuration {
      embedding_model_arn = "arn:aws:bedrock:REGION::foundation-model/my-embedding-model"
    }
  }
  storage_configuration {
    type="OPENSEARCH_SERVERLESS"
    opensearch_serverless_configuration {
      collection_arn = "arn:aws:aoss:REGION:ACCOUNT:collection/my-collection"
      vectorIndexName = "bedrock-knowledge-base-default-index"
      field_mapping {
        vector_field = "bedrock-knowledge-base-default-vector"
        text_field = "AMAZON_BEDROCK_TEXT_CHUNK"
        metadata_field = "AMAZON_BEDROCK_METADATA"
      }
    }
  }
  tags {
    mytag="myvalue"
  }
}

resource "aws_bedrockagent_data_source" "this" {
  knowledge_base_id = aws_bedrock_knowledge_base.this.id
  name = "my_data_source"
  description = "My bedrock datasource"
  configuration {
    type = "S3"
    s3_configuration {
      bucket_arn = "arn:aws:s3:::my-data-source-bucket"
      inclusion_prefixes = ["prefix1","prefix2"]
    }
  }
  #server_side_encryption_configuration {
  #  kms_key_arn = ""
  #}
  vector_ingestion_configuration {
    chunking_configuration {
      chunking_strategy = "FIXED_SIZE"
      fixed_size_chunking_configuration {
        max_tokens = 300
        overlap_percentage = 5
      }
    }
  }
}

resource "aws_bedrockagent_knowledge_base_association" "this" {
  agent_id = aws_bedrock_agent.this.id
  agent_version = "my_agent_version"
  knowledge_base_id = aws_bedrock_agent_knowledge_base.this.id
  description = "helps answer questions for the agent on this specific subject"
  state = "ENABLED"
}

References

• https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html
• https://docs.aws.amazon.com/cli/latest/reference/bedrock-agent/

Would you like to implement a fix?

None

[github-actions]

Community Note

Voting for Prioritization

• Please vote on this issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize this request.
• Please see our prioritization guide for information on how we prioritize.
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.

[nrnrk]

Is anyone working on this? If not, I'd like to.

[ewbankkit]

The new resources should use aws_bedrockagent_ as a prefix, not aws_bedrock_agent.

[theolrtpwc]

I don't see all these terraform resource blocks available on aws-provider v5.38.0.
But it is mentioned here that they have been added to v5.36.0.
Can anyone shed some light on this?

[nrnrk]

Resource implementations are not done yet. I'm working on aws_bedrockagent_agent resource now.

[theolrtpwc]

Do you have any idea of the release date of this feature ?

[kpx-dev]

@nrnrk thanks for your awesome work on this. I’m also very interested in adopting this soon. Can you please help share ETA or anything else I can help to speed this up?

[theolrtpwc]

thanks @nrnrk ! I’m eager to adopt it soon. Could you please provide an ETA or any other information that might help accelerate its progress?

[github-actions]

Warning

This issue has been closed, meaning that any additional comments are hard for our team to see. Please assume that the maintainers will not see them.

Ongoing conversations amongst community members are welcome, however, the issue will be locked after 30 days. Moving conversations to another venue, such as the AWS Provider forum, is recommended. If you have additional concerns, please open a new issue, referencing this one where needed.

[github-actions]

Warning

This issue has been closed, meaning that any additional comments are hard for our team to see. Please assume that the maintainers will not see them.

Ongoing conversations amongst community members are welcome, however, the issue will be locked after 30 days. Moving conversations to another venue, such as the AWS Provider forum, is recommended. If you have additional concerns, please open a new issue, referencing this one where needed.

[github-actions]

This functionality has been released in v5.49.0 of the Terraform AWS Provider. Please see the Terraform documentation on provider versioning or reach out if you need any assistance upgrading.

For further feature requests or bug reports with this functionality, please create a new GitHub issue following the template. Thank you!

[ixolt]

it seems to me it was missed aws_bedrockagent_knowledge_base_data_source resource

[purplexed]

@ixolt I think this is covered by the aws_bedrockagent_data_source.

However, there are a few issues with that:

1. The documentation is just the default generated template, I raised a ticket for that: [Docs]: aws_bedrockagent_data_source doc is rather empty #37420
2. The example shown above in the thread is wrong, the resource expects data_source_configuration instead of the configuration block.
3. The import doesn't look like it's working with just the data source ID, but instead it has to be in the form of data_source_id,knowledge_base_id.

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.