aiAgentToolUpdate

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 of task GUID to which tool need to be associate. this association is an incremental operation. if already association exists it will skip else it will associates.

Response:

• Returns the updated AiAgentTool object.

Example Request:

mutation UpdateAiAgentTool {
    aiAgentToolUpdate(input: {
        id: "tool-customer-analyzer-001",
        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: ["task-guid-001", "task-guid-002", "task-guid-003"],
        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
        }
    }
}

aiAgentToolUpdate(
  input: AiAgentToolUpdateInput!
): AiAgentTool

Arguments

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

Type

AiAgentTool object agent-control-tower

Represents an AI Agent Tool in the AI Agent Registry.