Added - Support for Oracle Cloud AI Service Generative AI Agent Service

Author: Sachin Goyal

examples/generative_ai_agent/agent.tf

@@ -0,0 +1,27 @@
+// Copyright (c) 2017, 2023, Oracle and/or its affiliates. All rights reserved.
+// Licensed under the Mozilla Public License v2.0
+
+resource "oci_generative_ai_agent_agent" "test_agent" {
+  #Required
+  compartment_id                 = var.compartment_ocid
+
+  #Optional
+  display_name                  = var.agent_display_name
+  description                   = var.agent_description
+  welcome_message               = var.agent_welcome_message
+  #defined_tags not tested - cannot test in home region        
+  freeform_tags                = var.test_freeform_tags
+  knowledge_base_ids = [
+    oci_generative_ai_agent_knowledge_base.test_service_managed_knowledge_base.id
+  ]
+}
+
+data "oci_generative_ai_agent_agent" "test_agent" {
+  #Required
+  agent_id       = oci_generative_ai_agent_agent.test_agent.id
+}
+
+data "oci_generative_ai_agent_agents" "test_agents" {
+  #Required
+  compartment_id                = var.compartment_ocid
+}

examples/generative_ai_agent/agent_endpoint.tf

@@ -0,0 +1,31 @@
+resource "oci_generative_ai_agent_agent_endpoint" "test_agent_endpoint" {
+  #Required
+  compartment_id                 = var.compartment_ocid
+  agent_id                       = data.oci_generative_ai_agent_agent.test_agent.id
+
+  #Optional
+  display_name                  = var.test_agent_endpoint_display_name
+  description                   = var.test_agent_endpoint_description
+  #defined_tags not tested - cannot test in home region        
+  freeform_tags                 = var.test_freeform_tags
+  should_enable_citation        = var.should_enable_citation
+  should_enable_session         = var.should_enable_session
+  should_enable_trace           = var.should_enable_trace
+  content_moderation_config  {
+    should_enable_on_input = var.should_enable_on_input
+    should_enable_on_output = var.should_enable_on_output
+  }
+  session_config              {
+    idle_timeout_in_seconds = var.idle_timeout_in_seconds
+  }
+}
+
+data "oci_generative_ai_agent_agent_endpoint" "test_agent_endpoint" {
+  #Required
+  agent_endpoint_id                   = oci_generative_ai_agent_agent_endpoint.test_agent_endpoint.id
+}
+
+data "oci_generative_ai_agent_agent_endpoints" "test_agent_endpoints" {
+  #Required
+  compartment_id                = var.compartment_ocid
+}

examples/generative_ai_agent/data_ingestion_job.tf

@@ -0,0 +1,21 @@
+resource "oci_generative_ai_agent_data_ingestion_job" "test_data_ingestion_job" {
+  #Required
+  compartment_id                 = var.compartment_ocid
+  data_source_id                 = oci_generative_ai_agent_data_source.test_data_source.id
+
+  #Optional
+  display_name                  = var.test_data_ingestion_job_display_name
+  description                   = var.test_data_ingestion_job_description
+  #defined_tags not tested - cannot test in home region        
+  freeform_tags                 = var.test_freeform_tags
+}
+
+data "oci_generative_ai_agent_data_ingestion_job" "test_data_ingestion_job" {
+  #Required
+  data_ingestion_job_id         = oci_generative_ai_agent_data_ingestion_job.test_data_ingestion_job.id
+}
+
+data "oci_generative_ai_agent_data_ingestion_jobs" "test_data_ingestion_jobs" {
+  #Required
+  compartment_id                = var.compartment_ocid
+}

examples/generative_ai_agent/data_source.tf

@@ -0,0 +1,39 @@
+resource "oci_generative_ai_agent_data_source" "test_data_source" {
+  #Required
+  compartment_id                 = var.compartment_ocid
+  knowledge_base_id              = oci_generative_ai_agent_knowledge_base.test_service_managed_knowledge_base.id
+  data_source_config  {
+    data_source_config_type = "OCI_OBJECT_STORAGE"
+    object_storage_prefixes {
+      bucket = data.oci_objectstorage_bucket.bucket.name
+      namespace = data.oci_objectstorage_namespace.ns.namespace
+      prefix = var.test_data_source_prefix
+    }
+  }
+
+  #Optional
+  display_name                  = var.test_data_source_display_name
+  description                   = var.test_data_source_description
+  #defined_tags not tested - cannot test in home region        
+  freeform_tags                 = var.test_freeform_tags
+}
+
+data "oci_generative_ai_agent_data_source" "test_data_source" {
+  #Required
+  data_source_id                   = oci_generative_ai_agent_data_source.test_data_source.id
+}
+
+data "oci_generative_ai_agent_data_sources" "test_data_sources" {
+  #Required
+  compartment_id                = var.compartment_ocid
+}
+
+data "oci_objectstorage_namespace" "ns" {
+  #Optional
+  compartment_id = var.compartment_ocid
+}
+
+data "oci_objectstorage_bucket" "bucket" {
+  name                         = "oci-docs"
+  namespace                    = data.oci_objectstorage_namespace.ns.namespace
+}

examples/generative_ai_agent/description.md

@@ -0,0 +1,4 @@
+# Overview
+This is a Terraform configuration that creates the Generative AI Agent service on Oracle Cloud Infrastructure.
+
+The Terraform code is used to create a Resource Manager stack, that creates the required resources and configures the application on the created resources.

examples/generative_ai_agent/knowledge_base.tf

@@ -0,0 +1,24 @@
+resource "oci_generative_ai_agent_knowledge_base" "test_service_managed_knowledge_base" {
+  #Required
+  compartment_id                 = var.compartment_ocid
+  index_config  {
+    index_config_type = var.index_config_type_default
+    should_enable_hybrid_search   = var.should_enable_hybrid_search
+  }
+
+  #Optional
+  display_name                  = var.test_knowledge_base_display_name
+  description                   = var.test_knowledge_base_description
+  #defined_tags not tested - cannot test in home region        
+  freeform_tags                 = var.test_freeform_tags
+}
+
+data "oci_generative_ai_agent_knowledge_base" "test_service_managed_knowledge_base" {
+  #Required
+  knowledge_base_id                   = oci_generative_ai_agent_knowledge_base.test_service_managed_knowledge_base.id
+}
+
+data "oci_generative_ai_agent_knowledge_bases" "test_knowledge_bases" {
+  #Required
+  compartment_id                = var.compartment_ocid
+}

examples/generative_ai_agent/provider.tf

@@ -0,0 +1,20 @@
+// Copyright (c) 2017, 2023, Oracle and/or its affiliates. All rights reserved.
+// Licensed under the Mozilla Public License v2.0
+
+variable config_file_profile {
+}
+
+variable "region" {
+}
+
+variable "compartment_ocid" {
+
+}
+
+provider "oci" {
+  auth = "SecurityToken"
+  config_file_profile = var.config_file_profile
+  region = var.region
+}
+
+

examples/generative_ai_agent/variables.tf

@@ -0,0 +1,88 @@
+// Copyright (c) 2017, 2024, Oracle and/or its affiliates. All rights reserved.
+// Licensed under the Mozilla Public License v2.0
+
+variable "agent_display_name" {
+  default = "agent"
+}
+
+variable "agent_description" {
+  default = "this is an agent"
+}
+
+variable "agent_welcome_message" {
+  default = "welcomeMessage"
+}
+
+variable "should_enable_citation" {
+  default = "false"
+}
+
+variable "should_enable_session" {
+  default = "true"
+}
+
+variable "should_enable_trace" {
+  default = "false"
+}
+
+variable "should_enable_on_input" {
+  default = "false"
+}
+
+variable "should_enable_on_output" {
+  default = "false"
+}
+
+variable "idle_timeout_in_seconds" {
+  default = 3600
+}
+
+variable "index_config_type_default" {
+  default = "DEFAULT_INDEX_CONFIG"
+}
+
+variable "should_enable_hybrid_search" {
+  default = "false"
+}
+
+variable "test_agent_endpoint_display_name" {
+  default = "test_agent_endpoint"
+}
+
+variable "test_agent_endpoint_description" {
+  default = "test agent endpoint"
+}
+
+variable "test_knowledge_base_display_name" {
+  default = "test_knowledge_base"
+}
+
+variable "test_knowledge_base_description" {
+  default = "test knowledgeBase"
+}
+
+variable "test_data_source_display_name" {
+  default = "test_data_source"
+}
+
+variable "test_data_source_description" {
+  default = "test dataSource"
+}
+
+variable "test_data_ingestion_job_display_name" {
+  default = "test_data_ingestion_job"
+}
+
+variable "test_data_ingestion_job_description" {
+  default = "test dataIngestionJob"
+}
+
+variable "test_data_source_prefix" {
+  default = "sample text.pdf"
+}
+
+variable "test_freeform_tags" {
+  default = {
+    "bar-key" = "value"
+  }
+}

internal/client/generative_ai_agent_clients.go

@@ -0,0 +1,34 @@
+// Copyright (c) 2017, 2024, Oracle and/or its affiliates. All rights reserved.
+// Licensed under the Mozilla Public License v2.0
+
+package client
+
+import (
+	oci_generative_ai_agent "github.com/oracle/oci-go-sdk/v65/generativeaiagent"
+
+	oci_common "github.com/oracle/oci-go-sdk/v65/common"
+)
+
+func init() {
+	RegisterOracleClient("oci_generative_ai_agent.GenerativeAiAgentClient", &OracleClient{InitClientFn: initGenerativeaiagentGenerativeAiAgentClient})
+}
+
+func initGenerativeaiagentGenerativeAiAgentClient(configProvider oci_common.ConfigurationProvider, configureClient ConfigureClient, serviceClientOverrides ServiceClientOverrides) (interface{}, error) {
+	client, err := oci_generative_ai_agent.NewGenerativeAiAgentClientWithConfigurationProvider(configProvider)
+	if err != nil {
+		return nil, err
+	}
+	err = configureClient(&client.BaseClient)
+	if err != nil {
+		return nil, err
+	}
+
+	if serviceClientOverrides.HostUrlOverride != "" {
+		client.Host = serviceClientOverrides.HostUrlOverride
+	}
+	return &client, nil
+}
+
+func (m *OracleClients) GenerativeAiAgentClient() *oci_generative_ai_agent.GenerativeAiAgentClient {
+	return m.GetClient("oci_generative_ai_agent.GenerativeAiAgentClient").(*oci_generative_ai_agent.GenerativeAiAgentClient)
+}