Agentes

CRUD básico

list_agents

Sin argumentos. Devuelve todos los agentes accesibles agrupados por workspace.

get_agent

create_agent

update_agent

Mismos campos que create_agent pero todos opcionales, más agentId. El systemPrompt se versiona automáticamente — equivale a llamar a write_agent_prompt.

delete_agent

Prompt (versionado automático)

Cada escritura crea una nueva versión en el historial del agente y actualiza activePromptId y systemPrompt de forma atómica.

get_agent_prompt

Devuelve { systemPrompt, activePromptId, lastUpdate }.

write_agent_prompt

edit_agent_prompt

Por defecto intenta una coincidencia exacta y, si no encuentra, una más flexible con espacios normalizados. Devuelve editType: "exact" | "fuzzy" | "regex" para indicar cómo se resolvió.

list_agent_prompt_versions

Sub-agentes

Los sub-agentes son agentes regulares del workspace conectados al padre. Conectar y desconectar no afecta al agente referenciado — solamente cambia la relación con el padre.

list_agent_subagents

list_available_subagents

Devuelve todos los agentes del workspace (excepto el padre y los eliminados) con flag isAlreadyConnected.

connect_agent_subagent

Devuelve 409 si el sub-agente ya está conectado al padre.

update_agent_subagent_connection

Al cambiar task se limpian los campos del modo anterior automáticamente.

disconnect_agent_subagent

Retira la conexión. No elimina al sub-agente referenciado.

create_agent_subagent

Crea un agente nuevo y lo conecta como sub-agente en una sola llamada. Si pasas systemPrompt, se inicializa el historial de versiones del prompt del sub-agente automáticamente.

Guardrails

get_agent_guardrails

update_agent_guardrails

Todos los campos de configuración son opcionales — sólo se actualizan los presentes.

Reglas de asistencia

get_agent_assist_rules

update_agent_assist_rules

Horario

get_agent_schedule

update_agent_schedule

Acepta merge por día — los días no incluidos en serviceHours se conservan.

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

Base de conocimientos

list_agent_knowledge

create_agent_knowledge_from_url

Crea entradas a partir de archivos ya alojados públicamente (fileUrl) o desde texto crudo directo (content, sin archivo). Cada file debe incluir fileUrl o content. Platica descarga/extrae el contenido y genera título y descripción automáticamente cuando aplica.

Desde 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
  }
}

Desde texto crudo:

{
  "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

Ingesta URLs web. Platica extrae el contenido y genera título y descripción automáticamente.

update_agent_knowledge

Actualiza una entrada existente: agrega texto al contenido, lo reemplaza por completo, cambia status/metadata o re-procesa la fuente original. Devuelve 404 si la entrada no existe (no la crea).

delete_agent_knowledge

Elimina una entrada de la base de conocimientos del agente. El agente deja de poder consultarla.

Endpoints REST sin tool MCP

Algunos endpoints de la API REST no se exponen como herramientas MCP por simplicidad o porque requieren un flujo manual:

• POST /v1/agents/{agentId}/knowledge/upload — subida multipart de archivos (≤ 20 MB por request). Usa la API REST directamente; el resultado (fileUrl) se puede pasar a create_agent_knowledge_from_url.
• POST /v1/agents/{agentId}/knowledge/{knowledgeId}/reparse — re-procesar la fuente original de una entrada.
• GET /v1/agents/{agentId}/knowledge/{knowledgeId} — obtener una entrada individual (se puede simular filtrando el resultado de list_agent_knowledge).
• GET /v1/agents/{agentId}/prompt/versions/{versionId} — obtener el contenido de una versión específica del prompt.