install-hub-agent

Download and install an Agent from the OpenAkita Platform Agent Store to the local system.

When to Use

• User wants to install a specific Agent from the hub
• User says "安装这个 Agent" after browsing search results
• User provides an Agent ID to install

Workflow

1. (Optional) Call search_hub_agents first to find the Agent
2. (Optional) Call get_hub_agent_detail to preview Agent details
3. Call install_hub_agent with the agent_id
4. The system will:

• Download the .akita-agent package from the platform
• Extract and install bundled skills (version-aware, skips if same/newer exists locally)
• Fetch required external skills from their original GitHub repos
• Register the Agent profile locally
• Auto-reload skills so the Agent is immediately usable

Tools

install_hub_agent

| Parameter | Required | Description | |-----------|----------|-------------| | agent_id | Yes | The platform Agent ID (from search results) | | force | No | Force overwrite if local ID conflict (default: false) |

get_hub_agent_detail

| Parameter | Required | Description | |-----------|----------|-------------| | agent_id | Yes | The platform Agent ID to inspect |

Important Notes

• Installed Agents appear in the local Agent list immediately
• Bundled skills go to skills/custom/, external skills go to skills/community/
• Skills are version-deduplicated: if a newer version already exists locally, it is kept
• Each installed skill gets a .openakita-origin.json tracking its source and version
• The Agent's hub_source field records where it came from

Fallback

If the platform is unavailable, the user can still:

• Import Agents from .akita-agent files using import_agent
• Export local Agents using export_agent