Agent tools

Use these tools to create and manage Gumloop agents, their configuration, and the resources they use.

Tool	Description	Required inputs
`list_agents`	List agents in your account with optional search, workspace filtering, paging and a lightweight `summary` mode	None
`get_agent`	Fetch an agent’s configuration	`agent_id`
`create_agent`	Create an agent with a name and model	`name`, `model_name`
`update_agent`	Update an agent’s metadata or configuration	`agent_id`
`delete_agent`	Delete a custom agent	`agent_id`
`update_agent_abilities`	Turn built-in abilities like web search, browser, and image generation on or off; only abilities sent change	`agent_id`
`attach_agent_skills`	Attach existing skills to an agent	`agent_id`, `skill_ids`
`detach_agent_skills`	Detach skills from an agent	`agent_id`, `skill_ids`
`attach_agent_mcp_server`	Attach or update an MCP server on an agent	`agent_id`, `server_id`
`detach_agent_mcp_server`	Detach an MCP server from an agent	`agent_id`, `server_id`
`list_agent_mcp_servers`	List the MCP servers attached to an agent	`agent_id`
`list_agent_app_rules`	List the connector rules an agent has authored for its apps	`agent_id`
`list_models`	List model groups available to agents	None
`route_model`	Ask the Auto router which model it would pick for a message	`input`
`list_agent_versions`	List an agent’s immutable versions	`agent_id`
`get_agent_version`	Fetch an immutable agent version and its configuration	`agent_id`, `version_id`

Knowledge sources

Tool	Description	Required inputs
`list_agent_knowledge_sources`	List the Company Brain sources attached to an agent	`agent_id`
`attach_agent_knowledge_source`	Attach or scope a Company Brain source on an agent	`agent_id`, `connector_id`
`detach_agent_knowledge_source`	Detach a Company Brain source from an agent	`agent_id`, `connector_id`

connector_id is the Company Brain source ID. The optional config sets the scope within that source; omit it to use the whole source.

Subagents

Tool	Description	Required inputs
`attach_agent_subagent`	Allow an agent to delegate to another agent in the same workspace	`agent_id`, `subagent_id`
`detach_agent_subagent`	Stop an agent from delegating to another agent	`agent_id`, `subagent_id`

Triggers

Tool	Description	Required inputs
`create_agent_trigger`	Create a schedule or webhook trigger for an agent	`agent_id`, `type`, `prompt`
`list_agent_triggers`	List an agent’s schedule and webhook triggers	`agent_id`
`update_agent_trigger`	Edit, enable, or disable an agent trigger	`agent_id`, `trigger_id`
`delete_agent_trigger`	Delete an agent trigger	`agent_id`, `trigger_id`
`get_agent_trigger_webhook_url`	Get the URL that fires an agent’s webhook trigger	`agent_id`, `trigger_id`

Schedule triggers use a cron expression or a one-time run_at value. Webhook triggers run when their URL is called. Set enabled to false in update_agent_trigger to pause a trigger.

Example prompts

Create a new agent called "Research Assistant" using the GPT-6 Sol model.

List my agents and show me which ones are deployed.

Attach my research skills to the "Research Assistant" agent.

Create a schedule trigger that runs my Research Assistant agent every Monday at 9 AM Eastern with the prompt "Summarize last week's industry news."

Core concepts

Guides

Tools

Knowledge sources

Subagents

Triggers

Example prompts

​Knowledge sources

​Subagents

​Triggers

​Example prompts

​Related

Knowledge sources

Subagents

Triggers

Example prompts

Related