DocumentationAgents

Agents and the agent catalog

Find a specialist that already knows the job. Check what it requires before installing a copy for one team.

Catalog agents arrive with a defined job and the settings needed to do it. Install one when it already fits the work instead of rebuilding the same setup yourself.

Video placeholder

Choose and install your first agent

Record the catalog search, the agent’s requirements, and the team installation from start to finish.

Choose and install an agent

Open Agents from the workspace sidebar, where Hivy keeps catalog entries beside the agents your workspace created.

  1. 01

    Find the right specialist

    Search by name or browse categories until you find the narrowest agent that matches the outcome you need.

  2. 02

    Review its requirements

    Check the agent’s purpose and required connections before choosing a team; Hivy refuses the installation when a requirement is missing.

  3. 03

    Install it for a team

    Pick a team you belong to, and Hivy creates a separate copy for that team's work.

  4. 04

    Test the installed copy

    Run one representative task for the team before changing the model, sandbox, or optional connections.

Image placeholder

A catalog agent’s team installation screen

Include the agent details, required connections, and per-team Install controls in one readable frame.

Each team gets its own agent

Hivy creates a separate copy for the selected team, limited to that team's capabilities. If another team needs the same specialist, install another copy; its access and settings remain separate.

Hivy checks required connections first

Before installation, Hivy checks whether the selected team has every connection the agent requires. If one is missing, the page names it and no agent gets created.

The installed agent receives the team's connections, though you can switch off an optional connection for this agent without affecting its teammates. Connections listed as required are locked on because the catalog agent depends on them.

Tune it for the work and budget

After installation, set the model and sandbox for the work this agent will handle most often, then remove optional connections it won't use. These choices affect cost and available compute.

Catalog agent or custom agent?

Pick a catalog agent when its listed job matches yours. If the role needs different instructions, tools, or delegation rules, create a custom agent instead.

Create and configure an agent