aws-sdk-bedrockagentcorecontrol 1.51.0

AWS SDK for Amazon Bedrock AgentCore Control
Documentation
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_harness::_create_harness_input::CreateHarnessInputBuilder;

pub use crate::operation::create_harness::_create_harness_output::CreateHarnessOutputBuilder;

impl crate::operation::create_harness::builders::CreateHarnessInputBuilder {
    /// Sends a request with this input using the given client.
    pub async fn send_with(
        self,
        client: &crate::Client,
    ) -> ::std::result::Result<
        crate::operation::create_harness::CreateHarnessOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::create_harness::CreateHarnessError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let mut fluent_builder = client.create_harness();
        fluent_builder.inner = self;
        fluent_builder.send().await
    }
}
/// Fluent builder constructing a request to `CreateHarness`.
///
/// <p>Operation to create a Harness.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct CreateHarnessFluentBuilder {
    handle: ::std::sync::Arc<crate::client::Handle>,
    inner: crate::operation::create_harness::builders::CreateHarnessInputBuilder,
    config_override: ::std::option::Option<crate::config::Builder>,
}
impl
    crate::client::customize::internal::CustomizableSend<
        crate::operation::create_harness::CreateHarnessOutput,
        crate::operation::create_harness::CreateHarnessError,
    > for CreateHarnessFluentBuilder
{
    fn send(
        self,
        config_override: crate::config::Builder,
    ) -> crate::client::customize::internal::BoxFuture<
        crate::client::customize::internal::SendResult<
            crate::operation::create_harness::CreateHarnessOutput,
            crate::operation::create_harness::CreateHarnessError,
        >,
    > {
        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
    }
}
impl CreateHarnessFluentBuilder {
    /// Creates a new `CreateHarnessFluentBuilder`.
    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
        Self {
            handle,
            inner: ::std::default::Default::default(),
            config_override: ::std::option::Option::None,
        }
    }
    /// Access the CreateHarness as a reference.
    pub fn as_input(&self) -> &crate::operation::create_harness::builders::CreateHarnessInputBuilder {
        &self.inner
    }
    /// Sends the request and returns the response.
    ///
    /// If an error occurs, an `SdkError` will be returned with additional details that
    /// can be matched against.
    ///
    /// By default, any retryable failures will be retried twice. Retry behavior
    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
    /// set when configuring the client.
    pub async fn send(
        self,
    ) -> ::std::result::Result<
        crate::operation::create_harness::CreateHarnessOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::create_harness::CreateHarnessError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let input = self
            .inner
            .build()
            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
        let runtime_plugins = crate::operation::create_harness::CreateHarness::operation_runtime_plugins(
            self.handle.runtime_plugins.clone(),
            &self.handle.conf,
            self.config_override,
        );
        crate::operation::create_harness::CreateHarness::orchestrate(&runtime_plugins, input).await
    }

    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
    pub fn customize(
        self,
    ) -> crate::client::customize::CustomizableOperation<
        crate::operation::create_harness::CreateHarnessOutput,
        crate::operation::create_harness::CreateHarnessError,
        Self,
    > {
        crate::client::customize::CustomizableOperation::new(self)
    }
    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
        self.set_config_override(::std::option::Option::Some(config_override.into()));
        self
    }

    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
        self.config_override = config_override;
        self
    }
    /// <p>The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.</p>
    pub fn harness_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.harness_name(input.into());
        self
    }
    /// <p>The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.</p>
    pub fn set_harness_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_harness_name(input);
        self
    }
    /// <p>The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.</p>
    pub fn get_harness_name(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_harness_name()
    }
    /// <p>A unique, case-sensitive identifier to ensure idempotency of the request.</p>
    pub fn client_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.client_token(input.into());
        self
    }
    /// <p>A unique, case-sensitive identifier to ensure idempotency of the request.</p>
    pub fn set_client_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_client_token(input);
        self
    }
    /// <p>A unique, case-sensitive identifier to ensure idempotency of the request.</p>
    pub fn get_client_token(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_client_token()
    }
    /// <p>The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.</p>
    pub fn execution_role_arn(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.execution_role_arn(input.into());
        self
    }
    /// <p>The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.</p>
    pub fn set_execution_role_arn(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_execution_role_arn(input);
        self
    }
    /// <p>The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.</p>
    pub fn get_execution_role_arn(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_execution_role_arn()
    }
    /// <p>The compute environment configuration for the harness, including network and lifecycle settings.</p>
    pub fn environment(mut self, input: crate::types::HarnessEnvironmentProviderRequest) -> Self {
        self.inner = self.inner.environment(input);
        self
    }
    /// <p>The compute environment configuration for the harness, including network and lifecycle settings.</p>
    pub fn set_environment(mut self, input: ::std::option::Option<crate::types::HarnessEnvironmentProviderRequest>) -> Self {
        self.inner = self.inner.set_environment(input);
        self
    }
    /// <p>The compute environment configuration for the harness, including network and lifecycle settings.</p>
    pub fn get_environment(&self) -> &::std::option::Option<crate::types::HarnessEnvironmentProviderRequest> {
        self.inner.get_environment()
    }
    /// <p>The environment artifact for the harness, such as a custom container image containing additional dependencies.</p>
    pub fn environment_artifact(mut self, input: crate::types::HarnessEnvironmentArtifact) -> Self {
        self.inner = self.inner.environment_artifact(input);
        self
    }
    /// <p>The environment artifact for the harness, such as a custom container image containing additional dependencies.</p>
    pub fn set_environment_artifact(mut self, input: ::std::option::Option<crate::types::HarnessEnvironmentArtifact>) -> Self {
        self.inner = self.inner.set_environment_artifact(input);
        self
    }
    /// <p>The environment artifact for the harness, such as a custom container image containing additional dependencies.</p>
    pub fn get_environment_artifact(&self) -> &::std::option::Option<crate::types::HarnessEnvironmentArtifact> {
        self.inner.get_environment_artifact()
    }
    ///
    /// Adds a key-value pair to `environmentVariables`.
    ///
    /// To override the contents of this collection use [`set_environment_variables`](Self::set_environment_variables).
    ///
    /// <p>Environment variables to set in the harness runtime environment.</p>
    pub fn environment_variables(
        mut self,
        k: impl ::std::convert::Into<::std::string::String>,
        v: impl ::std::convert::Into<::std::string::String>,
    ) -> Self {
        self.inner = self.inner.environment_variables(k.into(), v.into());
        self
    }
    /// <p>Environment variables to set in the harness runtime environment.</p>
    pub fn set_environment_variables(
        mut self,
        input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
    ) -> Self {
        self.inner = self.inner.set_environment_variables(input);
        self
    }
    /// <p>Environment variables to set in the harness runtime environment.</p>
    pub fn get_environment_variables(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
        self.inner.get_environment_variables()
    }
    /// <p>Represents inbound authorization configuration options used to authenticate incoming requests.</p>
    pub fn authorizer_configuration(mut self, input: crate::types::AuthorizerConfiguration) -> Self {
        self.inner = self.inner.authorizer_configuration(input);
        self
    }
    /// <p>Represents inbound authorization configuration options used to authenticate incoming requests.</p>
    pub fn set_authorizer_configuration(mut self, input: ::std::option::Option<crate::types::AuthorizerConfiguration>) -> Self {
        self.inner = self.inner.set_authorizer_configuration(input);
        self
    }
    /// <p>Represents inbound authorization configuration options used to authenticate incoming requests.</p>
    pub fn get_authorizer_configuration(&self) -> &::std::option::Option<crate::types::AuthorizerConfiguration> {
        self.inner.get_authorizer_configuration()
    }
    /// <p>The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.</p>
    pub fn model(mut self, input: crate::types::HarnessModelConfiguration) -> Self {
        self.inner = self.inner.model(input);
        self
    }
    /// <p>The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.</p>
    pub fn set_model(mut self, input: ::std::option::Option<crate::types::HarnessModelConfiguration>) -> Self {
        self.inner = self.inner.set_model(input);
        self
    }
    /// <p>The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.</p>
    pub fn get_model(&self) -> &::std::option::Option<crate::types::HarnessModelConfiguration> {
        self.inner.get_model()
    }
    ///
    /// Appends an item to `systemPrompt`.
    ///
    /// To override the contents of this collection use [`set_system_prompt`](Self::set_system_prompt).
    ///
    /// <p>The system prompt that defines the agent's behavior and instructions.</p>
    pub fn system_prompt(mut self, input: crate::types::HarnessSystemContentBlock) -> Self {
        self.inner = self.inner.system_prompt(input);
        self
    }
    /// <p>The system prompt that defines the agent's behavior and instructions.</p>
    pub fn set_system_prompt(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::HarnessSystemContentBlock>>) -> Self {
        self.inner = self.inner.set_system_prompt(input);
        self
    }
    /// <p>The system prompt that defines the agent's behavior and instructions.</p>
    pub fn get_system_prompt(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::HarnessSystemContentBlock>> {
        self.inner.get_system_prompt()
    }
    ///
    /// Appends an item to `tools`.
    ///
    /// To override the contents of this collection use [`set_tools`](Self::set_tools).
    ///
    /// <p>The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.</p>
    pub fn tools(mut self, input: crate::types::HarnessTool) -> Self {
        self.inner = self.inner.tools(input);
        self
    }
    /// <p>The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.</p>
    pub fn set_tools(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::HarnessTool>>) -> Self {
        self.inner = self.inner.set_tools(input);
        self
    }
    /// <p>The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.</p>
    pub fn get_tools(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::HarnessTool>> {
        self.inner.get_tools()
    }
    ///
    /// Appends an item to `skills`.
    ///
    /// To override the contents of this collection use [`set_skills`](Self::set_skills).
    ///
    /// <p>The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.</p>
    pub fn skills(mut self, input: crate::types::HarnessSkill) -> Self {
        self.inner = self.inner.skills(input);
        self
    }
    /// <p>The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.</p>
    pub fn set_skills(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::HarnessSkill>>) -> Self {
        self.inner = self.inner.set_skills(input);
        self
    }
    /// <p>The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.</p>
    pub fn get_skills(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::HarnessSkill>> {
        self.inner.get_skills()
    }
    ///
    /// Appends an item to `allowedTools`.
    ///
    /// To override the contents of this collection use [`set_allowed_tools`](Self::set_allowed_tools).
    ///
    /// <p>The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.</p>
    pub fn allowed_tools(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.allowed_tools(input.into());
        self
    }
    /// <p>The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.</p>
    pub fn set_allowed_tools(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
        self.inner = self.inner.set_allowed_tools(input);
        self
    }
    /// <p>The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.</p>
    pub fn get_allowed_tools(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
        self.inner.get_allowed_tools()
    }
    /// <p>The AgentCore Memory configuration for persisting conversation context across sessions.</p>
    pub fn memory(mut self, input: crate::types::HarnessMemoryConfiguration) -> Self {
        self.inner = self.inner.memory(input);
        self
    }
    /// <p>The AgentCore Memory configuration for persisting conversation context across sessions.</p>
    pub fn set_memory(mut self, input: ::std::option::Option<crate::types::HarnessMemoryConfiguration>) -> Self {
        self.inner = self.inner.set_memory(input);
        self
    }
    /// <p>The AgentCore Memory configuration for persisting conversation context across sessions.</p>
    pub fn get_memory(&self) -> &::std::option::Option<crate::types::HarnessMemoryConfiguration> {
        self.inner.get_memory()
    }
    /// <p>The truncation configuration for managing conversation context when it exceeds model limits.</p>
    pub fn truncation(mut self, input: crate::types::HarnessTruncationConfiguration) -> Self {
        self.inner = self.inner.truncation(input);
        self
    }
    /// <p>The truncation configuration for managing conversation context when it exceeds model limits.</p>
    pub fn set_truncation(mut self, input: ::std::option::Option<crate::types::HarnessTruncationConfiguration>) -> Self {
        self.inner = self.inner.set_truncation(input);
        self
    }
    /// <p>The truncation configuration for managing conversation context when it exceeds model limits.</p>
    pub fn get_truncation(&self) -> &::std::option::Option<crate::types::HarnessTruncationConfiguration> {
        self.inner.get_truncation()
    }
    /// <p>The maximum number of iterations the agent loop can execute per invocation.</p>
    pub fn max_iterations(mut self, input: i32) -> Self {
        self.inner = self.inner.max_iterations(input);
        self
    }
    /// <p>The maximum number of iterations the agent loop can execute per invocation.</p>
    pub fn set_max_iterations(mut self, input: ::std::option::Option<i32>) -> Self {
        self.inner = self.inner.set_max_iterations(input);
        self
    }
    /// <p>The maximum number of iterations the agent loop can execute per invocation.</p>
    pub fn get_max_iterations(&self) -> &::std::option::Option<i32> {
        self.inner.get_max_iterations()
    }
    /// <p>The maximum total number of output tokens the agent can generate across all model calls within a single invocation.</p>
    pub fn max_tokens(mut self, input: i32) -> Self {
        self.inner = self.inner.max_tokens(input);
        self
    }
    /// <p>The maximum total number of output tokens the agent can generate across all model calls within a single invocation.</p>
    pub fn set_max_tokens(mut self, input: ::std::option::Option<i32>) -> Self {
        self.inner = self.inner.set_max_tokens(input);
        self
    }
    /// <p>The maximum total number of output tokens the agent can generate across all model calls within a single invocation.</p>
    pub fn get_max_tokens(&self) -> &::std::option::Option<i32> {
        self.inner.get_max_tokens()
    }
    /// <p>The maximum duration in seconds for the agent loop execution per invocation.</p>
    pub fn timeout_seconds(mut self, input: i32) -> Self {
        self.inner = self.inner.timeout_seconds(input);
        self
    }
    /// <p>The maximum duration in seconds for the agent loop execution per invocation.</p>
    pub fn set_timeout_seconds(mut self, input: ::std::option::Option<i32>) -> Self {
        self.inner = self.inner.set_timeout_seconds(input);
        self
    }
    /// <p>The maximum duration in seconds for the agent loop execution per invocation.</p>
    pub fn get_timeout_seconds(&self) -> &::std::option::Option<i32> {
        self.inner.get_timeout_seconds()
    }
    ///
    /// Adds a key-value pair to `tags`.
    ///
    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
    ///
    /// <p>Tags to apply to the harness resource.</p>
    pub fn tags(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.tags(k.into(), v.into());
        self
    }
    /// <p>Tags to apply to the harness resource.</p>
    pub fn set_tags(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
        self.inner = self.inner.set_tags(input);
        self
    }
    /// <p>Tags to apply to the harness resource.</p>
    pub fn get_tags(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
        self.inner.get_tags()
    }
}