Waiting for engine...
Skip to main content

aiAgentToolUpdate

Updated 

Update an existing AI Agent Tool in the AI Agent Registry.

Description: This mutation updates the details of an existing AI Agent Tool associated with the authenticated user’s account.

Input Parameters (AiAgentToolUpdateInput):

  • id: ID! - Required. Unique identifier of the AI agent tool to be updated.
  • name: String - Optional. Defines the unique identifier or title of the AI agent tool.
  • description: String - Optional. Provides detailed information about the AI agent tool's capabilities and features.
  • toolJson: String - Optional. Stores the complete tool configuration represented as a JSON string.
  • status: AiAgentToolStatus - Optional. Specifies the current operational status of the AI Agent tool.
  • resources: [AiAgentToolResourceInput!] - Optional. Array of new tool resources to be created for the AI Agent tool.
  • tags: [AiAgentTagInput!] - Optional. Optional labeling system that allows classification and organization of AI agent tools.
  • aiAgentTaskIds: [ID!] - Optional. List of DRAFT version task GUIDs to which the tool needs to be associated. This association is an incremental operation: if an association already exists it is skipped, otherwise it is created.

Response:

  • Returns the updated AiAgentTool object.

Example Request:

mutation UpdateAiAgentTool {
    aiAgentToolUpdate(input: {
        id: "4f47953f-7b54-4f0b-b331-91149a5a12b6",
        name: "Enhanced Customer Data Analyzer",
        description: "Updated tool with enhanced features for comprehensive customer data analysis and real-time insights generation.",
        toolJson: "{ \"actionGroupName\": \"CustomerDataAnalysis\", \"description\": \"Enhanced action group for customer data analysis\", \"actionGroupState\": \"ENABLED\", \"actions\": [{ \"name\": \"analyzeCustomerData\", \"description\": \"Analyzes customer data for patterns and trends\", \"parameters\": { \"customerId\": { \"type\": \"string\", \"required\": true }, \"analysisType\": { \"type\": \"string\", \"required\": false, \"default\": \"comprehensive\" }, \"timeRange\": { \"type\": \"string\", \"required\": false, \"default\": \"30d\" } } }, { \"name\": \"generateCustomerInsights\", \"description\": \"Generates actionable insights from customer data\", \"parameters\": { \"customerId\": { \"type\": \"string\", \"required\": true }, \"insightType\": { \"type\": \"string\", \"required\": false, \"default\": \"behavioral\" } } }] }",
        status: ENABLED,
        aiAgentTaskIds: ["0701c384-8449-4093-aa2a-3ce89bc44cb0", "3665d6b7-7b4a-4a4d-a181-b6f100b4f0b4", "44e161d1-8b57-46de-ac6f-c28285d9931e"],
        resources: [{
            name: "CustomerDataProcessor",
            description: "Enhanced processor for customer data with real-time capabilities",
            resourceType: CUSTOM,
            toolResourceJson: "{ \"name\": \"CustomerDataProcessor\", \"description\": \"Enhanced AWS Lambda function for customer data processing\", \"runtime\": \"nodejs18.x\", \"handler\": \"index.handler\", \"environment\": { \"variables\": { \"ANALYSIS_MODE\": \"advanced\", \"REAL_TIME_ENABLED\": \"true\" } }, \"timeout\": 600, \"memorySize\": 1024 }",
        }, {
            name: "DataVisualizationService",
            description: "Advanced visualization service with interactive charts",
            resourceType: CUSTOM,
            toolResourceJson: "{ \"name\": \"DataVisualizationService\", \"description\": \"Enhanced REST API for interactive data visualization\", \"baseUrl\": \"https://api.example.com/v2/visualization\", \"endpoints\": [{ \"path\": \"/charts\", \"method\": \"POST\", \"description\": \"Generate interactive charts from data\" }, { \"path\": \"/dashboards\", \"method\": \"POST\", \"description\": \"Create real-time dashboards\" }] }",
        }, {
            name: "CustomerInsightsEngine",
            description: "AI-powered engine for generating customer insights",
            resourceType: CUSTOM,
            toolResourceJson: "{ \"name\": \"CustomerInsightsEngine\", \"description\": \"Machine learning model for customer behavior analysis\", \"modelType\": \"transformer\", \"version\": \"2.1.0\", \"capabilities\": [\"sentiment_analysis\", \"behavior_prediction\", \"churn_analysis\"] }",
        }],
        tags: [
            {
                key: "category"
                value: "analytics"
            },
            {
                key: "dataType"
                value: "customer"
            }
        ]
    }) {
        id
        externalId
        version
        name
        description
        provider
        toolType
        toolJson
        status
        resources {
            name
            description
            resourceType
            toolResourceJson
            status
            externalId
        }
        tags {
            id
            key
            value
        }
        agentVersions {
            id
            externalId
            version
            name
            description
            region
            purpose
            personalityTraitsJson
            instructions
            agentStatus
            versionMetadata
        }
        tasks {
            id
            externalId
            version
            name
            description
            taskStatus
            metaData
            instructions
            syncData {
                lastSyncStatus
                lastSyncStartDate
                lastSyncEndDate
            }
            auditData {
                createdByUserId
                createdTime
                modifiedByUserId
                modifiedTime
                updatedByOrigin
                updatedAtProviderTime
            }
        }
        auditData {
            createdByUserId
            createdTime
            modifiedByUserId
            modifiedTime
            updatedByOrigin
            updatedAtProviderTime
        }
    }
}

Example Response (success):


{
    "data": {
        "aiAgentToolUpdate": {
            "id": "4f47953f-7b54-4f0b-b331-91149a5a12b6",
            "externalId": null,
            "version": "DRAFT",
            "name": "Enhanced Customer Data Analyzer",
            "description": "Updated tool with enhanced features for comprehensive customer data analysis and real-time insights generation.",
            "provider": "CUSTOM",
            "toolType": "CUSTOM",
            "toolJson": "{ \"actionGroupName\": \"CustomerDataAnalysis\", \"actionGroupState\": \"ENABLED\" }",
            "status": "ENABLED",
            "resources": [
                { "name": "CustomerDataProcessor", "description": "Enhanced processor for customer data with real-time capabilities", "resourceType": "CUSTOM", "toolResourceJson": "{ \"name\": \"CustomerDataProcessor\" }", "status": "ENABLED", "externalId": null }
            ],
            "tags": [
                { "id": "6f9fe561-2381-488a-92ca-0b79f1c52316", "key": "category", "value": "analytics" },
                { "id": "bf5212f8-10fd-440e-9e95-98d758b0255e", "key": "dataType", "value": "customer" }
            ],
            "agentVersions": [],
            "tasks": [
                { "id": "0701c384-8449-4093-aa2a-3ce89bc44cb0", "externalId": null, "version": "DRAFT", "name": "Data Processing Task", "description": "Task for processing data inputs for AI agents.", "taskStatus": "ACTIVE", "metaData": null, "instructions": [], "syncData": null, "auditData": { "createdByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5", "createdTime": "2026-09-17T10:00:00Z", "modifiedByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5", "modifiedTime": "2026-09-17T10:05:00Z", "updatedByOrigin": "REGISTRY", "updatedAtProviderTime": null } }
            ],
            "auditData": {
                "createdByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "createdTime": "2026-09-17T10:00:00Z",
                "modifiedByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "modifiedTime": "2026-09-17T10:05:00Z",
                "updatedByOrigin": "REGISTRY",
                "updatedAtProviderTime": null
            }
        }
    }
}

aiAgentToolUpdate(
  input: AiAgentToolUpdateInput!
): AiAgentTool

Arguments​

aiAgentToolUpdate.input ● AiAgentToolUpdateInput! non-null input agent-control-tower {#input}

Type​

AiAgentTool object agent-control-tower

Represents an AI Agent Tool in the AI Agent Registry.

On this Page