aiAgentTaskCreate
Create a new AI Agent Task in the AI Agent Registry.
Description: This mutation creates a new AI Agent Task with DRAFT version associated with the authenticated user's account. And associate to any specified agents DRAFT agent version.
Input Parameters (AiAgentTaskCreateInput):
providerAccountId: ID! - Required. The unique identifier of the AI Agent Provider account where the task will be created.name: String! - Required. Name of the AI agent task.description: String - Optional. Description of the AI agent task.taskMetaData: String - Optional. Additional task information in JSON format.agentToolIds: [ID!] - Optional. List of AI Agent Tool IDs associate to this task.tags: [AiAgentTagInput!] - Optional. Tags for categorization.instructions: String : Optional - Instructions for the task.agentIds: [ID!]: Optional - List of AI Agent IDs to associate with this task. This will associate to DRAFT version of those agents
Response:
- Returns the newly created
AiAgentTaskobject.
Example Request:
mutation CreateAiAgentTask {
aiAgentTaskCreate(input: {
providerAccountId: "ai-registry-account-12345",
name: "Data Processing Task",
description: "Task for processing data inputs for AI agents.",
taskMetaData: "{ \"priority\": \"high\", \"category\": \"data-processing\" }",
agentIds: ["agent-guid-123", "agent-guid-456"],
agentToolIds: ["tool-guid-789", "tool-guid-012"],
tags: [
{
key: "category"
value: "data-processing"
}
]
}) {
id
externalId
name
description
version
taskStatus
metaData
agentVersions {
id
name
version
}
tools {
id
name
description
version
}
tags {
id
key
value
}
auditData {
createdByUserId
createdTime
modifiedByUserId
modifiedTime
createdByOrigin
updatedByOrigin
updatedAtProviderTime
}
}
}
aiAgentTaskCreate(
input: AiAgentTaskCreateInput!
): AiAgentTask
Arguments
aiAgentTaskCreate.input ● AiAgentTaskCreateInput! non-null input agent-control-tower
Type
AiAgentTask object agent-control-tower
Was this topic helpful?