aiAgentAliasCreate

Create a new AI Agent Alias in the AI Agent Registry.

Description: This mutation creates a new alias for an AI Agent against an existing published version or a newly published version from the draft. An alias provides an alternative reference to an agent version, allowing for easier management and routing.

Input Parameters (AiAgentAliasCreateInput):

• agentId: ID! - Required. The unique identifier of the AI Agent to which the alias will be associated.
• agentVersionId: ID - Optional. The unique identifier of the AI Agent Version. If provided, the alias will be created for this existing published version. If not provided, a new version will be published from the current draft and the alias will be associated to it.
• name: String! - Required. Name of the AI Agent Alias.
• description: String - Optional. Description of the AI Agent Alias.
• externalId: ID - Optional. External identifier for the AI Agent Alias in the provider system.
• trustLevel: AiAgentRegistryTrustLevel - Optional. Indicates the confidence and reliability level of the AI Agent Alias.
• tags: [AiAgentTagInput!] - Optional. Tags for classification and organization. If not provided, tags will be empty.

Response:

• Returns the newly created AiAgentAlias object.

Example Request:

mutation CreateAiAgentAlias {
    aiAgentAliasCreate(input: {
        agentId: "agent-guid-12345",
        agentVersionId: "agent-version-guid-12345",
        name: "Production Alias",
        description: "Production alias for customer support agent",
        externalId: "ext-alias-prod-001",
        trustLevel: ENDORSED,
        tags: [{ key: "env", value: "production" }]
    }) {
        id
        name
        description
        externalId
        trustLevel
        agentStatus
        agentVersion {
            id
            version
            name
        }
        invocationSpecs {
            protocol
            spec
        }
        tags {
            id
            key
            value
        }
        auditData {
            createdByUserId
            createdTime
            createdByOrigin
            modifiedByUserId
            modifiedTime
        }
    }
}

aiAgentAliasCreate(
  input: AiAgentAliasCreateInput!
): AiAgentAlias!

Arguments

aiAgentAliasCreate.input ● AiAgentAliasCreateInput! non-null input agent-control-tower

Type

AiAgentAlias object agent-control-tower