Creating a Worker agent

Hitachi iQ Studio User Guide
Version
1.0.x
Audience
anonymous
Part Number
MK-26HIQS001-00
ft:lastEdition
2026-03-31

A worker agent performs a specific task using the tools you select. Creating the agent sets its role and prepares it to run tasks in iQ Studio.

  • Make sure you have Administrator or Agent Builder permission.
  • Open knowledge base and check that each required collection displayed a green checkmark.
  • Verify that the necessary MCP servers are registered.
  • You have prepared your system prompt (role definition) and know which model to use.
  1. On the iQ Studio home page, go to AI Agents and click Create.
  2. On the Create an AI Agent page, select Worker agent type.

    The following table describes the additional information required to create a new agent.

    Field Description
    Type Select the Worker agent type.
    Import Agent (.json): Upload a JSON file that defining the worker agent’s configuration, including its roles, tools, workflows, and permissions. After you upload the file, the system reads the configuration and installs the agent.

    Note: Use this option only if you have previously exported an agent as a JSON file.
    Name Human-readable agent name.
    Description Short summary of the agent’s purpose.
    Instructions Primary Role: You are a strategic advisory agent with MCP tool access to organizational strategy documents in the knowledge collection. Core Role: Retrieve relevant strategy documents and synthesize actionable business insights. Process: Identify strategic themes from user queries. Search the knowledge collection using MCP tools. Extract key information from retrieved documents. Provide clear, actionable recommendations.
    Avatar Optional image representation.
    Avatar dropzone You can use a custom image. The supported file types are JPG, JPEG, JFIF, PJPEG, PJP, PNG, SVG, and the maximum file size must be under 1 MB.
    Advanced options* Optional settings used to control agent limits and behavior.
    Model Select the model that will power the agent from the available list.
    Temperature Controls the randomness of the model's outputs. Lower values (0–0.3) produce deterministic, focused responses; higher values (0.9–1.0) yield more varied, creative outputs.
    System Prompt The agent’s role, objectives, tone, constraints, and decision-making rules. Serves as the primary instruction that guides all agent behavior.
    Max Tokens Sets the maximum number of tokens the model can use in a single response or operation. This limit controls output length and cost.
    Max Execution Time Specifies the maximum time (in seconds) the agent can run before it stops.
    Max Retries Defines how many times the agent retries a failed task or call.
    Max React Tool Calls Limits the number of tool calls the agent can perform in one run.
    Note*: Leave advanced options at default unless you need custom control policies.
  3. Click Next.
  4. On the Equip page of the Build a new AI agent wizard, add one of the MCP servers that you created and then click Next.
  5. On the Configure Tool page, select the tools you want this agent to use from the list of tools provided by the MCP server.
  6. Set the permissions for the tool:
    • Always Allow: Grants permission to run without asking for confirmation each time.
    • Ask Before Running: Requires user confirmation before the tool runs.
  7. If you selected the RAG MCP Server tool, select the knowledge base from the Collections list and then click Apply.
  8. Click Apply.
  9. Click Next and then click Done.
  10. Confirm that the new worker agent appears in the AI Agents list on the AI Agents page.