agent-builder-tool

Agent Builder Tool: Create, configure, publish, and manage custom AI agents end to end. create_new drafts a private agent, optionally as a remix of any agent you can view. Use when an agent needs agent builder tool, build a custom ai agent without writing code, turn a job description into a working ai agent, equip an agent with crm inbox calendar and messaging tools, attach multi step workflows to an agent, add product, agent id, product id through AgentPMT-hosted remote tool calls.

Freshness

Last updated: 2026-08-01.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Build your own AI agent in a conversation. Describe the job you want done and this AI agent builder creates the agent, gives it the tools and workflows it needs, writes its operating instructions, and puts it live under its own name and link. Start from a blank agent or branch off one that already works, then keep shaping it in plain language: connect a CRM, an inbox, a calendar, a phone line, research and data tools, or an entire multi step workflow, and attach your own context documents so it answers with your pricing, your policies, and your voice instead of generic advice. Preview the agent in a live chat, publish it when it is ready, hand it to your team, and spin up new agents for other roles while the original keeps running untouched. No code, no framework, and no prompt engineering background required. If you can explain the job to a new hire, you can build the AI agent that does it.

Product Instructions

Agent Builder Tool creates and manages custom AI agents: lifecycle, composition (tools and workflows), context documents, and showcase chat previews.

Response field allowlist (read this first)

Responses use a strict allowlist. system_prompt and chat_model are writable but are never returned by any action, including fetch_existing. Keep your own copy of a system prompt if you need to read it back or edit it incrementally.

Actions

create_new

Create a private draft agent.

• name (required; omitting it returns AGENT_CREATE_NAME_REQUIRED)
• description, chat_model, context_document_ids
• remixed_from_agent_id, remixed_from_agent_name to create the draft as a remix of a source you can view
• When remixed_from_agent_id is supplied, the source composition is authoritative: accessible tools, workflows, Agent Context documents, a non-empty system prompt, and an available chat model are cloned. Caller-supplied chat_model and context_document_ids are ignored on that path.

update_existing

Update fields on an agent you own.

• agent_id (required)
• name, description, status (draft | active | archived), chat_model, system_prompt, context_document_ids
• Prefer the dedicated publish and archive actions over setting status directly

fetch_existing

List your agents (most recently updated first) or fetch one by id or slug.

• agent_id to fetch one; query, limit (1-100), skip to list
• Unreadable or missing agents return AGENT_FETCH_NOT_FOUND (existence is masked)

search_public

Browse active public agents. query, limit, skip. Only agents that are active AND public AND unarchived appear here.

publish

agent_id. Moves a draft to active. The first publish stamps published_at and promotes draft_slug to the public slug (clearing draft_slug); later publishes keep both. Publishing does not make an agent public: visibility stays private and the agent will not appear in search_public. Public visibility is driven by the admin-only is_template flag.

archive

agent_id, optional forward_to.

• forward_to must be an internal path starting with / and free of ... Anything else, including an absolute URL, is silently ignored: the agent is archived and no redirects are written (redirects_written: 0).
• If a well-formed path fails deeper validation (pointing at the agent's own URL, or at a path that is already redirected) the call returns AGENT_ARCHIVE_SEO_REDIRECT_FAILED and the agent is left unarchived so it can be retried safely.
• On success the response reports redirects_written (one per canonical path: the slug path and the id path).

remix

agent_id, optional name. Creates a new private draft from any agent you can view and leaves the source unchanged.

• Copies every source item the new owner can access: products, workflows, Agent Context documents, a non-empty system prompt, and a still-available chat model.
• Missing, inactive, inaccessible, or unavailable items are omitted without failing an otherwise usable clone and are reported in skipped[] with kind, id, and reason.
• Showcase examples, template/publication/archive state, source URLs, and the source remix count are not copied.
• Sets remixed_from_* and original_creator_* attribution and increments the source's remix_count.

add_product / remove_product

agent_id, product_id. Attaches or detaches a tool. File Manager is appended automatically when any attached tool, or any tool inside an attached workflow, needs file storage; the response reports file_manager_added. Auto-attach is add-only, so File Manager stays attached after you remove the product that pulled it in. Unknown, inactive, or inaccessible products return AGENT_COMPOSITION_PRODUCT_NOT_FOUND.

add_workflow / remove_workflow

agent_id, workflow_id. Same automatic file storage behavior applies.

attach_context / detach_context

agent_id, context_document_id. Maximum 10 documents per agent. A malformed id returns AGENT_CONTEXT_INVALID_ID. Private context documents are rejected on public active agents.

add_showcase_example / remove_showcase_example

agent_id plus showcase_example (object) or showcase_example_id (string). Only one example may be featured; adding a featured example unfeatures the previous one. Duplicate ids return AGENT_SHOWCASE_DUPLICATE_ID; malformed examples return AGENT_SHOWCASE_INVALID_ASSET.

get_instructions

Returns this reference.

Showcase example shape

2 to 10 messages, at least one user and one assistant. Roles do not need to alternate. Each message needs id, role, timestamp (ISO 8601), and a non empty parts array. Use durable public URLs or a file_id for any media; unsigned private storage URLs are rejected.

Examples

json

{"action":"create_new","name":"Deal Desk","description":"Sales follow-up agent for the Pipedrive pipeline."}

json

{"action":"add_product","agent_id":"<agent_id>","product_id":"<product_id>"}

json

{"action":"update_existing","agent_id":"<agent_id>","system_prompt":"Work only from records in the CRM. Never invent commitments. Every email is a draft for review."}

json

{"action":"publish","agent_id":"<agent_id>"}

json

{"action":"archive","agent_id":"<agent_id>","forward_to":"/agents/replacement-agent"}

Response

Actions return the affected agent payload (id, name, slug, draft_slug, status, visibility, products, workflows, context_document_ids, showcase_examples, plus computed categories and industry_tags derived from the attached products). Successful remix responses also include skipped[] (possibly empty). Errors return a stable AGENT_* error code with a usable message.

When To Use

• Use this skill for Agent Builder Tool on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: agent builder tool, build a custom ai agent without writing code, turn a job description into a working ai agent, equip an agent with crm inbox calendar and messaging tools, attach multi step workflows to an agent, add product, agent id, product id.
• Supported action names: add_product, add_showcase_example, add_workflow, archive, attach_context, create_new, detach_context, fetch_existing, get_instructions, publish, remix, remove_product, remove_showcase_example, remove_workflow, search_public, update_existing.

Use Cases

• Build a custom AI agent without writing code
• Turn a job description into a working AI agent
• Equip an agent with CRM inbox calendar and messaging tools
• Attach multi step workflows to an agent
• Ground an agent in your own policies pricing and brand voice
• Publish an AI agent and share it with your team
• Remix an existing agent into a specialized version
• Add showcase chat previews to an agent listing
• Manage the agent lifecycle from draft to published to archived
• Prototype and tune agent instructions in a live chat

Related Product Skills

• File Management: ../file-management (ClawHub: file-management, page: https://clawhub.ai/agentpmt/file-management; skills.sh: npx skills add AgentPMT/agent-skills --skill file-management) - Use this companion skill to inspect, download, upload, and manage files referenced by this product.

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 16. x402 availability: not enabled for this product.

• add_product (action slug: add-product): Attach a product to the agent. Routes through file manager auto-attach. Parameters: agent_id, product_id.
• add_showcase_example (action slug: add-showcase-example): Add a chat preview example to the agent. Parameters: agent_id, showcase_example.
• add_workflow (action slug: add-workflow): Attach a workflow to the agent. Routes through file manager auto-attach. Parameters: agent_id, workflow_id.
• archive (action slug: archive): Soft-delete the agent. If forward_to is supplied, issue 301 redirects from the agent's canonical paths to that internal destination. Parameters: agent_id, forward_to.
• attach_context (action slug: attach-context): Attach an Agent Context document to the agent. Parameters: agent_id, context_document_id.
• create_new (action slug: create-new): Create a private draft agent. Parameters: chat_model, context_document_ids, description, draft_slug, name, remixed_from_agent_id, remixed_from_agent_name, slug, plus 1 more.
• detach_context (action slug: detach-context): Detach an Agent Context document from the agent. Parameters: agent_id, context_document_id.
• fetch_existing (action slug: fetch-existing): List your agents (recently updated first), or fetch one by id/slug. Parameters: agent_id, limit, query, skip.
• get_instructions (action slug: get-instructions): Return the handler reference guide. Parameters: none.
• publish (action slug: publish): Transition DRAFT to ACTIVE; stamps published_at the first time. Parameters: agent_id.
• remix (action slug: remix): Create a private copy of a viewable agent. Parameters: agent_id, name.
• remove_product (action slug: remove-product): Detach a product from the agent. Routes through file manager auto-attach. Parameters: agent_id, product_id.
• remove_showcase_example (action slug: remove-showcase-example): Remove a showcase example by id. Parameters: agent_id, showcase_example_id.
• remove_workflow (action slug: remove-workflow): Detach a workflow from the agent. Routes through file manager auto-attach. Parameters: agent_id, workflow_id.
• search_public (action slug: search-public): Search active public agents. Parameters: limit, query, skip.
• update_existing (action slug: update-existing): Update editable fields on an agent you own. is_template is admin-only. Parameters: agent_id, chat_model, context_document_ids, description, draft_slug, is_template, name, slug, plus 3 more.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "agent-builder-tool".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "agent-builder-tool", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

json

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "agent-builder-tool"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

json

{
  "action": "get_instructions",
  "tool_id": "agent-builder-tool"
}

Authenticated AgentPMT REST schema lookup body:

json

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "agent-builder-tool"
  }
}

Authenticated AgentPMT REST live examples body:

json

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "agent-builder-tool"
  }
}

Call This Tool

Product slug: agent-builder-tool

Marketplace page: https://www.agentpmt.com/marketplace/agent-builder-tool

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

bash

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

json

{
  "method": "tools/call",
  "params": {
    "name": "Agent-Builder-Tool",
    "arguments": {
      "action": "add_product",
      "agent_id": "example agent id",
      "product_id": "example product id"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

json

{
  "name": "agent-builder-tool",
  "parameters": {
    "action": "add_product",
    "agent_id": "example agent id",
    "product_id": "example product id"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If add_product fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/agent-builder-tool
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase