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. Either id or externalId must be provided to identify the tool for updating.

Input Parameters (AiAgentToolUpdateInput):

• id: ID! - Required. Unique identifier of the AI agent tool to be updated.
• externalId: String - Optional. External identifier from the provider system (e.g., AWS Bedrock, Salesforce).
• 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.
• updatedByOrigin: AiAgentOriginType - Optional. Indicates the origin type when updating the tool, either PROVIDER or REGISTRY.
• aiRegistryEntityType: AiRegistryEntityType - Optional. Specifies the AI registry entity type, either VERSION or TASK.
• aiRegistryEntityIds: [ID!] - Optional. List of AI registry entity identifiers (GUID of respective entity type to which tool needs to be associated).
• aiRegistryEntityStatus: String - Optional. Specifies the current status of the Entity Association.
• 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.

Response:

• Returns the updated AiAgentTool object.

Example Request:

mutation UpdateAiAgentTool {
    aiAgentToolUpdate(input: {
        id: "tool-customer-analyzer-001",
        externalId: "customer-data-analyzer-v1-updated",
        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,
        updatedByOrigin: REGISTRY,
        aiRegistryEntityType: VERSION,
        aiRegistryEntityIds: ["agent-customer-service-001", "agent-sales-002", "agent-marketing-003"],
        aiRegistryEntityStatus: "ENABLED",
        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 }",
            status: ENABLED,
            externalId: "customer-data-processor-fn-v2"
        }, {
            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\" }] }",
            status: ENABLED,
            externalId: "data-viz-service-v2"
        }, {
            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\"] }",
            status: ENABLED,
            externalId: "customer-insights-ml-v1"
        }],
        tags: [
            {
                key: "category"
                value: "analytics"
            },
            {
                key: "dataType"
                value: "customer"
            },
            {
                key: "environment"
                value: "production"
            },
            {
                key: "version"
                value: "2.0"
            },
            {
                key: "features"
                value: "real-time"
            }
        ]
    }) {
        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
            }
        }
        syncData {
            lastSyncStatus
            lastSyncStartDate
            lastSyncEndDate
        }
        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.