aws_sdk_bedrockagent/client/
update_agent.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`UpdateAgent`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`agent_id(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::agent_id) / [`set_agent_id(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_agent_id):<br>required: **true**<br><p>The unique identifier of the agent.</p><br>
    ///   - [`agent_name(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::agent_name) / [`set_agent_name(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_agent_name):<br>required: **true**<br><p>Specifies a new name for the agent.</p><br>
    ///   - [`instruction(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::instruction) / [`set_instruction(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_instruction):<br>required: **false**<br><p>Specifies new instructions that tell the agent what it should do and how it should interact with users.</p><br>
    ///   - [`foundation_model(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::foundation_model) / [`set_foundation_model(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_foundation_model):<br>required: **true**<br><p>The identifier for the model that you want to be used for orchestration by the agent you create.</p> <p>The <code>modelId</code> to provide depends on the type of model or throughput that you use:</p> <ul>  <li>   <p>If you use a base model, specify the model ID or its ARN. For a list of model IDs for base models, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns">Amazon Bedrock base model IDs (on-demand throughput)</a> in the Amazon Bedrock User Guide.</p></li>  <li>   <p>If you use an inference profile, specify the inference profile ID or its ARN. For a list of inference profile IDs, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference-support.html">Supported Regions and models for cross-region inference</a> in the Amazon Bedrock User Guide.</p></li>  <li>   <p>If you use a provisioned model, specify the ARN of the Provisioned Throughput. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html">Run inference using a Provisioned Throughput</a> in the Amazon Bedrock User Guide.</p></li>  <li>   <p>If you use a custom model, first purchase Provisioned Throughput for it. Then specify the ARN of the resulting provisioned model. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html">Use a custom model in Amazon Bedrock</a> in the Amazon Bedrock User Guide.</p></li>  <li>   <p>If you use an <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-import-model.html">imported model</a>, specify the ARN of the imported model. You can get the model ARN from a successful call to <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateModelImportJob.html">CreateModelImportJob</a> or from the Imported models page in the Amazon Bedrock console.</p></li> </ul><br>
    ///   - [`description(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_description):<br>required: **false**<br><p>Specifies a new description of the agent.</p><br>
    ///   - [`orchestration_type(OrchestrationType)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::orchestration_type) / [`set_orchestration_type(Option<OrchestrationType>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_orchestration_type):<br>required: **false**<br><p>Specifies the type of orchestration strategy for the agent. This is set to <code>DEFAULT</code> orchestration type, by default.</p><br>
    ///   - [`custom_orchestration(CustomOrchestration)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::custom_orchestration) / [`set_custom_orchestration(Option<CustomOrchestration>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_custom_orchestration):<br>required: **false**<br><p>Contains details of the custom orchestration configured for the agent.</p><br>
    ///   - [`idle_session_ttl_in_seconds(i32)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::idle_session_ttl_in_seconds) / [`set_idle_session_ttl_in_seconds(Option<i32>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_idle_session_ttl_in_seconds):<br>required: **false**<br><p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p> <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p><br>
    ///   - [`agent_resource_role_arn(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::agent_resource_role_arn) / [`set_agent_resource_role_arn(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_agent_resource_role_arn):<br>required: **true**<br><p>The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the agent.</p><br>
    ///   - [`customer_encryption_key_arn(impl Into<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::customer_encryption_key_arn) / [`set_customer_encryption_key_arn(Option<String>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_customer_encryption_key_arn):<br>required: **false**<br><p>The Amazon Resource Name (ARN) of the KMS key with which to encrypt the agent.</p><br>
    ///   - [`prompt_override_configuration(PromptOverrideConfiguration)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::prompt_override_configuration) / [`set_prompt_override_configuration(Option<PromptOverrideConfiguration>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_prompt_override_configuration):<br>required: **false**<br><p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p><br>
    ///   - [`guardrail_configuration(GuardrailConfiguration)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::guardrail_configuration) / [`set_guardrail_configuration(Option<GuardrailConfiguration>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_guardrail_configuration):<br>required: **false**<br><p>The unique Guardrail configuration assigned to the agent when it is updated.</p><br>
    ///   - [`memory_configuration(MemoryConfiguration)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::memory_configuration) / [`set_memory_configuration(Option<MemoryConfiguration>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_memory_configuration):<br>required: **false**<br><p>Specifies the new memory configuration for the agent.</p><br>
    ///   - [`agent_collaboration(AgentCollaboration)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::agent_collaboration) / [`set_agent_collaboration(Option<AgentCollaboration>)`](crate::operation::update_agent::builders::UpdateAgentFluentBuilder::set_agent_collaboration):<br>required: **false**<br><p>The agent's collaboration role.</p><br>
    /// - On success, responds with [`UpdateAgentOutput`](crate::operation::update_agent::UpdateAgentOutput) with field(s):
    ///   - [`agent(Option<Agent>)`](crate::operation::update_agent::UpdateAgentOutput::agent): <p>Contains details about the agent that was updated.</p>
    /// - On failure, responds with [`SdkError<UpdateAgentError>`](crate::operation::update_agent::UpdateAgentError)
    pub fn update_agent(&self) -> crate::operation::update_agent::builders::UpdateAgentFluentBuilder {
        crate::operation::update_agent::builders::UpdateAgentFluentBuilder::new(self.handle.clone())
    }
}