{
"statusCode": 400,
"error": "Bad Request",
"message": "Workspace context is required to fork an agent from a template"
}
{
"statusCode": 404,
"error": "Not Found",
"message": "No existe la plantilla solicitada"
}
{
"code": "COPILOT_ATTACHMENTS_CLOSED",
"message": "Adjuntar archivos en el chat no está disponible para este workspace."
}
Una plantilla es una versión de agente publicada en el catálogo que sirve como
punto de partida: al clonarla, el agente nuevo nace con blueprint, stages,
triggers e instrucciones ya escritos.El flujo son dos llamadas: descubrir qué plantillas hay y clonar la que
sirva.
GET /v1/catalogs/templates requiere el scope catalogs:read. No
hardcodees identificadores de plantilla en tu integración: el catálogo cambia,
y el listado es la única fuente al día.
Cada entrada trae el id de la plantilla, su slug, sus tags y el
agentVersionId que se clona. La visibility clasifica la plantilla: curada por
Leracom (system), compartida públicamente (community) o no publicada al
catálogo general (private).
El catálogo de plantillas es global, no está acotado por workspace: el listado
devuelve todas las plantillas activas que coincidan con los filtros. No
interpretes ?visibility=private como «las plantillas de mi workspace» — es una
etiqueta de la plantilla, no una pertenencia. Identifica las tuyas por slug o
por tags.
Versión concreta a clonar; por defecto, la publicada más reciente
name
No
Máx. 255 caracteres; hereda el de la plantilla si se omite
description
No
Máx. 1000 caracteres
status
No
inactive, training o active
debounceDelayMs
No
Entero ≥ 0
brief
No
Máx. 10 000 caracteres; contexto de negocio para personalizar
researchUrl
No
URL del sitio del cliente, para enriquecer la personalización
voiceId
No
id de un ítem de catálogo de tipo voice
documentRefs
No
Documentos previamente subidos con POST /v1/documents
Requiere el scope agents:write. La respuesta trae el agentId y el
versionId de la versión inicial.
Crea el agente en inactive mientras lo revisas. Un agente que nace active
empieza a atender con la configuración de la plantilla, sin tus políticas
aplicadas.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Datos necesarios para clonar una plantilla del catálogo y crear un nuevo agente en el workspace activo. Permite sobrescribir metadatos básicos del agente generado.
Los ficheros que el cliente adjuntó en el chat de creación, ya subidos y confirmados en el namespace agent-briefs, junto con lo que dijo de cada uno. Al crear el agente se reclaman, que es lo que impide que el barrido se los lleve a las 72 h.
Todo o nada: si un id no existe, no terminó de subirse, se subió a otro namespace o ya lo usa otro agente, la petición responde 422 nombrando cuáles fallaron y no se reclama ninguno. Un id de otro workspace se reporta como inexistente. Repetir el mismo uploadId en la lista responde 400.
La versión vigente del agente: la active si la hay y, si no, el borrador más
reciente. Es de aquí de donde sale el identificador de versión que piden las rutas
de blueprint, instrucciones y publicación — no hay un versionId plano.
Se omite cuando el agente todavía no tiene ninguna versión.
Las bases de conocimiento que este agente consulta durante la conversación.
Vacío significa que no consulta ninguna, no que no se sepa. Es la selección del cliente, leída del mismo sitio del que la lee el sync al publicar una versión, así que no puede divergir de lo que se toma como entrada al publicar.
Al publicar, el proveedor de voz recibe sólo las que además están listas y son suyas: una base a medio indexar aparece aquí y todavía no viaja.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Agents Studio Docs","colors":{"primary":"#0ea5e9","light":"#f0f9ff","dark":"#082f49"},"logo":{"light":"https://mintcdn.com/supervisorai/aFOceNtmZJygjrCt/logo/leracom.png?fit=max\u0026auto=format\u0026n=aFOceNtmZJygjrCt\u0026q=85\u0026s=50cc1af96825067fbe033d98f4ba5e29","dark":"https://mintcdn.com/supervisorai/aFOceNtmZJygjrCt/logo/leracom.png?fit=max\u0026auto=format\u0026n=aFOceNtmZJygjrCt\u0026q=85\u0026s=50cc1af96825067fbe033d98f4ba5e29"},"favicon":"https://mintcdn.com/supervisorai/aFOceNtmZJygjrCt/favicon.svg?fit=max\u0026auto=format\u0026n=aFOceNtmZJygjrCt\u0026q=85\u0026s=64d7e96a6622a26f64dcbcaba4b2f2c8","navbar":{"links":[{"href":"mailto:sistemas@getsupervisor.ai","label":"Soporte"}],"primary":{"type":"button","label":"Agents Studio","href":"https://agents.studio.getsupervisor.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/supervisor-ai","facebook":"https://www.facebook.com/profile.php?id=61551044721614","instagram":"https://www.instagram.com/supervisor.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supervisorai","hasAudioNarration":false,"actualSubdomain":"supervisorai","customDomains":["docs.getsupervisor.ai"],"gitSource":{"type":"github","owner":"julio-supervisor","repo":"agents-studio-be","deployBranch":"develop","contentDirectory":"apps/public-api/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ab558748ee556b966258d15","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Referencia API","count":130},{"language":"default","tag":"Referencia de endpoints","count":113},{"language":"default","tag":"Webhooks","count":14},{"language":"default","tag":"Blog","count":10},{"language":"default","tag":"Agent Schedules","count":9},{"language":"default","tag":"Agents","count":8},{"language":"default","tag":"Campaigns","count":8},{"language":"default","tag":"Knowledge Bases","count":7},{"language":"default","tag":"Tools","count":7},{"language":"default","tag":"Agent Versions","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/templates","slug":"/api-reference/endpoint/templates","pageMetadata":{"title":"Plantillas de agentes","description":"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.","openapi":"POST /v1/agents/from-template","href":"/api-reference/endpoint/templates"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Una plantilla es una versión de agente publicada en el catálogo que sirve como\npunto de partida: al clonarla, el agente nuevo nace con blueprint, stages,\ntriggers e instrucciones ya escritos.`}),`\n`,_jsxs(_components.p,{children:[`El flujo son dos llamadas: `,_jsx(_components.strong,{children:`descubrir`}),` qué plantillas hay y `,_jsx(_components.strong,{children:`clonar`}),` la que\nsirva.`]}),`\n`,_jsx(Heading,{level:`2`,id:`1-·-descubrir-plantillas`,children:`1 · Descubrir plantillas`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /v1/catalogs/templates`}),` requiere el scope `,_jsx(`code`,{children:`catalogs:read`}),`. No\nhardcodees identificadores de plantilla en tu integración: el catálogo cambia,\ny el listado es la única fuente al día.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API_BASE_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/catalogs/templates\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Workspace-Id: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$WORKSPACE_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Cada entrada trae el `,_jsx(_components.code,{children:`id`}),` de la plantilla, su `,_jsx(_components.code,{children:`slug`}),`, sus `,_jsx(_components.code,{children:`tags`}),` y el\n`,_jsx(_components.code,{children:`agentVersionId`}),` que se clona. La `,_jsx(_components.code,{children:`visibility`}),` clasifica la plantilla: curada por\nLeracom (`,_jsx(_components.code,{children:`system`}),`), compartida públicamente (`,_jsx(_components.code,{children:`community`}),`) o no publicada al\ncatálogo general (`,_jsx(_components.code,{children:`private`}),`).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`El catálogo de plantillas es global, no está acotado por workspace: el listado\ndevuelve todas las plantillas activas que coincidan con los filtros. No\ninterpretes `,_jsx(_components.code,{children:`?visibility=private`}),` como «las plantillas de mi workspace» — es una\netiqueta de la plantilla, no una pertenencia. Identifica las tuyas por `,_jsx(_components.code,{children:`slug`}),` o\npor `,_jsx(_components.code,{children:`tags`}),`.`]})}),`\n`,_jsx(_components.p,{children:`Para acotar el listado:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Sólo las curadas`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /v1/catalogs/templates?visibility=system`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Por caso de uso`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /v1/catalogs/templates?tags=cobranza,voz`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`2-·-clonar-la-plantilla`,children:`2 · Clonar la plantilla`}),`\n`,_jsxs(_components.p,{children:[`Sólo `,_jsx(_components.code,{children:`templateId`}),` es obligatorio. Si omites `,_jsx(_components.code,{children:`templateVersionId`}),` se usa la versión\npublicada más reciente de la plantilla.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API_BASE_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/agents/from-template\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Workspace-Id: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$WORKSPACE_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"templateId\": \"ec9205ec-7c0c-41b7-86da-67cc3c2dd0f2\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Cobranza Preventiva - Retail\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"status\": \"inactive\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`15`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`createClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '@getsupervisor/agents-studio-sdk'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` createClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` baseUrl:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_BASE_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` workspaceId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`WORKSPACE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agents`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`forkFromTemplate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` templateId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'ec9205ec-7c0c-41b7-86da-67cc3c2dd0f2'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Cobranza Preventiva - Retail'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` status:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'inactive'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agentId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`versionId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`campos-del-cuerpo`,children:`Campos del cuerpo`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Requerido`}),_jsx(_components.th,{children:`Notas`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`templateId`})}),_jsx(_components.td,{children:`Sí`}),_jsx(_components.td,{children:`UUID de la plantilla del catálogo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`templateVersionId`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Versión concreta a clonar; por defecto, la publicada más reciente`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Máx. 255 caracteres; hereda el de la plantilla si se omite`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`description`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Máx. 1000 caracteres`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`inactive`}),`, `,_jsx(_components.code,{children:`training`}),` o `,_jsx(_components.code,{children:`active`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`debounceDelayMs`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Entero ≥ 0`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`brief`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Máx. 10 000 caracteres; contexto de negocio para personalizar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`researchUrl`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`URL del sitio del cliente, para enriquecer la personalización`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`voiceId`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`id`}),` de un ítem de catálogo de tipo `,_jsx(_components.code,{children:`voice`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`documentRefs`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Documentos previamente subidos con `,_jsx(_components.code,{children:`POST /v1/documents`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Requiere el scope `,_jsx(_components.code,{children:`agents:write`}),`. La respuesta trae el `,_jsx(_components.code,{children:`agentId`}),` y el\n`,_jsx(_components.code,{children:`versionId`}),` de la versión inicial.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Crea el agente en `,_jsx(_components.code,{children:`inactive`}),` mientras lo revisas. Un agente que nace `,_jsx(_components.code,{children:`active`}),`\nempieza a atender con la configuración de la plantilla, sin tus políticas\naplicadas.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`3-·-antes-de-publicar`,children:`3 · Antes de publicar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Conecta las herramientas que el caso de uso pida —agenda, función propia,\ntransferencia— desde la pestaña `,_jsx(_components.strong,{children:`Herramientas`}),` del agente.`]}),`\n`,_jsxs(_components.li,{children:[`Ajusta el horario de atención con\n`,_jsx(_components.code,{children:`POST /v1/agents/{agentId}/schedules`}),`, y las excepciones puntuales con\n`,_jsx(_components.code,{children:`POST /v1/agents/{agentId}/schedules/exceptions`}),`.`]}),`\n`,_jsx(_components.li,{children:`Revisa saludo, reglas críticas y triggers contra tus políticas internas.`}),`\n`,_jsxs(_components.li,{children:[`Deja constancia del cambio en `,_jsx(_components.code,{children:`notes`}),` al publicar la versión\n(`,_jsx(_components.code,{children:`PATCH /v1/agents/{agentId}/versions/{versionId}/notes`}),`).`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Plantillas de agentes","description":"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.","openapi":"POST /v1/agents/from-template","href":"/api-reference/endpoint/templates"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1 · Descubrir plantillas","slug":"1-·-descubrir-plantillas","depth":2,"children":[]},{"title":"2 · Clonar la plantilla","slug":"2-·-clonar-la-plantilla","depth":2,"children":[{"title":"Campos del cuerpo","slug":"campos-del-cuerpo","depth":3,"children":[]}]},{"title":"3 · Antes de publicar","slug":"3-·-antes-de-publicar","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"summary":"Crear agente a partir de una plantilla (fork de agent_version)","description":"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.","operationId":"forkAgentFromTemplate","requestBody":"f0f3dc79-2928-4584-adf2-0fc988e42c22","responses":{"201":"b0322f16-b254-4f59-910e-40dba3ab4991","400":"e4065972-52af-4ff8-af2c-10d7854ddf87","404":"b87d05bf-fe0e-4f37-98e1-faa5772f896b","422":"d1b6e723-cd79-4664-9d37-90e267f270f4"},"method":"post","type":"path","servers":["0be97b1f-0dc6-4cbd-a6d4-29e384bd2b64","41f9c1e2-e079-49e6-8b36-a71dbc10245d"],"security":["8ea4ebc0-2531-4937-b95c-7a0510429de3","615db291-8983-49c9-a781-a5630059c2a7"],"path":"/v1/agents/from-template","baseUrlOptions":["https://api-prod.studio.getsupervisor.ai","https://sandbox.agents.studio.getsupervisor.ai"],"title":"Crear agente a partir de una plantilla (fork de agent_version)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Datos necesarios para clonar una plantilla del catálogo y crear un nuevo agente en el workspace activo. Permite sobrescribir metadatos básicos del agente generado.","properties":{"templateId":{"type":"string","format":"uuid","description":"Identificador de la plantilla a clonar.","isRequired":true,"uniqueKey":"templateId","typeLabel":"string\u003cuuid>"},"templateVersionId":{"type":"string","format":"uuid","description":"Opcional. Si no se especifica, se usa el `agent_version_id` configurado como predeterminado en la tabla `catalog_templates`.","uniqueKey":"templateVersionId","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","maxLength":255,"description":"Opcional. Nombre a asignar al nuevo agente.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Opcional. Nombre a asignar al nuevo agente.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","maxLength":1000,"description":"Opcional. Descripción operativa del agente.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":1000,"description":"Opcional. Descripción operativa del agente.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","enum":["inactive","training","active"],"description":"Opcional. Estado inicial del agente generado.","uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["inactive","training","active"],"description":"Opcional. Estado inicial del agente generado.","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"debounceDelayMs":{"oneOf":[{"type":"integer","minimum":0,"description":"Opcional. Delay antes de procesar eventos (milisegundos).","uniqueKey":"debounceDelayMs.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Opcional. Delay antes de procesar eventos (milisegundos).","uniqueKey":"debounceDelayMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"debounceDelayMs","typeLabel":"integer | null"},"brief":{"oneOf":[{"type":"string","maxLength":10000,"description":"Prompt de personalización para Claude Code headless. Si se proporciona, la respuesta cambia a SSE (text/event-stream) con eventos de progreso.","uniqueKey":"brief.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":10000,"description":"Prompt de personalización para Claude Code headless. Si se proporciona, la respuesta cambia a SSE (text/event-stream) con eventos de progreso.","uniqueKey":"brief.oneOf.1","typeLabel":"null"}],"uniqueKey":"brief","typeLabel":"string | null"},"researchUrl":{"oneOf":[{"type":"string","format":"uri","description":"URL del sitio web del cliente para que Claude investigue contexto.","uniqueKey":"researchUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"URL del sitio web del cliente para que Claude investigue contexto.","uniqueKey":"researchUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"researchUrl","typeLabel":"string\u003curi> | null"},"voiceId":{"oneOf":[{"type":"string","format":"uuid","description":"Voz seleccionada para el agente (UUID del catálogo de voces). Si se proporciona, se aplica al blueprint durante la personalización.","uniqueKey":"voiceId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Voz seleccionada para el agente (UUID del catálogo de voces). Si se proporciona, se aplica al blueprint durante la personalización.","uniqueKey":"voiceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"voiceId","typeLabel":"string\u003cuuid> | null"},"attachments":{"oneOf":[{"type":"array","maxItems":10,"description":"Los ficheros que el cliente adjuntó en el chat de creación, ya subidos y confirmados en el namespace `agent-briefs`, junto con lo que dijo de cada uno. Al crear el agente se **reclaman**, que es lo que impide que el barrido se los lleve a las 72 h.\nTodo o nada: si un id no existe, no terminó de subirse, se subió a otro namespace o ya lo usa otro agente, la petición responde `422` nombrando cuáles fallaron y no se reclama ninguno. Un id de otro workspace se reporta como inexistente. Repetir el mismo `uploadId` en la lista responde `400`.","items":{"type":"object","description":"Un fichero que el cliente adjuntó en el chat de creación, y para qué dijo que sirve.","properties":{"uploadId":{"type":"string","format":"uuid","description":"Id de una subida ya confirmada en el namespace `agent-briefs`.","isRequired":true,"uniqueKey":"attachments.oneOf.0.items.[INDEX].uploadId","typeLabel":"string\u003cuuid>"},"purpose":{"type":"string","maxLength":500,"description":"Lo que el cliente escribió al adjuntarlo —«úsalo para definir cómo contestamos las preguntas frecuentes»—. Viaja al prompt del armado como la descripción del documento, y es lo único que le dice al modelo qué hacer con él. Si se omite, la descripción es el nombre del archivo.","uniqueKey":"attachments.oneOf.0.items.[INDEX].purpose","typeLabel":"string"}},"required":["uploadId"],"additionalProperties":false,"uniqueKey":"attachments.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attachments.oneOf.0","typeLabel":"object[]"},{"type":"null","maxItems":10,"description":"Los ficheros que el cliente adjuntó en el chat de creación, ya subidos y confirmados en el namespace `agent-briefs`, junto con lo que dijo de cada uno. Al crear el agente se **reclaman**, que es lo que impide que el barrido se los lleve a las 72 h.\nTodo o nada: si un id no existe, no terminó de subirse, se subió a otro namespace o ya lo usa otro agente, la petición responde `422` nombrando cuáles fallaron y no se reclama ninguno. Un id de otro workspace se reporta como inexistente. Repetir el mismo `uploadId` en la lista responde `400`.","items":{"type":"object","description":"Un fichero que el cliente adjuntó en el chat de creación, y para qué dijo que sirve.","properties":{"uploadId":{"type":"string","format":"uuid","description":"Id de una subida ya confirmada en el namespace `agent-briefs`."},"purpose":{"type":"string","maxLength":500,"description":"Lo que el cliente escribió al adjuntarlo —«úsalo para definir cómo contestamos las preguntas frecuentes»—. Viaja al prompt del armado como la descripción del documento, y es lo único que le dice al modelo qué hacer con él. Si se omite, la descripción es el nombre del archivo."}},"required":["uploadId"],"additionalProperties":false},"uniqueKey":"attachments.oneOf.1","typeLabel":"null"}],"uniqueKey":"attachments","typeLabel":"object[] | null"}},"required":["templateId"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"basic":{"title":"basic","value":{"templateId":"0f92c4f0-62f7-4337-82c2-7d9b19c5b6a2","name":"Campaña de cobranza","status":"inactive","debounceDelayMs":500}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b0322f16-b254-4f59-910e-40dba3ab4991":{"description":"Agente creado a partir de plantilla","content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"agentId","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"agentType":{"type":"string","enum":["chat","voice"],"isRequired":true,"uniqueKey":"agentType","typeLabel":"enum\u003cstring>"},"workspaceId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"workspaceId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["inactive","training","active","archived","building","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"totalCalls":{"type":"integer","minimum":0,"description":"Total de llamadas realizadas por el agente.","isRequired":true,"uniqueKey":"totalCalls","typeLabel":"integer"},"totalOperationalDays":{"type":"integer","minimum":0,"description":"Total de días operativos desde la creación del agente.","isRequired":true,"uniqueKey":"totalOperationalDays","typeLabel":"integer"},"goalAchievedPercentage":{"type":"number","minimum":0,"maximum":100,"description":"Porcentaje de llamadas donde el objetivo fue alcanzado.","isRequired":true,"uniqueKey":"goalAchievedPercentage","typeLabel":"number"},"version":{"type":"object","description":"La versión vigente del agente: la `active` si la hay y, si no, el borrador más\nreciente. Es de aquí de donde sale el identificador de versión que piden las rutas\nde blueprint, instrucciones y publicación — no hay un `versionId` plano.\nSe omite cuando el agente todavía no tiene ninguna versión.","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"version.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","isRequired":true,"uniqueKey":"version.status","typeLabel":"string"},"number":{"type":"integer","isRequired":true,"uniqueKey":"version.number","typeLabel":"integer"}},"required":["id","status","number"],"uniqueKey":"version","typeLabel":"object"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","format":"uri","description":"URL pública opcional utilizada para representar al agente.","uniqueKey":"avatarUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"URL pública opcional utilizada para representar al agente.","uniqueKey":"avatarUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"avatarUrl","typeLabel":"string\u003curi> | null"},"debounceDelayMs":{"oneOf":[{"type":"integer","minimum":0,"description":"Delay opcional antes de enviar respuestas (milisegundos).","uniqueKey":"debounceDelayMs.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Delay opcional antes de enviar respuestas (milisegundos).","uniqueKey":"debounceDelayMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"debounceDelayMs","typeLabel":"integer | null"},"ownerUserId":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"ownerUserId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"ownerUserId.oneOf.1","typeLabel":"null"}],"uniqueKey":"ownerUserId","typeLabel":"string\u003cuuid> | null"},"knowledgeBaseIds":{"type":"array","description":"Las bases de conocimiento que este agente consulta durante la conversación.\nVacío significa que no consulta ninguna, no que no se sepa. Es la selección del cliente, leída del mismo sitio del que la lee el sync al publicar una versión, así que no puede divergir de lo que se toma como entrada al publicar.\nAl publicar, el proveedor de voz recibe sólo las que además están listas y son suyas: una base a medio indexar aparece aquí y todavía no viaja.","items":{"type":"string","format":"uuid","uniqueKey":"knowledgeBaseIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"knowledgeBaseIds","typeLabel":"string\u003cuuid>[]"}},"required":["agentId","name","agentType","workspaceId","status","createdAt","updatedAt","totalCalls","totalOperationalDays","goalAchievedPercentage"],"uniqueKey":"","typeLabel":"object"},"examples":{"created":{"title":"created","value":{"agentId":"8e7a9b94-2d5f-4d26-a2d5-6ff5f08fc81f","workspaceId":"a44bb95e-9f01-4d19-8b62-1f6f2b8e8363","name":"Cobranza Outbound Baseline","agentType":"voice","description":null,"status":"inactive","avatarUrl":null,"ownerUserId":"0a3c8cf2-6b54-4e89-8d36-7e67c77dfba5","debounceDelayMs":500,"totalCalls":0,"totalOperationalDays":0,"goalAchievedPercentage":0,"knowledgeBaseIds":[],"version":{"id":"4c01f8ad-9ae5-4b20-98af-9559a2899a21","status":"draft","number":1},"createdAt":"2025-10-15T09:21:45.000Z","updatedAt":"2025-10-15T09:21:45.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"e4065972-52af-4ff8-af2c-10d7854ddf87":{"description":"Petición inválida","content":{"application/json":{"schema":{"type":"object","description":"Forma común de los errores de la API. El filtro global responde\n`{ statusCode, error, message, path, timestamp }`; los 400 que produce la validación del\nbody llegan con `message` como arreglo de strings (uno por regla incumplida) y sin\n`path` ni `timestamp`.\n\n`code` y `details` **no** son parte del contrato general: sólo los traen los rechazos\nque los construyen explícitamente (por ejemplo `UPLOAD_REJECTED_BY_NAMESPACE` al\nreutilizar un archivo en otro namespace, o `PROVIDER_CAPACITY_EXHAUSTED` en un 429).\nNo ramifiques por `code` en el resto de las rutas: ahí no viene.\n","properties":{"statusCode":{"type":"integer","description":"Código HTTP de la respuesta.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"oneOf":[{"type":"string","description":"Mensaje legible para humanos. Es un arreglo cuando el 400 viene de la validación del body.","isRequired":true,"uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Mensaje legible para humanos. Es un arreglo cuando el 400 viene de la validación del body.","isRequired":true,"uniqueKey":"message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"message","typeLabel":"string | string[]"},"error":{"type":"string","description":"Etiqueta HTTP del estado (`Bad Request`, `Not Found`, …).","uniqueKey":"error","typeLabel":"string"},"path":{"type":"string","description":"Ruta de la petición que falló. Presente en los errores que emite el filtro global.","uniqueKey":"path","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Momento en que se generó la respuesta de error. Presente en los errores que emite el filtro global.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"code":{"type":"string","description":"Identificador estable del rechazo. Sólo en los errores que lo declaran; ausente en el resto.","uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","description":"Información adicional específica del error, presente sólo cuando el rechazo la construye.\nCuando aplique, `details.subcode` provee un identificador estable para que el frontend decida qué UI mostrar.\n","properties":{"subcode":{"type":"string","description":"Identificador específico del error (p.ej. `WORKSPACE_NOT_PROVISIONED`).","uniqueKey":"details.subcode","typeLabel":"string"},"workspaceId":{"type":"string","format":"uuid","description":"Identificador de workspace relacionado cuando aplica.","uniqueKey":"details.workspaceId","typeLabel":"string\u003cuuid>"}},"additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","message"],"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"error":"Bad Request","message":"Workspace context is required to fork an agent from a template"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"error":"Bad Request","message":"Workspace context is required to fork an agent from a template"}}},"exampleType":"examples"}},"exampleType":"examples"},"b87d05bf-fe0e-4f37-98e1-faa5772f896b":{"description":"Plantilla o versión de plantilla no encontrada","content":{"application/json":{"schema":{"type":"object","description":"Forma común de los errores de la API. El filtro global responde\n`{ statusCode, error, message, path, timestamp }`; los 400 que produce la validación del\nbody llegan con `message` como arreglo de strings (uno por regla incumplida) y sin\n`path` ni `timestamp`.\n\n`code` y `details` **no** son parte del contrato general: sólo los traen los rechazos\nque los construyen explícitamente (por ejemplo `UPLOAD_REJECTED_BY_NAMESPACE` al\nreutilizar un archivo en otro namespace, o `PROVIDER_CAPACITY_EXHAUSTED` en un 429).\nNo ramifiques por `code` en el resto de las rutas: ahí no viene.\n","properties":{"statusCode":{"type":"integer","description":"Código HTTP de la respuesta.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"oneOf":[{"type":"string","description":"Mensaje legible para humanos. Es un arreglo cuando el 400 viene de la validación del body.","isRequired":true,"uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Mensaje legible para humanos. Es un arreglo cuando el 400 viene de la validación del body.","isRequired":true,"uniqueKey":"message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"message","typeLabel":"string | string[]"},"error":{"type":"string","description":"Etiqueta HTTP del estado (`Bad Request`, `Not Found`, …).","uniqueKey":"error","typeLabel":"string"},"path":{"type":"string","description":"Ruta de la petición que falló. Presente en los errores que emite el filtro global.","uniqueKey":"path","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Momento en que se generó la respuesta de error. Presente en los errores que emite el filtro global.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"code":{"type":"string","description":"Identificador estable del rechazo. Sólo en los errores que lo declaran; ausente en el resto.","uniqueKey":"code","typeLabel":"string"},"details":{"type":"object","description":"Información adicional específica del error, presente sólo cuando el rechazo la construye.\nCuando aplique, `details.subcode` provee un identificador estable para que el frontend decida qué UI mostrar.\n","properties":{"subcode":{"type":"string","description":"Identificador específico del error (p.ej. `WORKSPACE_NOT_PROVISIONED`).","uniqueKey":"details.subcode","typeLabel":"string"},"workspaceId":{"type":"string","format":"uuid","description":"Identificador de workspace relacionado cuando aplica.","uniqueKey":"details.workspaceId","typeLabel":"string\u003cuuid>"}},"additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","message"],"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":404,"error":"Not Found","message":"No existe la plantilla solicitada"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"error":"Not Found","message":"No existe la plantilla solicitada"}}},"exampleType":"examples"}},"exampleType":"examples"},"d1b6e723-cd79-4664-9d37-90e267f270f4":{"description":"La petición no se puede atender tal como viene. `code` dice cuál de estas fue, y es\nlo que hay que mirar para ramificar — el `message` es prosa y cambia:\n\n- `COPILOT_ATTACHMENTS_CLOSED` — el workspace no tiene la función de adjuntos\n abierta. El cliente no puede corregirlo cambiando la petición, así que el mensaje\n nombra la causa en vez de pedir otro intento.\n- `ATTACHMENTS_REQUIRE_BRIEF` — vienen adjuntos sin `brief`. Los documentos son\n material para armar el agente y el armado sólo arranca con brief: sin él nadie los\n leería y, peor, nadie los reclamaría — el barrido se los llevaría a las 72 h\n después de un 201.\n- `ATTACHMENTS_UNUSABLE` — algún `uploadId` no se puede usar: no existe, no terminó\n de subirse, se subió a otro namespace o ya lo está usando otro agente. Es todo o\n nada, y `details.rejected` trae cada `uploadId` con su motivo, para no tener que\n releer el mensaje.\n\n**Todos** los 422 de esta ruta traen `code`: una excepción de dominio no llega aquí\n—se resuelve como 400 o 404—, así que la respuesta alterna sólo entre los dos\nesquemas con código, que son disjuntos por ese campo.\n\nLas de adjuntos no pueden ocurrir sin `attachments`: un alta sin ellos no consulta el\ninterruptor ni pasa por esas reglas.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Alguno de los `attachments` no se puede usar. Es todo o nada: si un archivo no sirve, no\nse usa ninguno, porque un armado al que le faltan documentos es peor que uno sin ellos —\nnadie sabría cuáles faltan.\n\nTiene esquema propio, y no es el rechazo genérico con `details` suelto, porque\n`details.rejected` es el dato que hace accionable la respuesta: sin garantizarlo en el\ncontrato, los tipos generados lo dejan opcional y quien llama no puede depender de él.\n","required":["code","message","details"],"properties":{"code":{"type":"string","enum":["ATTACHMENTS_UNUSABLE"],"isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","required":["rejected"],"properties":{"rejected":{"type":"array","minItems":1,"description":"Un adjunto por entrada, con el motivo por el que no sirve.","items":{"type":"object","required":["uploadId","reason"],"properties":{"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.details.rejected.items.[INDEX].uploadId","typeLabel":"string\u003cuuid>"},"reason":{"type":"string","enum":["not-found","not-ready","wrong-namespace","already-claimed"],"isRequired":true,"uniqueKey":"oneOf.0.details.rejected.items.[INDEX].reason","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.0.details.rejected.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.details.rejected","typeLabel":"object[]"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"El alta o la edición de un agente no se puede atender, y el rechazo trae un **código\nestable**: `code` es lo que hay que mirar para ramificar, porque el `message` es prosa y\ncambia.\n\n**Todos** los 422 de estas rutas tienen esta forma: las excepciones de dominio no llegan\naquí — `DomainExceptionFilter` las resuelve como 400 o 404, nunca como 422— y el resto de\nlos rechazos pasa por la misma pieza. Por eso el contrato puede cerrarse, y las respuestas\nsólo alternan entre este esquema y el de adjuntos inusables, que son **disjuntos por\n`code`**.\n\nEl `enum` es la **unión de la familia**, no la lista de lo que puede emitir cada ruta: el\nalta desde plantilla no acepta avatar, así que nunca devuelve los dos códigos de avatar.\nCada operación enumera los suyos en su propia descripción, que es donde ese detalle es\ncierto.\n","required":["code","message"],"properties":{"code":{"type":"string","enum":["COPILOT_ATTACHMENTS_CLOSED","ATTACHMENTS_REQUIRE_BRIEF","AGENT_AMBIGUOUS_AVATAR","AVATAR_UPLOAD_WRONG_NAMESPACE"],"description":"Identificador estable de la causa.","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"La causa en una frase, para enseñar. No es contrato — cambia.\n","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"code":"COPILOT_ATTACHMENTS_CLOSED","message":"Adjuntar archivos en el chat no está disponible para este workspace."},"examples":{"Example":{"title":"Example","value":{"code":"COPILOT_ATTACHMENTS_CLOSED","message":"Adjuntar archivos en el chat no está disponible para este workspace."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8ea4ebc0-2531-4937-b95c-7a0510429de3":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}},"615db291-8983-49c9-a781-a5630059c2a7":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key para autenticacion programatica por workspace. El workspace viaja dentro de la\npropia llave, así que con `x-api-key` no hace falta el header `x-workspace-id`.\n\nLa llave sólo autentica en el despliegue cuyo entorno coincide con el `environment` con\nel que se emitió: si no coinciden, cualquier ruta responde\n`401 API key environment mismatch` antes de mirar los scopes.\n","scopes":[]}}},"servers":{"0be97b1f-0dc6-4cbd-a6d4-29e384bd2b64":{"url":"https://api-prod.studio.getsupervisor.ai","description":"Producción"},"41f9c1e2-e079-49e6-8b36-a71dbc10245d":{"url":"https://sandbox.agents.studio.getsupervisor.ai","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key para autenticacion programatica por workspace. El workspace viaja dentro de la\npropia llave, así que con `x-api-key` no hace falta el header `x-workspace-id`.\n\nLa llave sólo autentica en el despliegue cuyo entorno coincide con el `environment` con\nel que se emitió: si no coinciden, cualquier ruta responde\n`401 API key environment mismatch` antes de mirar los scopes.\n","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key para autenticacion programatica por workspace. El workspace viaja dentro de la\npropia llave, así que con `x-api-key` no hace falta el header `x-workspace-id`.\n\nLa llave sólo autentica en el despliegue cuyo entorno coincide con el `environment` con\nel que se emitió: si no coinciden, cualquier ruta responde\n`401 API key environment mismatch` antes de mirar los scopes.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/public-api.yaml"},"subdomain":"supervisorai","siteName":"Agents Studio Docs","title":"Plantillas de agentes - Agents Studio Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T23:54:05.729Z","originalFileLocation":"api-reference/endpoint/templates.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agents Studio Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Plantillas de agentes - Agents Studio Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agents Studio Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getsupervisor.ai/api-reference/endpoint/templates\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supervisorai.mintlify.site/_mintlify/api/og/v2?division=Agentes\u0026amp;title=Plantillas+de+agentes\u0026amp;description=Descubre+plantillas+publicadas+y+cl%C3%B3nalas+con+blueprint%2C+stages%2C+triggers+e+instrucciones+ya+armados.\u0026amp;theme=6431dbdfdb602b0cfa9d209a\u0026amp;signature=01e88ee0125e2a14c6986e6e7222fdd8c7a6e585211714be209130771c3fd038\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Plantillas de agentes - Agents Studio Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supervisorai.mintlify.site/_mintlify/api/og/v2?division=Agentes\u0026amp;title=Plantillas+de+agentes\u0026amp;description=Descubre+plantillas+publicadas+y+cl%C3%B3nalas+con+blueprint%2C+stages%2C+triggers+e+instrucciones+ya+armados.\u0026amp;theme=6431dbdfdb602b0cfa9d209a\u0026amp;signature=01e88ee0125e2a14c6986e6e7222fdd8c7a6e585211714be209130771c3fd038\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/supervisorai/pMqwuhpUCGdZ2stR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agents Studio Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0ea5e9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getsupervisor.ai/api-reference/endpoint/templates\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/templates.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getsupervisor.ai/#organization\",\"name\":\"Agents Studio Docs\",\"url\":\"https://docs.getsupervisor.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supervisorai/aFOceNtmZJygjrCt/logo/leracom.png?fit=max\u0026auto=format\u0026n=aFOceNtmZJygjrCt\u0026q=85\u0026s=50cc1af96825067fbe033d98f4ba5e29\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getsupervisor.ai#website\",\"name\":\"Agents Studio Docs\",\"url\":\"https://docs.getsupervisor.ai\",\"publisher\":{\"@id\":\"https://docs.getsupervisor.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates#webpage\",\"url\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates\",\"name\":\"Plantillas de agentes\",\"description\":\"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\",\"dateModified\":\"2026-09-12T23:54:05.729Z\",\"isPartOf\":{\"@id\":\"https://docs.getsupervisor.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents Studio Docs\",\"item\":\"https://docs.getsupervisor.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Plantillas de agentes\",\"item\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates#apireference\",\"headline\":\"Plantillas de agentes\",\"name\":\"Plantillas de agentes\",\"description\":\"Descubre plantillas publicadas y clónalas con blueprint, stages, triggers e instrucciones ya armados.\",\"url\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getsupervisor.ai/api-reference/endpoint/templates#webpage\"},\"dateModified\":\"2026-09-12T23:54:05.729Z\",\"publisher\":{\"@id\":\"https://docs.getsupervisor.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getsupervisor.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agents Studio Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agents Studio Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/templates.md","siteName":"Agents Studio Docs","nav":{"global":{},"tabs":[{"tab":"Blog","pages":[{"title":"Blog","href":"/blog"}]},{"tab":"Referencia API","groups":[{"group":"Empezar","expanded":true,"pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Keys","href":"/api-reference/keys"},{"title":"TypeScript SDK","href":"/api-reference/sdk"}]},{"group":"Referencia de endpoints","expanded":true,"pages":[{"group":"Agents","pages":[{"title":"Listar agentes del workspace","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents","href":"/api-reference/agents/listar-agentes-del-workspace"},{"title":"Crear un agente y su versión inicial","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents","href":"/api-reference/agents/crear-un-agente-y-su-versión-inicial"},{"title":"Crear agente a partir de una plantilla (fork de agent_version)","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/from-template","href":"/api-reference/agents/crear-agente-a-partir-de-una-plantilla-fork-de-agent_version"},{"title":"Obtener detalle de un agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}","href":"/api-reference/agents/obtener-detalle-de-un-agente"},{"title":"Eliminar un agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}","href":"/api-reference/agents/eliminar-un-agente"},{"title":"Actualizar atributos configurables del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}","href":"/api-reference/agents/actualizar-atributos-configurables-del-agente"},{"title":"Clonar un agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/clone","href":"/api-reference/agents/clonar-un-agente"},{"title":"Reintentar el build de un agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/rebuild","href":"/api-reference/agents/reintentar-el-build-de-un-agente"}]},{"group":"Agent Schedules","pages":[{"title":"Listar horarios configurados del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/schedules","href":"/api-reference/agent-schedules/listar-horarios-configurados-del-agente"},{"title":"Crear un nuevo horario para el agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/schedules","href":"/api-reference/agent-schedules/crear-un-nuevo-horario-para-el-agente"},{"title":"Obtener detalle de un horario del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/schedules/{scheduleId}","href":"/api-reference/agent-schedules/obtener-detalle-de-un-horario-del-agente"},{"title":"Actualizar un horario existente del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml put /v1/agents/{agentId}/schedules/{scheduleId}","href":"/api-reference/agent-schedules/actualizar-un-horario-existente-del-agente"},{"title":"Listar excepciones del horario configurado","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/schedules/exceptions","href":"/api-reference/agent-schedules/listar-excepciones-del-horario-configurado"},{"title":"Crear excepción puntual del horario","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/schedules/exceptions","href":"/api-reference/agent-schedules/crear-excepción-puntual-del-horario"},{"title":"Obtener excepción puntual del horario","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/schedules/exceptions/{exceptionId}","href":"/api-reference/agent-schedules/obtener-excepción-puntual-del-horario"},{"title":"Eliminar excepción puntual del horario","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}/schedules/exceptions/{exceptionId}","href":"/api-reference/agent-schedules/eliminar-excepción-puntual-del-horario"},{"title":"Actualizar excepción puntual del horario","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/schedules/exceptions/{exceptionId}","href":"/api-reference/agent-schedules/actualizar-excepción-puntual-del-horario"}]},{"group":"Agent Versions","pages":[{"title":"Listar versiones configuradas del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/versions","href":"/api-reference/agent-versions/listar-versiones-configuradas-del-agente"},{"title":"Crear una nueva versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions","href":"/api-reference/agent-versions/crear-una-nueva-versión-del-agente"},{"title":"Obtener detalle de una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/versions/{versionId}","href":"/api-reference/agent-versions/obtener-detalle-de-una-versión-del-agente"},{"title":"Clonar una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions/{versionId}/clone","href":"/api-reference/agent-versions/clonar-una-versión-del-agente"},{"title":"Publicar una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions/{versionId}/publish","href":"/api-reference/agent-versions/publicar-una-versión-del-agente"},{"title":"Actualizar notas de una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/versions/{versionId}/notes","href":"/api-reference/agent-versions/actualizar-notas-de-una-versión-del-agente"}]},{"group":"Campaigns","pages":[{"title":"Crear campaña para una versión específica del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions/{versionId}/campaigns","href":"/api-reference/campaigns/crear-campaña-para-una-versión-específica-del-agente"},{"title":"Listar campañas masivas","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/campaigns","href":"/api-reference/campaigns/listar-campañas-masivas"},{"title":"Obtener detalle de una campaña","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/campaigns/{campaignId}","href":"/api-reference/campaigns/obtener-detalle-de-una-campaña"},{"title":"Listar ejecuciones individuales de una campaña","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/campaigns/{campaignId}/executions","href":"/api-reference/campaigns/listar-ejecuciones-individuales-de-una-campaña"},{"title":"Exportar ejecuciones de una campaña a CSV","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/campaigns/{campaignId}/executions/export","href":"/api-reference/campaigns/exportar-ejecuciones-de-una-campaña-a-csv"},{"title":"Pausar una campaña en curso","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/campaigns/{campaignId}/pause","href":"/api-reference/campaigns/pausar-una-campaña-en-curso"},{"title":"Reanudar una campaña pausada","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/campaigns/{campaignId}/resume","href":"/api-reference/campaigns/reanudar-una-campaña-pausada"},{"title":"Cancelar una campaña","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/campaigns/{campaignId}/cancel","href":"/api-reference/campaigns/cancelar-una-campaña"}]},{"group":"Agent Instructions","pages":[{"title":"Listar instrucciones de una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/versions/{versionId}/instructions","href":"/api-reference/agent-instructions/listar-instrucciones-de-una-versión-del-agente"},{"title":"Agregar una instrucción a la versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions/{versionId}/instructions","href":"/api-reference/agent-instructions/agregar-una-instrucción-a-la-versión-del-agente"},{"title":"Eliminar una instrucción","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}/versions/{versionId}/instructions/{instructionId}","href":"/api-reference/agent-instructions/eliminar-una-instrucción"},{"title":"Editar una instrucción existente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/versions/{versionId}/instructions/{instructionId}","href":"/api-reference/agent-instructions/editar-una-instrucción-existente"}]},{"group":"Agent Blueprints","pages":[{"title":"Obtener blueprint de una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/versions/{versionId}/blueprint","href":"/api-reference/agent-blueprints/obtener-blueprint-de-una-versión-del-agente"},{"title":"Crear blueprint para una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/versions/{versionId}/blueprint","href":"/api-reference/agent-blueprints/crear-blueprint-para-una-versión-del-agente"},{"title":"Actualizar blueprint de una versión del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/versions/{versionId}/blueprint","href":"/api-reference/agent-blueprints/actualizar-blueprint-de-una-versión-del-agente"},{"title":"Listar blueprints asociados al agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/blueprints","href":"/api-reference/agent-blueprints/listar-blueprints-asociados-al-agente"}]},{"group":"Blueprint Stages","pages":[{"title":"Listar stages de un blueprint del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/blueprints/{blueprintId}/stages","href":"/api-reference/blueprint-stages/listar-stages-de-un-blueprint-del-agente"},{"title":"Crear un stage dentro del blueprint del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/blueprints/{blueprintId}/stages","href":"/api-reference/blueprint-stages/crear-un-stage-dentro-del-blueprint-del-agente"},{"title":"Obtener detalle de un stage específico","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}","href":"/api-reference/blueprint-stages/obtener-detalle-de-un-stage-específico"},{"title":"Eliminar un stage del blueprint","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}","href":"/api-reference/blueprint-stages/eliminar-un-stage-del-blueprint"},{"title":"Actualizar un stage existente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}","href":"/api-reference/blueprint-stages/actualizar-un-stage-existente"},{"title":"Reordenar los stages del blueprint","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/blueprints/{blueprintId}/stages:reorder","href":"/api-reference/blueprint-stages/reordenar-los-stages-del-blueprint"}]},{"group":"Stage Triggers","pages":[{"title":"Listar triggers de un stage","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}/triggers","href":"/api-reference/stage-triggers/listar-triggers-de-un-stage"},{"title":"Crear trigger para un stage","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}/triggers","href":"/api-reference/stage-triggers/crear-trigger-para-un-stage"},{"title":"Obtener detalle de un trigger","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}/triggers/{triggerId}","href":"/api-reference/stage-triggers/obtener-detalle-de-un-trigger"},{"title":"Eliminar un trigger del stage","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}/triggers/{triggerId}","href":"/api-reference/stage-triggers/eliminar-un-trigger-del-stage"},{"title":"Actualizar un trigger existente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/agents/{agentId}/blueprints/{blueprintId}/stages/{stageId}/triggers/{triggerId}","href":"/api-reference/stage-triggers/actualizar-un-trigger-existente"}]},{"group":"Agent Phones","pages":[{"title":"Conectar un teléfono a un agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/agents/{agentId}/phones","href":"/api-reference/agent-phones/conectar-un-teléfono-a-un-agente"},{"title":"Desconectar un teléfono del agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/agents/{agentId}/phones/{phoneId}","href":"/api-reference/agent-phones/desconectar-un-teléfono-del-agente"},{"title":"Listar teléfonos disponibles del workspace","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/workspaces/{workspaceId}/phones","href":"/api-reference/agent-phones/listar-teléfonos-disponibles-del-workspace"}]},{"group":"Documents","pages":[{"title":"Crear slots de subida de documentos","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/documents","href":"/api-reference/documents/crear-slots-de-subida-de-documentos"}]},{"group":"API Keys","pages":[{"title":"Listar API Keys activas del usuario","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/api-keys","href":"/api-reference/api-keys/listar-api-keys-activas-del-usuario"},{"title":"Crear una API Key","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/api-keys","href":"/api-reference/api-keys/crear-una-api-key"},{"title":"Revocar una API Key","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/api-keys/{apiKeyId}","href":"/api-reference/api-keys/revocar-una-api-key"},{"title":"Mostrar valor completo de una API Key","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/api-keys/{apiKeyId}/show","href":"/api-reference/api-keys/mostrar-valor-completo-de-una-api-key"}]},{"group":"Workspaces","pages":[{"title":"Listar workspaces usando caché local","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/workspaces","href":"/api-reference/workspaces/listar-workspaces-usando-caché-local"},{"title":"Crear un workspace para el usuario autenticado","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/workspaces","href":"/api-reference/workspaces/crear-un-workspace-para-el-usuario-autenticado"},{"title":"Habilitar un workspace (API key, teléfono y Speech Analytics)","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/workspaces/enable","href":"/api-reference/workspaces/habilitar-un-workspace-api-key-teléfono-y-speech-analytics"}]},{"group":"Tools","pages":[{"title":"Listar catálogo de tools disponibles","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/tools","href":"/api-reference/tools/listar-catálogo-de-tools-disponibles"},{"title":"Ejecutar una acción de la tool para el agente indicado","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/tools/{toolId}/execute","href":"/api-reference/tools/ejecutar-una-acción-de-la-tool-para-el-agente-indicado"},{"title":"Crear una conexión entre un agente y la tool indicada","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/tools/{toolId}/connections","href":"/api-reference/tools/crear-una-conexión-entre-un-agente-y-la-tool-indicada"},{"title":"Listar conexiones entre agentes y tools","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/tools/connections","href":"/api-reference/tools/listar-conexiones-entre-agentes-y-tools"},{"title":"Crear una conexión entre un agente y una tool (por body)","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/tools/connections","href":"/api-reference/tools/crear-una-conexión-entre-un-agente-y-una-tool-por-body"},{"title":"Eliminar (desinstalar) una conexión entre un agente y una tool","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/tools/connections/{toolAgentConnectionId}","href":"/api-reference/tools/eliminar-desinstalar-una-conexión-entre-un-agente-y-una-tool"},{"title":"Ejecutar una acción de una tool usando el toolAgentConnectionId","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/tools/connections/{toolAgentConnectionId}/execute","href":"/api-reference/tools/ejecutar-una-acción-de-una-tool-usando-el-toolagentconnectionid"}]},{"group":"Catalogs","pages":[{"title":"Listar ítems de catálogo","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/catalogs/items","href":"/api-reference/catalogs/listar-ítems-de-catálogo"},{"title":"Crear ítem de catálogo","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/catalogs/items","href":"/api-reference/catalogs/crear-ítem-de-catálogo"},{"title":"Obtener detalle de un ítem de catálogo","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/catalogs/items/{itemId}","href":"/api-reference/catalogs/obtener-detalle-de-un-ítem-de-catálogo"},{"title":"Eliminar (soft delete) un ítem de catálogo","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/catalogs/items/{itemId}","href":"/api-reference/catalogs/eliminar-soft-delete-un-ítem-de-catálogo"}]},{"group":"Catalog Templates","pages":[{"title":"Listar plantillas de agente publicadas","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/catalogs/templates","href":"/api-reference/catalog-templates/listar-plantillas-de-agente-publicadas"},{"title":"Obtener detalle de una plantilla de agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/catalogs/templates/{templateId}","href":"/api-reference/catalog-templates/obtener-detalle-de-una-plantilla-de-agente"}]},{"group":"Calls","pages":[{"title":"Listar llamadas","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/calls","href":"/api-reference/calls/listar-llamadas"},{"title":"Stream de llamadas","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/calls/stream","href":"/api-reference/calls/stream-de-llamadas"},{"title":"Obtener llamada por id","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/calls/{callId}","href":"/api-reference/calls/obtener-llamada-por-id"}]},{"group":"Webhooks","pages":[{"title":"Listar webhooks del workspace","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks","href":"/api-reference/webhooks/listar-webhooks-del-workspace"},{"title":"Crear webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/webhooks","href":"/api-reference/webhooks/crear-webhook"},{"title":"Obtener detalle de webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks/{webhookId}","href":"/api-reference/webhooks/obtener-detalle-de-webhook"},{"title":"Eliminar webhook (soft-delete)","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/webhooks/{webhookId}","href":"/api-reference/webhooks/eliminar-webhook-soft-delete"},{"title":"Actualizar webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/webhooks/{webhookId}","href":"/api-reference/webhooks/actualizar-webhook"},{"title":"Listar suscripciones de un webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks/{webhookId}/subscriptions","href":"/api-reference/webhooks/listar-suscripciones-de-un-webhook"},{"title":"Crear suscripción de evento para un webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/webhooks/{webhookId}/subscriptions","href":"/api-reference/webhooks/crear-suscripción-de-evento-para-un-webhook"},{"title":"Obtener detalle de una suscripción","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks/{webhookId}/subscriptions/{subscriptionId}","href":"/api-reference/webhooks/obtener-detalle-de-una-suscripción"},{"title":"Eliminar suscripción","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/webhooks/{webhookId}/subscriptions/{subscriptionId}","href":"/api-reference/webhooks/eliminar-suscripción"},{"title":"Actualizar suscripción","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/webhooks/{webhookId}/subscriptions/{subscriptionId}","href":"/api-reference/webhooks/actualizar-suscripción"},{"title":"Listar deliveries de un webhook","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks/{webhookId}/deliveries","href":"/api-reference/webhooks/listar-deliveries-de-un-webhook"},{"title":"Obtener delivery por ID","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/webhooks/{webhookId}/deliveries/{deliveryId}","href":"/api-reference/webhooks/obtener-delivery-por-id"}]},{"group":"SIP Trunks","pages":[{"title":"Listar SIP trunks","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/sip/trunks","href":"/api-reference/sip-trunks/listar-sip-trunks"},{"title":"Crear un SIP trunk","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/sip/trunks","href":"/api-reference/sip-trunks/crear-un-sip-trunk"},{"title":"Obtener un SIP trunk por ID","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/sip/trunks/{trunkId}","href":"/api-reference/sip-trunks/obtener-un-sip-trunk-por-id"},{"title":"Eliminar un SIP trunk","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/sip/trunks/{trunkId}","href":"/api-reference/sip-trunks/eliminar-un-sip-trunk"},{"title":"Actualizar un SIP trunk","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml patch /v1/sip/trunks/{trunkId}","href":"/api-reference/sip-trunks/actualizar-un-sip-trunk"}]},{"group":"Message Templates","pages":[{"title":"Verificar conexión WhatsApp","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/message-templates/connection","href":"/api-reference/message-templates/verificar-conexión-whatsapp"},{"title":"Listar message templates del workspace","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/message-templates","href":"/api-reference/message-templates/listar-message-templates-del-workspace"},{"title":"Crear un message template","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/message-templates","href":"/api-reference/message-templates/crear-un-message-template"},{"title":"Eliminar un message template","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/message-templates/{id}","href":"/api-reference/message-templates/eliminar-un-message-template"}]},{"group":"Billing","pages":[{"title":"Obtener balance de consumo","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/billing/balance","href":"/api-reference/billing/obtener-balance-de-consumo"}]},{"group":"Usage","pages":[{"title":"Listar consumo por agente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/usage/agents","href":"/api-reference/usage/listar-consumo-por-agente"}]},{"group":"Uploads","pages":[{"title":"Pedir subir archivos a un destino","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/uploads/{namespace}","href":"/api-reference/uploads/pedir-subir-archivos-a-un-destino"},{"title":"Confirmar que el archivo ya está subido","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/uploads/{uploadId}/confirm","href":"/api-reference/uploads/confirmar-que-el-archivo-ya-está-subido"},{"title":"Usar un archivo ya subido también en otro destino","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/uploads/{namespace}/from/{uploadId}","href":"/api-reference/uploads/usar-un-archivo-ya-subido-también-en-otro-destino"},{"title":"Consultar una subida","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/uploads/{uploadId}","href":"/api-reference/uploads/consultar-una-subida"},{"title":"Descartar una subida","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/uploads/{uploadId}","href":"/api-reference/uploads/descartar-una-subida"}]},{"group":"Health","pages":[{"title":"Verificar disponibilidad del servicio","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/health","href":"/api-reference/health/verificar-disponibilidad-del-servicio"}]},{"group":"Knowledge Bases","pages":[{"title":"Listar las bases de conocimiento del workspace","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/knowledge-bases","href":"/api-reference/knowledge-bases/listar-las-bases-de-conocimiento-del-workspace"},{"title":"Dar de alta una base de conocimiento","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/knowledge-bases","href":"/api-reference/knowledge-bases/dar-de-alta-una-base-de-conocimiento"},{"title":"Consultar una base de conocimiento y sus documentos","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/knowledge-bases/{knowledgeBaseId}","href":"/api-reference/knowledge-bases/consultar-una-base-de-conocimiento-y-sus-documentos"},{"title":"Dar de baja una base de conocimiento","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/knowledge-bases/{knowledgeBaseId}","href":"/api-reference/knowledge-bases/dar-de-baja-una-base-de-conocimiento"},{"title":"Qué agentes consultan una base de conocimiento","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml get /v1/knowledge-bases/{knowledgeBaseId}/agents","href":"/api-reference/knowledge-bases/qué-agentes-consultan-una-base-de-conocimiento"},{"title":"Añadir documentos a una base existente","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml post /v1/knowledge-bases/{knowledgeBaseId}/documents","href":"/api-reference/knowledge-bases/añadir-documentos-a-una-base-existente"},{"title":"Quitar un documento de una base","description":"**Quitar el último documento se rechaza con `409`.** El proveedor no admite bases sin\nfuentes, y llevarse la base entera por quitar un archivo sería irreversible: la\ndesvincularía de todos los agentes que la consultan y no hay papelera. Para deshacerte\nde la base, usa `DELETE /v1/knowledge-bases/{knowledgeBaseId}`.\n\nDeshabilita el control de quitar cuando `documents` tenga un solo elemento; el `409`\nestá para el caso de carrera, no para descubrirlo.\n","deprecated":null,"version":null,"openapi":"/openapi/public-api.yaml delete /v1/knowledge-bases/{knowledgeBaseId}/documents/{documentId}","href":"/api-reference/knowledge-bases/quitar-un-documento-de-una-base"}]}]},{"group":"Agentes","expanded":true,"pages":[{"title":"Plantillas de agentes","openapi":"POST /v1/agents/from-template","href":"/api-reference/endpoint/templates"},{"title":"Stages y triggers","description":"Endpoints REST para manejar stages de blueprint y sus triggers conversacionales.","href":"/api-reference/endpoint/stages"},{"title":"Voces disponibles","href":"/api-reference/catalogs/voices"}]},{"group":"Herramientas del agente","expanded":true,"pages":[{"title":"Tools","href":"/api-reference/endpoint/tools"},{"title":"Agendar y gestionar citas (Cal.com)","href":"/api-reference/tools/cal-com"},{"title":"Función personalizada","href":"/api-reference/tools/custom-function"},{"title":"Geocoding","href":"/api-reference/tools/geocoding"}]},{"group":"Telefonía","expanded":true,"pages":[{"title":"Iniciar llamada","href":"/api-reference/endpoint/phone-call"},{"title":"Agendar llamada","href":"/api-reference/telephony/schedule-call"},{"title":"Calls","href":"/api-reference/endpoint/calls"},{"title":"Campaigns","href":"/api-reference/endpoint/campaigns"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"Webhooks","href":"/api-reference/endpoint/webhook"},{"title":"Notificaciones de llamada","href":"/api-reference/endpoint/notifications"}]},{"group":"MCP","expanded":true,"pages":[{"title":"MCP server","href":"/api-reference/mcp"}]}]}]},"basePath":"","title":"Plantillas de agentes - Agents Studio Docs","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}