aiAgentVersionCreate

Create a new version for an existing AI Agent in the AI Agent Registry.

Description: This mutation creates a new version for an existing AI Agent associated with the authenticated user's account.

Uniqueness Constraint: Within a given provider account, each AI Agent must be unique by the combination of agent name and version. The new version being created must not conflict with existing name-version combinations for the same provider.

Input Parameters (AiAgentVersionCreateInput):

• aiAgentId: ID! - Required. Unique identifier of the internal AI agent to create agent version.
• name: String! - Required. Name of the AI agent version.
• version: String - Optional. The version for the AI agent version (default is DRAFT, also support alpha numeric character.).
• description: String - Optional. Description of the AI agent version.
• externalId: ID - Optional. External identifier for the AI agent version from the provider system.
• tags: Array of type AiAgentTagInput - Optional. Allows classification and organization through optional labeling system.
• trustLevel: AiAgentRegistryTrustLevel - Optional. Indicates the confidence and reliability level of the AI agent version.
• versionMetadata: String - Optional. Metadata for the agent version in JSON format.

Response:

• Returns existing AiAgent object with newly created agent version details.

Example Request:

mutation CreateAiAgentVersion {
   aiAgentVersionCreate(input: {
       aiAgentId: "agent-12345-guid",
       name: "Alpha Enhanced",
       version: "2.0",
       externalId: "ext-agent-alpha-v2",
       description: "Enhanced version of the AI agent with improved capabilities",
       tags: [
           {
               key: "enhanced"
               value: "v2"
           }
       ],
       trustLevel: ENDORSED,
       versionMetadata: "{ \"deployment\": \"production\", \"environment\": \"stable\", \"features\": [\"enhanced-nlp\", \"improved-reasoning\"] }"
   }) {
       id
       externalId
       createdByOrigin
       agentVersions {
           id
           externalId
           version
           name
           description
           agentStatus
           versionMetadata
           tags {
               id
               key
               value
           }
           auditData {
               createdByUserId
               createdTime
               modifiedByUserId
               modifiedTime
               createdByOrigin
               updatedByOrigin
               updatedAtProviderTime
           }
       }
   }
}

aiAgentVersionCreate(
  input: AiAgentVersionCreateInput!
): AiAgent

Arguments

aiAgentVersionCreate.input ● AiAgentVersionCreateInput! non-null input agent-control-tower

Type

AiAgent object agent-control-tower