Agents

Basic CRUD

list_agents

No arguments. Returns every accessible agent grouped by workspace.

get_agent

create_agent

update_agent

Same fields as create_agent but all optional, plus agentId. The systemPrompt is versioned automatically — equivalent to calling write_agent_prompt.

delete_agent

Prompt (automatic versioning)

Every write creates a new version in the agent's history and atomically updates activePromptId and systemPrompt.

get_agent_prompt

Returns { systemPrompt, activePromptId, lastUpdate }.

write_agent_prompt

edit_agent_prompt

By default it attempts an exact match and, if it doesn't find one, a more flexible one with normalized whitespace. Returns editType: "exact" | "fuzzy" | "regex" to indicate how it resolved.

list_agent_prompt_versions

Sub-agents

Sub-agents are regular workspace agents connected to the parent. Connecting and disconnecting does not affect the referenced agent — it only changes the relationship with the parent.

list_agent_subagents

list_available_subagents

Returns every agent in the workspace (except the parent and deleted ones) with an isAlreadyConnected flag.

connect_agent_subagent

Returns 409 if the sub-agent is already connected to the parent.

update_agent_subagent_connection

Changing task automatically clears the fields belonging to the previous mode.

disconnect_agent_subagent

Removes the connection. It does not delete the referenced sub-agent.

create_agent_subagent

Creates a brand-new agent and connects it as a sub-agent in a single call. If you pass systemPrompt, the sub-agent's prompt version history is initialized automatically.

Guardrails

get_agent_guardrails

update_agent_guardrails

All configuration fields are optional — only the ones present are updated.

Assist rules

get_agent_assist_rules

update_agent_assist_rules

Schedule

get_agent_schedule

update_agent_schedule

Supports per-day merge — days not included in serviceHours are preserved.

{
  "name": "update_agent_schedule",
  "arguments": {
    "agentId": "QZPHpckDPC58JIVLQA3Z",
    "serviceHours": {
      "saturday": { "availability": "Abierto", "start": "10:00am", "end": "2:00pm" }
    }
  }
}

Knowledge base

list_agent_knowledge

create_agent_knowledge_from_url

Creates entries from files already hosted publicly (fileUrl) or from raw text directly (content, no file). Each file must include either fileUrl or content. Platica downloads/extracts the content and automatically generates a title and description when applicable.

From URL:

{
  "name": "create_agent_knowledge_from_url",
  "arguments": {
    "agentId": "QZPHpckDPC58JIVLQA3Z",
    "files": [
      {
        "fileUrl": "https://storage.googleapis.com/.../manual.pdf",
        "fileName": "manual.pdf",
        "fileType": "pdf"
      }
    ],
    "setActive": true
  }
}

From raw text:

{
  "name": "create_agent_knowledge_from_url",
  "arguments": {
    "agentId": "QZPHpckDPC58JIVLQA3Z",
    "files": [
      {
        "fileName": "politica-devoluciones.txt",
        "fileType": "txt",
        "content": "Aceptamos devoluciones dentro de los 30 días posteriores a la compra...",
        "topic": "Devoluciones"
      }
    ],
    "setActive": true
  }
}

ingest_agent_knowledge_from_web

Ingests web URLs. Platica extracts the content and automatically generates a title and description.

update_agent_knowledge

Updates an existing entry: appends text to the content, replaces it entirely, changes status/metadata, or reprocesses the original source. Returns 404 if the entry doesn't exist (it doesn't create it).

delete_agent_knowledge

Deletes an entry from the agent's knowledge base. The agent can no longer query it.

REST endpoints without an MCP tool

Some REST API endpoints are not exposed as MCP tools for simplicity or because they require a manual flow:

• POST /v1/agents/{agentId}/knowledge/upload — multipart file upload (≤ 20 MB per request). Use the REST API directly; the result (fileUrl) can be passed to create_agent_knowledge_from_url.
• POST /v1/agents/{agentId}/knowledge/{knowledgeId}/reparse — reprocess the original source of an entry.
• GET /v1/agents/{agentId}/knowledge/{knowledgeId} — fetch a single entry (can be simulated by filtering the result of list_agent_knowledge).
• GET /v1/agents/{agentId}/prompt/versions/{versionId} — fetch the contents of a specific prompt version.