digitalocean_genai_agent

Provides a resource to manage a DigitalOcean GenAI Agent. With this resource you can create, update, and delete agents, as well as update the agent’s visibility status.

Example Usage

resource "digitalocean_genai_agent" "terraform-testing" {
  description = "Agent for testing update and delete functionality."
  instruction = "You are DigitalOcean's Solutions Architect Assistant, designed to help users find the perfect solution for their technical needs."
  model_uuid  = "d754f2d7-d1f0-11ef-bf8f-4e013e2ddde4"
  name        = "terraform-testing"
  project_id  = "84e1e297-ee40-41ac-95ff-1067cf2206e9"
  region      = "tor1"
  tags        = ["marketplace-agent-terraform"]
}

Argument Reference

The following arguments are supported:

• description (Optional) - A description for the agent.
• instruction (Required) - The detailed instruction for the agent.
• model_uuid (Required) - The UUID of the agent’s associated model.
• name (Required) - The name assigned to the agent.
• project_id (Required) - The project identifier for the agent.
• region (Required) - The region where the agent is deployed.
• tags (Optional) - A list of tags associated with the agent.
• visibility (Optional) - The visibility of the agent (e.g., “public” or “private”).
• anthropic_key_uuid (Optional) - Anthropic API key UUID to use with Anthropic models.
• knowledge_base_uuid (Optional) - List of knowledge base UUIDs to attach to the agent.
• open_ai_key_uuid (Optional) - OpenAI API key UUID to use with OpenAI models.
• anthropic_api_key (Optional) - Anthropic API Key information block.
• api_key_infos (Optional) - List of API Key Info blocks.
• api_keys (Optional) - List of API Key blocks.
• chatbot_identifiers (Optional) - List of chatbot identifiers.
• deployment (Optional) - List of deployment blocks.
• functions (Optional) - List of function blocks.
• agent_guardrail (Optional) - List of agent guardrail blocks.
• chatbot (Optional) - Chatbot configuration block.
• if_case (Optional) - If case condition.
• k (Optional) - K value.
• knowledge_bases (Optional, Computed) - List of knowledge base blocks.
• max_tokens (Optional) - Maximum tokens allowed.
• model (Optional, Computed) - Model block.
• open_ai_api_key (Optional) - OpenAI API Key information block.
• provide_citations (Optional) - Whether the agent should provide citations.
• retrieval_method (Optional) - Retrieval method used.
• route_created_by (Optional) - User who created the route.
• route_created_at (Optional) - Timestamp when the route was created.
• route_uuid (Optional) - Route UUID.
• route_name (Optional) - Route name.
• template (Optional) - Agent template block.
• temperature (Optional) - Temperature setting.
• top_p (Optional) - Top-p sampling parameter.
• url (Optional) - URL for the agent.
• user_id (Optional) - User ID linked with the agent.

Attributes Reference

After creation, the following attributes are exported:

• agent_id - The unique identifier of the agent.
• created_at - The timestamp when the agent was created.
• updated_at - The timestamp when the agent was last updated.
• instruction - The instruction used with the agent.
• model_uuid - The UUID of the agent’s model.
• name - The name of the agent.
• project_id - The project associated with the agent.
• region - The region where the agent is deployed.
• description - The agent’s description.
• visibility - The agent’s visibility status.
• tags - The list of tags assigned to the agent.
• if_case - A condition parameter for agent behavior.
• k - An integer representing the “k” value.
• max_tokens - Maximum tokens allowed.
• retrieval_method - The retrieval method used.
• route_created_at - Timestamp for when the agent route was created.
• route_created_by - Who created the route.
• route_uuid - The unique identifier for the route.
• route_name - The name of the route.
• temperature - The temperature setting of the agent.
• top_p - The top-p sampling parameter.
• url - The URL associated with the agent.
• user_id - The user ID linked with the agent.
• anthropic_key_uuid - Anthropic API key UUID.
• knowledge_base_uuid - List of knowledge base UUIDs.
• open_ai_key_uuid - OpenAI API key UUID.
• anthropic_api_key - Anthropic API Key information.
• api_key_infos - List of API Key Info blocks.
• api_keys - List of API Key blocks.
• chatbot_identifiers - List of chatbot identifiers.
• deployment - List of deployment blocks.
• functions - List of function blocks.
• agent_guardrail - List of agent guardrail blocks.
• chatbot - Chatbot configuration block.
• knowledge_bases - List of knowledge base blocks.
• model - Model block.
• open_ai_api_key - OpenAI API Key information block.
• provide_citations - Whether the agent provides citations.
• template - Agent template block.

Update Behavior

When the visibility, description, instruction, k, max_tokens, model_uuid, name, open_ai_key_uuid, project_id, retrieval_method, region, tags, temperature, or top_p attribute is changed, the provider invokes the update API endpoint to adjust the agent’s configuration.

Import

A DigitalOcean GenAI Agent can be imported using its UUID. For example:

terraform import digitalocean_genai_agent.terraform-testing 79292fb6-3627-11f0-bf8f-4e013e2ddde4

Usage Notes

Changes to the agent’s configuration, such as updating the instruction, description, or visibility, will trigger the corresponding update functions in the provider. This resource enables you to manage the complete lifecycle of a DigitalOcean GenAI Agent within your Terraform configuration.