Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
oci.GenerativeAi.getAgentAgentEndpoint
Explore with Pulumi AI
This data source provides details about a specific Agent Endpoint resource in Oracle Cloud Infrastructure Generative Ai Agent service.
GetAgentEndpoint
Gets information about an endpoint.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testAgentEndpoint = oci.GenerativeAi.getAgentAgentEndpoint({
    agentEndpointId: testAgentEndpointOciGenerativeAiAgentAgentEndpoint.id,
});
import pulumi
import pulumi_oci as oci
test_agent_endpoint = oci.GenerativeAi.get_agent_agent_endpoint(agent_endpoint_id=test_agent_endpoint_oci_generative_ai_agent_agent_endpoint["id"])
package main
import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/generativeai"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := generativeai.GetAgentAgentEndpoint(ctx, &generativeai.GetAgentAgentEndpointArgs{
			AgentEndpointId: testAgentEndpointOciGenerativeAiAgentAgentEndpoint.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() => 
{
    var testAgentEndpoint = Oci.GenerativeAi.GetAgentAgentEndpoint.Invoke(new()
    {
        AgentEndpointId = testAgentEndpointOciGenerativeAiAgentAgentEndpoint.Id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.GenerativeAi.GenerativeAiFunctions;
import com.pulumi.oci.GenerativeAi.inputs.GetAgentAgentEndpointArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testAgentEndpoint = GenerativeAiFunctions.getAgentAgentEndpoint(GetAgentAgentEndpointArgs.builder()
            .agentEndpointId(testAgentEndpointOciGenerativeAiAgentAgentEndpoint.id())
            .build());
    }
}
variables:
  testAgentEndpoint:
    fn::invoke:
      function: oci:GenerativeAi:getAgentAgentEndpoint
      arguments:
        agentEndpointId: ${testAgentEndpointOciGenerativeAiAgentAgentEndpoint.id}
Using getAgentAgentEndpoint
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getAgentAgentEndpoint(args: GetAgentAgentEndpointArgs, opts?: InvokeOptions): Promise<GetAgentAgentEndpointResult>
function getAgentAgentEndpointOutput(args: GetAgentAgentEndpointOutputArgs, opts?: InvokeOptions): Output<GetAgentAgentEndpointResult>def get_agent_agent_endpoint(agent_endpoint_id: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetAgentAgentEndpointResult
def get_agent_agent_endpoint_output(agent_endpoint_id: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetAgentAgentEndpointResult]func LookupAgentAgentEndpoint(ctx *Context, args *LookupAgentAgentEndpointArgs, opts ...InvokeOption) (*LookupAgentAgentEndpointResult, error)
func LookupAgentAgentEndpointOutput(ctx *Context, args *LookupAgentAgentEndpointOutputArgs, opts ...InvokeOption) LookupAgentAgentEndpointResultOutput> Note: This function is named LookupAgentAgentEndpoint in the Go SDK.
public static class GetAgentAgentEndpoint 
{
    public static Task<GetAgentAgentEndpointResult> InvokeAsync(GetAgentAgentEndpointArgs args, InvokeOptions? opts = null)
    public static Output<GetAgentAgentEndpointResult> Invoke(GetAgentAgentEndpointInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetAgentAgentEndpointResult> getAgentAgentEndpoint(GetAgentAgentEndpointArgs args, InvokeOptions options)
public static Output<GetAgentAgentEndpointResult> getAgentAgentEndpoint(GetAgentAgentEndpointArgs args, InvokeOptions options)
fn::invoke:
  function: oci:GenerativeAi/getAgentAgentEndpoint:getAgentAgentEndpoint
  arguments:
    # arguments dictionaryThe following arguments are supported:
- AgentEndpoint stringId 
- The OCID of the endpoint.
- AgentEndpoint stringId 
- The OCID of the endpoint.
- agentEndpoint StringId 
- The OCID of the endpoint.
- agentEndpoint stringId 
- The OCID of the endpoint.
- agent_endpoint_ strid 
- The OCID of the endpoint.
- agentEndpoint StringId 
- The OCID of the endpoint.
getAgentAgentEndpoint Result
The following output properties are available:
- AgentEndpoint stringId 
- AgentId string
- The OCID of the agent that this endpoint is associated with.
- CompartmentId string
- The OCID of the compartment.
- ContentModeration List<GetConfigs Agent Agent Endpoint Content Moderation Config> 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- Dictionary<string, string>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Description string
- An optional description of the endpoint.
- DisplayName string
- A user-friendly name. Does not have to be unique, and it's changeable.
- Dictionary<string, string>
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- Id string
- The OCID of the endpoint.
- LifecycleDetails string
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- SessionConfigs List<GetAgent Agent Endpoint Session Config> 
- SessionConfig
- ShouldEnable boolCitation 
- Whether to show citations in the chat result.
- ShouldEnable boolSession 
- Whether or not to enable Session-based chat.
- ShouldEnable boolTrace 
- Whether to show traces in the chat result.
- State string
- The current state of the endpoint.
- Dictionary<string, string>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- TimeCreated string
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- TimeUpdated string
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- AgentEndpoint stringId 
- AgentId string
- The OCID of the agent that this endpoint is associated with.
- CompartmentId string
- The OCID of the compartment.
- ContentModeration []GetConfigs Agent Agent Endpoint Content Moderation Config 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- map[string]string
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Description string
- An optional description of the endpoint.
- DisplayName string
- A user-friendly name. Does not have to be unique, and it's changeable.
- map[string]string
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- Id string
- The OCID of the endpoint.
- LifecycleDetails string
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- SessionConfigs []GetAgent Agent Endpoint Session Config 
- SessionConfig
- ShouldEnable boolCitation 
- Whether to show citations in the chat result.
- ShouldEnable boolSession 
- Whether or not to enable Session-based chat.
- ShouldEnable boolTrace 
- Whether to show traces in the chat result.
- State string
- The current state of the endpoint.
- map[string]string
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- TimeCreated string
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- TimeUpdated string
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- agentEndpoint StringId 
- agentId String
- The OCID of the agent that this endpoint is associated with.
- compartmentId String
- The OCID of the compartment.
- contentModeration List<GetConfigs Agent Agent Endpoint Content Moderation Config> 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- Map<String,String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- description String
- An optional description of the endpoint.
- displayName String
- A user-friendly name. Does not have to be unique, and it's changeable.
- Map<String,String>
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- id String
- The OCID of the endpoint.
- lifecycleDetails String
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- sessionConfigs List<GetAgent Agent Endpoint Session Config> 
- SessionConfig
- shouldEnable BooleanCitation 
- Whether to show citations in the chat result.
- shouldEnable BooleanSession 
- Whether or not to enable Session-based chat.
- shouldEnable BooleanTrace 
- Whether to show traces in the chat result.
- state String
- The current state of the endpoint.
- Map<String,String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- timeCreated String
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- timeUpdated String
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- agentEndpoint stringId 
- agentId string
- The OCID of the agent that this endpoint is associated with.
- compartmentId string
- The OCID of the compartment.
- contentModeration GetConfigs Agent Agent Endpoint Content Moderation Config[] 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- {[key: string]: string}
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- description string
- An optional description of the endpoint.
- displayName string
- A user-friendly name. Does not have to be unique, and it's changeable.
- {[key: string]: string}
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- id string
- The OCID of the endpoint.
- lifecycleDetails string
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- sessionConfigs GetAgent Agent Endpoint Session Config[] 
- SessionConfig
- shouldEnable booleanCitation 
- Whether to show citations in the chat result.
- shouldEnable booleanSession 
- Whether or not to enable Session-based chat.
- shouldEnable booleanTrace 
- Whether to show traces in the chat result.
- state string
- The current state of the endpoint.
- {[key: string]: string}
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- timeCreated string
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- timeUpdated string
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- agent_endpoint_ strid 
- agent_id str
- The OCID of the agent that this endpoint is associated with.
- compartment_id str
- The OCID of the compartment.
- content_moderation_ Sequence[Getconfigs Agent Agent Endpoint Content Moderation Config] 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- Mapping[str, str]
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- description str
- An optional description of the endpoint.
- display_name str
- A user-friendly name. Does not have to be unique, and it's changeable.
- Mapping[str, str]
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- id str
- The OCID of the endpoint.
- lifecycle_details str
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- session_configs Sequence[GetAgent Agent Endpoint Session Config] 
- SessionConfig
- should_enable_ boolcitation 
- Whether to show citations in the chat result.
- should_enable_ boolsession 
- Whether or not to enable Session-based chat.
- should_enable_ booltrace 
- Whether to show traces in the chat result.
- state str
- The current state of the endpoint.
- Mapping[str, str]
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- time_created str
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- time_updated str
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- agentEndpoint StringId 
- agentId String
- The OCID of the agent that this endpoint is associated with.
- compartmentId String
- The OCID of the compartment.
- contentModeration List<Property Map>Configs 
- The configuration details about whether to apply the content moderation feature to input and output. Content moderation removes toxic and biased content from responses. It is recommended to use content moderation.
- Map<String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- description String
- An optional description of the endpoint.
- displayName String
- A user-friendly name. Does not have to be unique, and it's changeable.
- Map<String>
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
- id String
- The OCID of the endpoint.
- lifecycleDetails String
- A message that describes the current state of the endpoint in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
- sessionConfigs List<Property Map>
- SessionConfig
- shouldEnable BooleanCitation 
- Whether to show citations in the chat result.
- shouldEnable BooleanSession 
- Whether or not to enable Session-based chat.
- shouldEnable BooleanTrace 
- Whether to show traces in the chat result.
- state String
- The current state of the endpoint.
- Map<String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
- timeCreated String
- The date and time the AgentEndpoint was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
- timeUpdated String
- The date and time the endpoint was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z
Supporting Types
GetAgentAgentEndpointContentModerationConfig      
- ShouldEnable boolOn Input 
- A flag to enable or disable content moderation on input.
- ShouldEnable boolOn Output 
- A flag to enable or disable content moderation on output.
- ShouldEnable boolOn Input 
- A flag to enable or disable content moderation on input.
- ShouldEnable boolOn Output 
- A flag to enable or disable content moderation on output.
- shouldEnable BooleanOn Input 
- A flag to enable or disable content moderation on input.
- shouldEnable BooleanOn Output 
- A flag to enable or disable content moderation on output.
- shouldEnable booleanOn Input 
- A flag to enable or disable content moderation on input.
- shouldEnable booleanOn Output 
- A flag to enable or disable content moderation on output.
- should_enable_ boolon_ input 
- A flag to enable or disable content moderation on input.
- should_enable_ boolon_ output 
- A flag to enable or disable content moderation on output.
- shouldEnable BooleanOn Input 
- A flag to enable or disable content moderation on input.
- shouldEnable BooleanOn Output 
- A flag to enable or disable content moderation on output.
GetAgentAgentEndpointSessionConfig     
- IdleTimeout intIn Seconds 
- The session will become inactive after this timeout.
- IdleTimeout intIn Seconds 
- The session will become inactive after this timeout.
- idleTimeout IntegerIn Seconds 
- The session will become inactive after this timeout.
- idleTimeout numberIn Seconds 
- The session will become inactive after this timeout.
- idle_timeout_ intin_ seconds 
- The session will become inactive after this timeout.
- idleTimeout NumberIn Seconds 
- The session will become inactive after this timeout.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.