using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddFile("files", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddFile("files", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("multipart/form-data; boundary=---011000010111000001101001")
val body = RequestBody.create(mediaType, "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
val request = Request.Builder()
.url("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts")
.post(body)
.addHeader("x-ib-api-key", "<api-key>")
.build()
val response = client.newCall(request).execute()
false
import Foundation
let parameters = [
[
"name": "files",
"value": "<string>",
"fileName": "example-file"
]
]
let boundary = "---011000010111000001101001"
var body = ""
for param in parameters {
let paramName = param["name"]!
body += "--\(boundary)\r\n"
body += "Content-Disposition:form-data; name=\"\(paramName)\""
if let filename = param["fileName"] {
let contentType = param["contentType"]!
let fileContent = try String(contentsOfFile: filename, encoding: .utf8)
body += "; filename=\"\(filename)\"\r\n"
body += "Content-Type: \(contentType)\r\n\r\n"
body += fileContent
} else if let paramValue = param["value"] {
body += "\r\n\r\n\(paramValue)"
}
}
let postData = Data(body.utf8)
let url = URL(string: "https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = ["x-ib-api-key": "<api-key>"]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))
Conserva id y revisa expiresAt. La referencia expira 24 horas después
de la carga.
3
Referencia los artifacts al ejecutar el agente
Envía los identificadores en artifacts al llamar a
POST /agents/{agentId}/execute:
curl -X POST "https://api.insuranceboosters.com/api/v1/agents/{agentId}/execute" \ -H "Content-Type: application/json" \ -H "x-ib-api-key: TU_API_KEY" \ -H "x-agent-session-id: mi-sesion-123" \ -d '{ "history": [ { "role": "user", "content": "Resume las coberturas de la póliza y describe los daños de la fotografía." } ], "artifacts": [ {"id": "<artifactId-poliza>"}, {"id": "<artifactId-foto>"} ] }'
Formatos admitidos
Categoría
Formatos
Documentos
PDF, JSON, TXT, CSV, Markdown, Word (.doc, .docx) y Excel (.xls, .xlsx)
Imágenes
JPEG, PNG y WebP
El tipo MIME del archivo debe coincidir con uno de los formatos admitidos.
Límites y vigencia
Límite
Valor
Archivos por carga
10
Tamaño por archivo
25 MB
Artifacts por ejecución
10
Tamaño total por ejecución
50 MB
Vigencia de cada referencia
24 horas
Puedes reutilizar una referencia durante su vigencia, siempre que ejecutes el
mismo agente desde la misma cuenta. No puedes usar un artifact de otro agente
ni repetir el mismo id dentro de una ejecución.
No envíes una URL, el contenido del archivo en base64 ni los demás campos de
la respuesta de carga. Cada elemento de artifacts debe contener únicamente
id.
Errores frecuentes
HTTP
Qué significa
Qué hacer
400
No enviaste archivos, el formato no está admitido o superaste la cantidad permitida.
Usa el campo files, revisa el formato y carga hasta 10 archivos.
400 al ejecutar
El artifact expiró, no pertenece al agente, está repetido, supera el total de 50 MB o el runtime no admite archivos.
Carga el archivo de nuevo, usa IDs únicos del mismo agente y confirma que el runtime sea openai-agents.
401
API key inválida o faltante.
Verifica x-ib-api-key.
404
El agente no existe o no pertenece a tu cuenta.
Abre el agente en la plataforma y confirma su agentId.
413
Un archivo supera 25 MB.
Reduce el tamaño o divide el archivo antes de cargarlo.
Authorizations
x-ib-api-key
string
header
required
Path Parameters
agentId
string
required
Identificador del agente. Solicítalo con tu ejecutivo de cuenta.
using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddFile("files", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddFile("files", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("multipart/form-data; boundary=---011000010111000001101001")
val body = RequestBody.create(mediaType, "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
val request = Request.Builder()
.url("https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts")
.post(body)
.addHeader("x-ib-api-key", "<api-key>")
.build()
val response = client.newCall(request).execute()
false
import Foundation
let parameters = [
[
"name": "files",
"value": "<string>",
"fileName": "example-file"
]
]
let boundary = "---011000010111000001101001"
var body = ""
for param in parameters {
let paramName = param["name"]!
body += "--\(boundary)\r\n"
body += "Content-Disposition:form-data; name=\"\(paramName)\""
if let filename = param["fileName"] {
let contentType = param["contentType"]!
let fileContent = try String(contentsOfFile: filename, encoding: .utf8)
body += "; filename=\"\(filename)\"\r\n"
body += "Content-Type: \(contentType)\r\n\r\n"
body += fileContent
} else if let paramValue = param["value"] {
body += "\r\n\r\n\(paramValue)"
}
}
let postData = Data(body.utf8)
let url = URL(string: "https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = ["x-ib-api-key": "<api-key>"]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Insurance Boosters API","description":"Documentación de la API de Insurance Boosters para integradores externos.","colors":{"primary":"#6746C2","light":"#6746C2","dark":"#8B6FE8"},"logo":{"light":"https://mintcdn.com/insurance-boosters/Xcjz70lXRQ2GedqW/assets/logo.png?fit=max\u0026auto=format\u0026n=Xcjz70lXRQ2GedqW\u0026q=85\u0026s=55567c3a57de1462828afcff190e9ac9","dark":"https://mintcdn.com/insurance-boosters/Xcjz70lXRQ2GedqW/assets/logo-dark.png?fit=max\u0026auto=format\u0026n=Xcjz70lXRQ2GedqW\u0026q=85\u0026s=2d6582fb0f5f441b10f827d6e36a9e73","href":"https://developers.insuranceboosters.com"},"favicon":"https://mintcdn.com/insurance-boosters/Xcjz70lXRQ2GedqW/assets/logo.png?fit=max\u0026auto=format\u0026n=Xcjz70lXRQ2GedqW\u0026q=85\u0026s=55567c3a57de1462828afcff190e9ac9","api":{"openapi":"openapi/whatsapp-v1.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","python","javascript","typescript","node","java","csharp","dotnet","go","ruby","php","kotlin","rust","swift","powershell"],"prefill":true,"autogenerate":true},"mdx":{"auth":{"method":"key","name":"x-ib-api-key"},"server":"https://api.insuranceboosters.com/api/v1"}},"appearance":{"default":"light","strict":false},"background":{"decoration":"gradient","color":{"light":"#F8F6FF","dark":"#1A1425"}},"navbar":{"links":[{"href":"https://insuranceboosters.com","label":"Sitio web"}],"primary":{"type":"button","label":"Soporte","href":"mailto:soporte@insuranceboosters.com"}},"footer":{"socials":{"website":"https://insuranceboosters.com"}},"seo":{"metatags":{"og:site_name":"Insurance Boosters API","og:locale":"es_MX"},"indexing":"all"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor","mcp","vscode","devin-mcp","aistudio","grok"],"display":"header"},"variables":{"api-base-url":"https://api.insuranceboosters.com/api/v1"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"insurance-boosters","hasAudioNarration":false,"actualSubdomain":"insurance-boosters","customDomains":["developers.insuranceboosters.com"],"gitSource":{"type":"github","owner":"autoclupp","repo":"insurance-boosters-app","deployBranch":"main","contentDirectory":"docs/brands/insurance-boosters","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff061497e1b315b98b792f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Referencia API","count":101},{"language":"default","tag":"Automatizaciones","count":38},{"language":"default","tag":"Tableros","count":25},{"language":"default","tag":"Agentes IA","count":18},{"language":"default","tag":"WhatsApp","count":13},{"language":"default","tag":"Agentes personalizados","count":11},{"language":"default","tag":"Pasos","count":11},{"language":"default","tag":"Registros","count":10},{"language":"default","tag":"Plantillas","count":10},{"language":"default","tag":"Triggers","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"alex@insuranceboosters.com"}},"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"agentes/usar-artifacts","slug":"/agentes/usar-artifacts","pageMetadata":{"title":"Usar artifacts con OpenAI Agents","description":"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.","openapi":"openapi/agentes-v1.yaml POST /agents/{agentId}/artifacts","keywords":["agentes","OpenAI Agents","artifacts","archivos","documentos","imágenes"],"href":"/agentes/usar-artifacts"},"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: \"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\"\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={a:`a`,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,Heading,Info,Step,Steps,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Los artifacts permiten que un agente analice documentos e imágenes sin enviar\nURLs de almacenamiento ni contenido en base64.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Solo puedes usar artifacts cuando el agente tiene\n`,_jsx(_components.code,{children:`runtime: \"openai-agents\"`}),` y `,_jsx(_components.code,{children:`mode: \"chat-conversation\"`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-empezar`,children:`Antes de empezar`}),`\n`,_jsx(_components.p,{children:`Necesitas:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Una `,_jsx(_components.a,{href:`/autenticacion`,children:`API key`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`El `,_jsx(_components.code,{children:`agentId`}),`, disponible en la URL del agente dentro de la plataforma.`]}),`\n`,_jsxs(_components.li,{children:[`Un agente `,_jsx(_components.a,{href:`/agentes/editar-agente`,children:`configurado`}),` con el runtime\n`,_jsx(_components.strong,{children:`OpenAI Agents`}),` (`,_jsx(_components.code,{children:`runtime: \"openai-agents\"`}),`).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`flujo-de-uso`,children:`Flujo de uso`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Carga los archivos`,children:[_jsxs(_components.p,{children:[`Envía uno o más archivos como `,_jsx(_components.code,{children:`multipart/form-data`}),`. Usa `,_jsx(_components.code,{children:`files`}),` como\nnombre de campo para cada archivo:`]}),_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:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.insuranceboosters.com/api/v1/agents/{agentId}/artifacts\"`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-ib-api-key: TU_API_KEY\"`}),_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:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"files=@poliza.pdf\"`}),_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:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"files=@foto-siniestro.jpg\"`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Guarda los identificadores`,children:[_jsx(_components.p,{children:`La respuesta contiene una referencia opaca por archivo:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"artifacts\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cartifactId>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agentId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cagentId>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fileName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"poliza.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mimeType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12345`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"document\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1710000000000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1710086400000`})]}),`\n`,_jsx(_components.span,{className:`line`,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`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Conserva `,_jsx(_components.code,{children:`id`}),` y revisa `,_jsx(_components.code,{children:`expiresAt`}),`. La referencia expira 24 horas después\nde la carga.`]})]}),_jsxs(Step,{title:`Referencia los artifacts al ejecutar el agente`,children:[_jsxs(_components.p,{children:[`Envía los identificadores en `,_jsx(_components.code,{children:`artifacts`}),` al llamar a\n`,_jsx(_components.code,{children:`POST /agents/{agentId}/execute`}),`:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`16`,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:`16`,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:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.insuranceboosters.com/api/v1/agents/{agentId}/execute\"`}),_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:` -H`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-ib-api-key: TU_API_KEY\"`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-agent-session-id: mi-sesion-123\"`}),_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:` -d`}),_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:` \"history\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` \"role\": \"user\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content\": \"Resume las coberturas de la póliza y describe los daños de la fotografía.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"artifacts\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"id\": \"\u003cartifactId-poliza>\"},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"id\": \"\u003cartifactId-foto>\"}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }'`})}),`\n`]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`formatos-admitidos`,children:`Formatos admitidos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Categoría`}),_jsx(_components.th,{children:`Formatos`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Documentos`}),_jsxs(_components.td,{children:[`PDF, JSON, TXT, CSV, Markdown, Word (`,_jsx(_components.code,{children:`.doc`}),`, `,_jsx(_components.code,{children:`.docx`}),`) y Excel (`,_jsx(_components.code,{children:`.xls`}),`, `,_jsx(_components.code,{children:`.xlsx`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Imágenes`}),_jsx(_components.td,{children:`JPEG, PNG y WebP`})]})]})]}),`\n`,_jsx(_components.p,{children:`El tipo MIME del archivo debe coincidir con uno de los formatos admitidos.`}),`\n`,_jsx(Heading,{level:`2`,id:`límites-y-vigencia`,children:`Límites y vigencia`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Límite`}),_jsx(_components.th,{children:`Valor`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Archivos por carga`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tamaño por archivo`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`25 MB`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Artifacts por ejecución`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tamaño total por ejecución`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`50 MB`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Vigencia de cada referencia`}),_jsx(_components.td,{children:`24 horas`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Puedes reutilizar una referencia durante su vigencia, siempre que ejecutes el\nmismo agente desde la misma cuenta. No puedes usar un artifact de otro agente\nni repetir el mismo `,_jsx(_components.code,{children:`id`}),` dentro de una ejecución.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`No envíes una URL, el contenido del archivo en base64 ni los demás campos de\nla respuesta de carga. Cada elemento de `,_jsx(_components.code,{children:`artifacts`}),` debe contener únicamente\n`,_jsx(_components.code,{children:`id`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`errores-frecuentes`,children:`Errores frecuentes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Qué significa`}),_jsx(_components.th,{children:`Qué hacer`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`No enviaste archivos, el formato no está admitido o superaste la cantidad permitida.`}),_jsxs(_components.td,{children:[`Usa el campo `,_jsx(_components.code,{children:`files`}),`, revisa el formato y carga hasta 10 archivos.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`400`}),` al ejecutar`]}),_jsx(_components.td,{children:`El artifact expiró, no pertenece al agente, está repetido, supera el total de 50 MB o el runtime no admite archivos.`}),_jsxs(_components.td,{children:[`Carga el archivo de nuevo, usa IDs únicos del mismo agente y confirma que el runtime sea `,_jsx(_components.code,{children:`openai-agents`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`API key inválida o faltante.`}),_jsxs(_components.td,{children:[`Verifica `,_jsx(_components.code,{children:`x-ib-api-key`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`El agente no existe o no pertenece a tu cuenta.`}),_jsxs(_components.td,{children:[`Abre el agente en la plataforma y confirma su `,_jsx(_components.code,{children:`agentId`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`413`})}),_jsx(_components.td,{children:`Un archivo supera 25 MB.`}),_jsx(_components.td,{children:`Reduce el tamaño o divide el archivo antes de cargarlo.`})]})]})]})]})}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":"Usar artifacts con OpenAI Agents","description":"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.","openapi":"openapi/agentes-v1.yaml POST /agents/{agentId}/artifacts","keywords":["agentes","OpenAI Agents","artifacts","archivos","documentos","imágenes"],"href":"/agentes/usar-artifacts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Antes de empezar","slug":"antes-de-empezar","depth":2,"children":[]},{"title":"Flujo de uso","slug":"flujo-de-uso","depth":2,"children":[]},{"title":"Formatos admitidos","slug":"formatos-admitidos","depth":2,"children":[]},{"title":"Límites y vigencia","slug":"límites-y-vigencia","depth":2,"children":[]},{"title":"Errores frecuentes","slug":"errores-frecuentes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"uploadAgentArtifacts","summary":"Cargar archivos para una ejecución","description":"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.","tags":["Agentes IA"],"parameters":["5920973f-cf47-47fa-826d-abea704cd999"],"requestBody":"bc6a869d-c667-48c3-bae1-be1943181039","responses":{"201":"64146b42-8269-4e03-90e3-02409df49d7f","400":"26c2a528-2910-460c-8033-4aaf820ca799","401":"97d280e4-9cf2-4a60-a4fb-fc621d277fab","404":"153ad6ea-9aa1-41f5-8e9c-48226b04bd96","413":"0695ac29-237c-44ca-9fd3-3e25d26e714f"},"method":"post","type":"path","servers":["0c7cfd29-159a-426a-b6d9-70da971bf87d"],"security":["6e8d4b37-8fc3-4234-88f4-61a4b0541168"],"path":"/agents/{agentId}/artifacts","baseUrlOptions":["https://api.insuranceboosters.com/api/v1"],"title":"Cargar archivos para una ejecución","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","typescript","node","java","csharp","dotnet","go","ruby","php","kotlin","rust","swift","powershell"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.files.items.0":"\u003cstring>"}]},"dependencies":{"parameters":{"5920973f-cf47-47fa-826d-abea704cd999":{"name":"agentId","in":"path","required":true,"description":"Identificador del agente. Solicítalo con tu ejecutivo de cuenta.","schema":{"type":"string","isRequired":true,"description":"Identificador del agente. Solicítalo con tu ejecutivo de cuenta.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["files"],"properties":{"files":{"type":"array","maxItems":10,"items":{"type":"string","format":"binary","uniqueKey":"files.items.[INDEX]","typeLabel":"file"},"isRequired":true,"uniqueKey":"files","typeLabel":"file[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"files":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"64146b42-8269-4e03-90e3-02409df49d7f":{"description":"Archivos cargados.","content":{"application/json":{"schema":{"type":"object","required":["artifacts"],"properties":{"artifacts":{"type":"array","items":{"type":"object","required":["id","agentId","fileName","mimeType","size","kind","createdAt","expiresAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].id","typeLabel":"string"},"agentId":{"type":"string","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].agentId","typeLabel":"string"},"fileName":{"type":"string","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].fileName","typeLabel":"string"},"mimeType":{"type":"string","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].mimeType","typeLabel":"string"},"size":{"type":"integer","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].size","typeLabel":"integer"},"kind":{"type":"string","enum":["document","image","text"],"isRequired":true,"uniqueKey":"artifacts.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].createdAt","typeLabel":"number"},"expiresAt":{"type":"number","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].expiresAt","typeLabel":"number"}},"uniqueKey":"artifacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"artifacts","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"artifacts":[{"id":"\u003cstring>","agentId":"\u003cstring>","fileName":"\u003cstring>","mimeType":"\u003cstring>","size":123,"kind":"document","createdAt":123,"expiresAt":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"26c2a528-2910-460c-8033-4aaf820ca799":{"description":"Archivo, tipo MIME o cantidad inválida.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"97d280e4-9cf2-4a60-a4fb-fc621d277fab":{"description":"API key inválida o faltante.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","description":"Detalle del error de validación o de negocio.","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"error.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Detalle del error de validación o de negocio.","uniqueKey":"error.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error","typeLabel":"string | object[]"},"message":{"type":"string","description":"Mensaje de error de autenticación.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidApiKey":{"title":"invalidApiKey","value":{"message":"Invalid API key."}},"missingAuth":{"title":"missingAuth","value":{"message":"Invalid authorization format."}}},"exampleType":"examples"}},"exampleType":"examples"},"153ad6ea-9aa1-41f5-8e9c-48226b04bd96":{"description":"El agente no existe o no pertenece a tu cuenta.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0695ac29-237c-44ca-9fd3-3e25d26e714f":{"description":"Un archivo excede 25 MB.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"6e8d4b37-8fc3-4234-88f4-61a4b0541168":{"IbApiKey":{"type":"apiKey","in":"header","name":"x-ib-api-key","scopes":[],"schemeName":"IbApiKey"}}},"servers":{"0c7cfd29-159a-426a-b6d9-70da971bf87d":{"url":"https://api.insuranceboosters.com/api/v1","description":"Producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-ib-api-key","scopes":[],"schemeName":"IbApiKey"},"schema":{"title":"x-ib-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"IbApiKey","name":"x-ib-api-key"}],"title":"IbApiKey"}]},"originalFileLocation":"openapi/agentes-v1.yaml"},"subdomain":"insurance-boosters","siteName":"Insurance Boosters API","title":"Usar artifacts con OpenAI Agents - Insurance Boosters API","contextualStarterQuestions":[{"_id":"6aff062316300ea66aa50d95","deploymentId":"6a546a253fa2eb468be6e093","questionText":"How do I upload files?","status":"active","generatedBy":"contextual","path":"agentes/usar-artifacts","createdAt":"2026-11-19T14:22:27.270Z","updatedAt":"2026-11-19T14:22:27.270Z","__v":0},{"_id":"6aff062316300ea66aa50d97","deploymentId":"6a546a253fa2eb468be6e093","questionText":"How do I use artifacts in agents?","status":"active","generatedBy":"contextual","path":"agentes/usar-artifacts","createdAt":"2026-11-19T14:22:27.270Z","updatedAt":"2026-11-19T14:22:27.270Z","__v":0},{"_id":"6aff062316300ea66aa50d96","deploymentId":"6a546a253fa2eb468be6e093","questionText":"What's the artifact expiration time?","status":"active","generatedBy":"contextual","path":"agentes/usar-artifacts","createdAt":"2026-11-19T14:22:27.270Z","updatedAt":"2026-11-19T14:22:27.270Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T14:22:23.623Z","originalFileLocation":"agentes/usar-artifacts.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=\"light\"}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=\"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Insurance Boosters API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_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/insurance-boosters/XD2CD8bAEI5GqRPn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Usar artifacts con OpenAI Agents - Insurance Boosters API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Insurance Boosters API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.insuranceboosters.com/agentes/usar-artifacts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://insurance-boosters.mintlify.site/_mintlify/api/og/v2?division=Agentes+personalizados\u0026amp;title=Usar+artifacts+con+OpenAI+Agents\u0026amp;description=Carga+documentos+e+im%C3%A1genes+y+%C3%BAsalos+como+contexto+al+ejecutar+un+agente+con+runtime+OpenAI+Agents.\u0026amp;theme=fd26171829582214a7d44de3\u0026amp;signature=34f2fc3e767ce732f86d45b4ff2085881fae90eaa228951af641a1dcf1338d5e\">\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=\"Usar artifacts con OpenAI Agents - Insurance Boosters API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://insurance-boosters.mintlify.site/_mintlify/api/og/v2?division=Agentes+personalizados\u0026amp;title=Usar+artifacts+con+OpenAI+Agents\u0026amp;description=Carga+documentos+e+im%C3%A1genes+y+%C3%BAsalos+como+contexto+al+ejecutar+un+agente+con+runtime+OpenAI+Agents.\u0026amp;theme=fd26171829582214a7d44de3\u0026amp;signature=34f2fc3e767ce732f86d45b4ff2085881fae90eaa228951af641a1dcf1338d5e\">\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/insurance-boosters/XD2CD8bAEI5GqRPn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Insurance Boosters API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6746C2\">\u003cmeta data-mint-head name=\"og:locale\" content=\"es_MX\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.insuranceboosters.com/agentes/usar-artifacts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agentes/usar-artifacts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.insuranceboosters.com/#organization\",\"name\":\"Insurance Boosters API\",\"url\":\"https://developers.insuranceboosters.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/insurance-boosters/Xcjz70lXRQ2GedqW/assets/logo.png?fit=max\u0026auto=format\u0026n=Xcjz70lXRQ2GedqW\u0026q=85\u0026s=55567c3a57de1462828afcff190e9ac9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.insuranceboosters.com#website\",\"name\":\"Insurance Boosters API\",\"url\":\"https://developers.insuranceboosters.com\",\"publisher\":{\"@id\":\"https://developers.insuranceboosters.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts#webpage\",\"url\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts\",\"name\":\"Usar artifacts con OpenAI Agents\",\"description\":\"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\",\"dateModified\":\"2026-11-19T14:22:23.623Z\",\"isPartOf\":{\"@id\":\"https://developers.insuranceboosters.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agentes IA\",\"item\":\"https://developers.insuranceboosters.com/agentes/introduccion\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agentes personalizados\",\"item\":\"https://developers.insuranceboosters.com/agentes/personalizados\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Usar artifacts con OpenAI Agents\",\"item\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts#apireference\",\"headline\":\"Usar artifacts con OpenAI Agents\",\"name\":\"Usar artifacts con OpenAI Agents\",\"description\":\"Carga documentos e imágenes y úsalos como contexto al ejecutar un agente con runtime OpenAI Agents.\",\"url\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts\",\"mainEntityOfPage\":{\"@id\":\"https://developers.insuranceboosters.com/agentes/usar-artifacts#webpage\"},\"dateModified\":\"2026-11-19T14:22:23.623Z\",\"keywords\":\"agentes, OpenAI Agents, artifacts, archivos, documentos, imágenes\",\"publisher\":{\"@id\":\"https://developers.insuranceboosters.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.insuranceboosters.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Insurance Boosters API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Insurance Boosters API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/agentes/usar-artifacts.md","siteName":"Insurance Boosters API","nav":{"global":null,"tabs":[{"tab":"Inicio","icon":"house","pages":[{"title":"Inicio","href":""}]},{"tab":"Referencia API","icon":"square-terminal","groups":[{"group":"WhatsApp","icon":"message-circle","root":{"title":"WhatsApp","icon":"message-circle","href":"/whatsapp/introduccion"},"directory":"accordion","pages":[{"group":"Plantillas","icon":"message-square-text","root":{"title":"Plantillas","icon":"message-square-text","href":"/whatsapp/plantillas"},"pages":[{"title":"Listar plantillas","openapi":"openapi/whatsapp-v1.json GET /whatsapp/{phoneNumberId}/templates","href":"/whatsapp/listar-plantillas"},{"title":"Enviar plantilla","openapi":"openapi/whatsapp-v1.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla"},{"group":"Ejemplos","icon":"list-tree","root":{"title":"Tipos de plantilla","href":"/whatsapp/tipos-de-plantilla"},"pages":[{"title":"Sin variables","openapi":"openapi/examples/sin-variables.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/sin-variables"},{"title":"Variables posicionales","openapi":"openapi/examples/variables-posicionales.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/variables-posicionales"},{"title":"Variables con nombre","openapi":"openapi/examples/variables-con-nombre.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/variables-con-nombre"},{"title":"Header con imagen","openapi":"openapi/examples/header-imagen.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/header-imagen"},{"title":"Header con PDF","openapi":"openapi/examples/header-pdf.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/header-pdf"},{"title":"Header con video","openapi":"openapi/examples/header-video.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/header-video"},{"title":"Botones dinámicos","openapi":"openapi/examples/botones-dinamicos.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/botones-dinamicos"},{"title":"Plantilla con WhatsApp Flow","openapi":"openapi/whatsapp-v1.json POST /whatsapp/{phoneNumberId}/template","href":"/whatsapp/enviar-plantilla/flow"}]}]},{"group":"Mensajes con archivo","icon":"paperclip","root":{"title":"Mensajes con archivo y texto","icon":"paperclip","href":"/whatsapp/mensajes-con-archivo"},"pages":[{"title":"Enviar documento con texto","openapi":"openapi/whatsapp-v1.json POST /whatsapp/{phoneNumberId}/document","href":"/whatsapp/enviar-documento"},{"title":"Enviar imagen con texto","openapi":"openapi/whatsapp-v1.json POST /whatsapp/{phoneNumberId}/image","href":"/whatsapp/enviar-imagen"},{"title":"Enviar video con texto","openapi":"openapi/whatsapp-v1.json POST /whatsapp/{phoneNumberId}/video","href":"/whatsapp/enviar-video"}]}]},{"group":"Contactos","icon":"contact","root":{"title":"Contactos","icon":"contact","href":"/contactos/introduccion"},"directory":"accordion","pages":[{"title":"Obtener esquema de contactos","openapi":"openapi/contactos-v1.yaml GET /tenants/{tenantId}/schemas/contact","href":"/contactos/obtener-schema"},{"title":"Crear contacto","openapi":"openapi/contactos-v1.yaml POST /contacts","href":"/contactos/crear-contacto"},{"title":"Listar contactos","openapi":"openapi/contactos-v1.yaml GET /contacts","href":"/contactos/listar-contactos"},{"title":"Buscar contactos","openapi":"openapi/contactos-v1.yaml POST /contacts/search","href":"/contactos/buscar-contactos"},{"title":"Consultar contacto","openapi":"openapi/contactos-v1.yaml GET /contacts/{contactId}","href":"/contactos/consultar-contacto"},{"title":"Actualizar contacto","openapi":"openapi/contactos-v1.yaml PATCH /contacts/{contactId}","href":"/contactos/actualizar-contacto"},{"title":"Eliminar contacto","openapi":"openapi/contactos-v1.yaml DELETE /contacts/{contactId}","href":"/contactos/eliminar-contacto"}]},{"group":"Agentes IA","icon":"bot","root":{"title":"Agentes IA","icon":"bot","href":"/agentes/introduccion"},"directory":"card","pages":[{"group":"Agentes personalizados","icon":"bot","root":{"title":"Agentes personalizados","icon":"bot","href":"/agentes/personalizados"},"directory":"accordion","pages":[{"title":"Editar agente personalizado","description":"Actualiza uno o más campos de un agente de IA administrado desde la plataforma.","openapi":"openapi/agentes-v1.yaml PUT /agents/{agentId}","href":"/agentes/editar-agente"},{"title":"Usar artifacts con OpenAI Agents","openapi":"openapi/agentes-v1.yaml POST /agents/{agentId}/artifacts","href":"/agentes/usar-artifacts"},{"title":"Ejecutar agente personalizado","description":"Envía un mensaje a un agente de IA administrado desde la plataforma y recibe su respuesta.","openapi":"openapi/agentes-v1.yaml POST /agents/{agentId}/execute","href":"/agentes/ejecutar-agente"},{"group":"Herramientas","icon":"wrench","root":{"title":"Herramientas","icon":"wrench","href":"/agentes/herramientas/introduccion"},"directory":"accordion","pages":[{"title":"Tipos de herramienta","href":"/agentes/herramientas/tipos-de-herramienta"},{"title":"Listar herramientas","openapi":"openapi/herramientas-agentes-v1.yaml GET /tools","href":"/agentes/herramientas/listar-herramientas"},{"title":"Crear herramienta","openapi":"openapi/herramientas-agentes-v1.yaml POST /tools","href":"/agentes/herramientas/crear-herramienta"},{"title":"Consultar herramienta","openapi":"openapi/herramientas-agentes-v1.yaml GET /tools/{toolId}","href":"/agentes/herramientas/consultar-herramienta"},{"title":"Actualizar herramienta","openapi":"openapi/herramientas-agentes-v1.yaml PUT /tools/{toolId}","href":"/agentes/herramientas/actualizar-herramienta"},{"title":"Consultar uso de herramienta","openapi":"openapi/herramientas-agentes-v1.yaml GET /tools/{toolId}/usage","href":"/agentes/herramientas/consultar-uso"},{"title":"Probar código","openapi":"openapi/herramientas-agentes-v1.yaml POST /tools/test-run-code","href":"/agentes/herramientas/probar-codigo"},{"title":"Eliminar herramienta","openapi":"openapi/herramientas-agentes-v1.yaml DELETE /tools/{toolId}","href":"/agentes/herramientas/eliminar-herramienta"}]}]},{"group":"Agentes preconfigurados","icon":"sparkles","root":{"title":"Agentes preconfigurados","icon":"sparkles","href":"/agentes/preconfigurados"},"directory":"card","pages":[{"group":"Seguros","icon":"shield","root":{"title":"Agentes preconfigurados para Seguros","sidebarTitle":"Seguros","icon":"shield","href":"/agentes/industrias/seguros"},"directory":"card","pages":[{"title":"Agente de IA: Emisión RC Profesional en GNP","sidebarTitle":"GNP: Emisión RC Profesional","icon":"shield-check","href":"/automatizaciones/paso-gnp-emision-rc-profesional"},{"title":"Agente de IA: Cotización GMM en GNP","sidebarTitle":"GNP: cotización GMM","icon":"heart-pulse","href":"/automatizaciones/paso-gnp-cotizacion-gmm"},{"title":"Agente de IA: Reporte de pólizas y recibos pendientes en GNP","sidebarTitle":"GNP: pólizas y recibos pendientes","icon":"file-search","href":"/automatizaciones/paso-gnp-recibos-vencidos"},{"title":"Agente de IA: Reporte de pólizas y recibos pendientes en Quálitas","sidebarTitle":"Quálitas: reporte pendiente","icon":"file-down","tag":"Nuevo","href":"/automatizaciones/paso-qualitas-cobranza-pendiente"},{"title":"Agente de IA: PDFs de recibos pendientes en GNP","sidebarTitle":"GNP: PDFs de recibos","icon":"file-down","href":"/automatizaciones/paso-gnp-documentos-recibos"},{"title":"Agente de IA: Cotización GMM en HDI","sidebarTitle":"HDI: cotización GMM","icon":"heart-pulse","href":"/automatizaciones/paso-hdi-cotizacion-gmm"},{"title":"Agente de IA: Cotización GMM en MAPFRE","sidebarTitle":"MAPFRE: cotización GMM","icon":"heart-pulse","href":"/automatizaciones/paso-mapfre-cotizacion-gmm"}]}]}]},{"group":"Automatizaciones","icon":"workflow","root":{"title":"Automatizaciones","icon":"workflow","href":"/automatizaciones/introduccion"},"directory":"accordion","pages":[{"group":"Definición","icon":"file-pen","root":{"title":"Definición","icon":"file-pen","href":"/automatizaciones/definicion"},"pages":[{"title":"Listar automatizaciones","openapi":"openapi/automatizaciones-v1.yaml GET /workflows","href":"/automatizaciones/listar-automatizaciones"},{"title":"Crear automatización","openapi":"openapi/automatizaciones-v1.yaml POST /workflows","href":"/automatizaciones/crear-automatizacion"},{"title":"Consultar automatización","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}","href":"/automatizaciones/consultar-automatizacion"},{"title":"Actualizar automatización","openapi":"openapi/automatizaciones-v1.yaml PUT /workflows/{workflowId}","href":"/automatizaciones/actualizar-automatizacion"},{"title":"Eliminar automatización","openapi":"openapi/automatizaciones-v1.yaml DELETE /workflows/{workflowId}","href":"/automatizaciones/eliminar-automatizacion"}]},{"group":"Publicación","icon":"badge-check","root":{"title":"Publicación","icon":"badge-check","href":"/automatizaciones/publicacion"},"pages":[{"title":"Publicar automatización","openapi":"openapi/automatizaciones-v1.yaml POST /workflows/{workflowId}/publish","href":"/automatizaciones/publicar-automatizacion"},{"title":"Activar automatización","openapi":"openapi/automatizaciones-v1.yaml POST /workflows/{workflowId}/activate","href":"/automatizaciones/activar-automatizacion"},{"title":"Desactivar automatización","openapi":"openapi/automatizaciones-v1.yaml POST /workflows/{workflowId}/deactivate","href":"/automatizaciones/desactivar-automatizacion"}]},{"group":"Versiones","icon":"git-branch","root":{"title":"Versiones","icon":"git-branch","href":"/automatizaciones/versiones"},"pages":[{"title":"Listar versiones","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/versions","href":"/automatizaciones/listar-versiones"},{"title":"Consultar versión","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/versions/{versionId}","href":"/automatizaciones/consultar-version"}]},{"group":"Disparos","icon":"zap","root":{"title":"Disparos","icon":"zap","href":"/automatizaciones/disparos"},"pages":[{"title":"Disparar webhook","openapi":"openapi/automatizaciones-v1.yaml POST /webhooks/{workflowId}/{secret}","href":"/automatizaciones/disparar-webhook"},{"title":"Ejecutar ahora (cron)","openapi":"openapi/automatizaciones-v1.yaml POST /workflows/{workflowId}/trigger-now","href":"/automatizaciones/ejecutar-ahora"},{"title":"Trigger de correo Gmail","icon":"https://mintlify.s3.us-west-1.amazonaws.com/insurance-boosters/assets/gmail.png","href":"/automatizaciones/trigger-gmail"},{"title":"Trigger de respuesta rápida de WhatsApp","icon":"message-circle-reply","href":"/automatizaciones/trigger-whatsapp-quick-reply"}]},{"group":"Triggers","icon":"radio-tower","root":{"title":"Triggers","icon":"radio-tower","href":"/automatizaciones/triggers"},"pages":[{"title":"Webhook","icon":"webhook","href":"/automatizaciones/triggers/webhook"},{"title":"Programación","icon":"clock","href":"/automatizaciones/triggers/programacion"},{"title":"Registro creado","icon":"database","href":"/automatizaciones/triggers/registro-creado"},{"title":"Registro actualizado","icon":"database-zap","href":"/automatizaciones/triggers/registro-actualizado"},{"title":"Contacto creado","icon":"contact-round","href":"/automatizaciones/triggers/contacto-creado"},{"title":"Contacto actualizado","icon":"contact-round-cog","href":"/automatizaciones/triggers/contacto-actualizado"},{"title":"Data Endpoint de WhatsApp Flow","icon":"message-circle-code","href":"/automatizaciones/triggers/data-endpoint-whatsapp-flow"},{"title":"Respuesta de WhatsApp Flow","icon":"message-circle","href":"/automatizaciones/triggers/respuesta-whatsapp-flow"},{"title":"Reintentos e idempotencia","icon":"refresh-cw","href":"/automatizaciones/triggers/reintentos-idempotencia"}]},{"group":"Ejecuciones","icon":"history","root":{"title":"Ejecuciones","icon":"history","href":"/automatizaciones/ejecuciones"},"pages":[{"title":"Listar ejecuciones","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/runs","href":"/automatizaciones/listar-ejecuciones"},{"title":"Consultar ejecución","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/runs/{runId}","href":"/automatizaciones/consultar-ejecucion"},{"title":"Listar pasos de una ejecución","sidebarTitle":"Pasos de la ejecución","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/runs/{runId}/steps","href":"/automatizaciones/listar-pasos-ejecucion"},{"title":"Diagnosticar un paso de navegador","sidebarTitle":"Diagnóstico de navegador","openapi":"openapi/automatizaciones-v1.yaml GET /workflows/{workflowId}/runs/{runId}/steps/{stepId}/diagnostics","icon":"stethoscope","href":"/automatizaciones/diagnosticar-paso-navegador"}]},{"group":"Pasos","icon":"blocks","root":{"title":"Tipos de paso","icon":"blocks","href":"/automatizaciones/tipos-de-paso"},"pages":[{"title":"Variables y contexto","icon":"braces","href":"/automatizaciones/variables-y-contexto"},{"title":"Archivos entre pasos","icon":"files","href":"/automatizaciones/archivos-entre-pasos"},{"title":"Enviar correo con Gmail","icon":"https://mintlify.s3.us-west-1.amazonaws.com/insurance-boosters/assets/gmail.png","href":"/automatizaciones/paso-gmail"},{"title":"Llamadas con mensaje","icon":"phone-call","href":"/automatizaciones/paso-llamadas-con-mensaje"},{"title":"Paso Agente IA: investigar la web","icon":"globe","href":"/automatizaciones/paso-navegador"},{"title":"Paso Agente IA: completar tarea web","icon":"mouse-pointer-click","href":"/automatizaciones/paso-tarea-navegador"},{"title":"Paso Agente IA: automatizar portal","icon":"bot","href":"/automatizaciones/paso-agente-guion"},{"title":"Paso Criterio IA","icon":"https://mintlify.s3.us-west-1.amazonaws.com/insurance-boosters/assets/typesafe-mark.svg","href":"/automatizaciones/paso-decision"},{"title":"Paso JavaScript","icon":"code","href":"/automatizaciones/paso-javascript"},{"title":"Paso HTTP","icon":"globe","href":"/automatizaciones/paso-http"},{"title":"Paso Esperar","icon":"clock","href":"/automatizaciones/paso-esperar"}]}]},{"group":"Tableros","icon":"table-2","root":{"title":"Tableros","icon":"table-2","href":"/tableros/introduccion"},"directory":"accordion","pages":[{"group":"Administración","icon":"layout-dashboard","root":{"title":"Gestión de tableros","icon":"layout-dashboard","href":"/tableros/gestion"},"pages":[{"title":"Listar tableros","openapi":"openapi/tableros-v1.yaml GET /databases","href":"/tableros/listar-tableros"},{"title":"Crear tablero","openapi":"openapi/tableros-v1.yaml POST /databases","href":"/tableros/crear-tablero"},{"title":"Consultar tablero","openapi":"openapi/tableros-v1.yaml GET /databases/{databaseId}","href":"/tableros/consultar-tablero"},{"title":"Actualizar tablero","openapi":"openapi/tableros-v1.yaml PATCH /databases/{databaseId}","href":"/tableros/actualizar-tablero"}]},{"group":"Campos","icon":"columns-3","root":{"title":"Campos","icon":"columns-3","href":"/tableros/campos"},"pages":[{"title":"Crear campo","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/fields","href":"/tableros/crear-campo"},{"title":"Tipos y configuración de campos","icon":"list-tree","href":"/tableros/tipos-de-campo"},{"title":"Actualizar campo","openapi":"openapi/tableros-v1.yaml PATCH /databases/{databaseId}/fields/{fieldId}","href":"/tableros/actualizar-campo"},{"title":"Reordenar campos","openapi":"openapi/tableros-v1.yaml PUT /databases/{databaseId}/fields/reorder","href":"/tableros/reordenar-campos"},{"title":"Vincular relación bidireccional","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/fields/{fieldId}/link","sidebarTitle":"Vincular relación","href":"/tableros/vincular-relacion"},{"title":"Desvincular relación bidireccional","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/fields/{fieldId}/unlink","sidebarTitle":"Desvincular relación","href":"/tableros/desvincular-relacion"},{"title":"Eliminar campo","openapi":"openapi/tableros-v1.yaml DELETE /databases/{databaseId}/fields/{fieldId}","href":"/tableros/eliminar-campo"}]},{"group":"Registros","icon":"rows-3","root":{"title":"Registros","icon":"rows-3","href":"/tableros/registros"},"pages":[{"title":"Valores por tipo de campo","icon":"braces","href":"/tableros/valores-por-tipo"},{"title":"Listar registros","openapi":"openapi/tableros-v1.yaml GET /databases/{databaseId}/records","href":"/tableros/listar-registros"},{"title":"Buscar registros","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/records/search","href":"/tableros/buscar-registros"},{"title":"Crear registro","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/records","href":"/tableros/crear-registro"},{"title":"Crear registros en lote","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/records/bulk","sidebarTitle":"Crear en lote","href":"/tableros/crear-registros-lote"},{"title":"Consultar registro","openapi":"openapi/tableros-v1.yaml GET /databases/{databaseId}/records/{recordId}","href":"/tableros/consultar-registro"},{"title":"Actualizar registro","openapi":"openapi/tableros-v1.yaml PATCH /databases/{databaseId}/records/{recordId}","href":"/tableros/actualizar-registro"},{"title":"Actualizar relaciones de un registro","openapi":"openapi/tableros-v1.yaml PATCH /databases/{databaseId}/records/{recordId}/relation-links","sidebarTitle":"Actualizar relaciones","href":"/tableros/actualizar-relaciones-registro"},{"title":"Consultar historial de un registro","openapi":"openapi/tableros-v1.yaml GET /databases/{databaseId}/records/{recordId}/history","sidebarTitle":"Consultar historial","href":"/tableros/historial-registro"},{"title":"Eliminar registro","openapi":"openapi/tableros-v1.yaml DELETE /databases/{databaseId}/records/{recordId}","href":"/tableros/eliminar-registro"}]},{"group":"Archivos","icon":"paperclip","root":{"title":"Archivos","icon":"paperclip","href":"/tableros/archivos"},"pages":[{"title":"Subir archivo","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/records/{recordId}/fields/{fieldKey}/files","href":"/tableros/subir-archivo"},{"title":"Desadjuntar archivo","openapi":"openapi/tableros-v1.yaml DELETE /databases/{databaseId}/records/{recordId}/fields/{fieldKey}/files/{fileId}","href":"/tableros/desadjuntar-archivo"}]},{"group":"PDF","icon":"file-text","root":{"title":"Generar PDF","icon":"file-text","href":"/tableros/generar-pdf"},"pages":[{"title":"Listar plantillas PDF","openapi":"openapi/tableros-v1.yaml GET /databases/{databaseId}/pdf-templates","href":"/tableros/listar-plantillas-pdf"},{"title":"Generar PDF de un registro","openapi":"openapi/tableros-v1.yaml POST /databases/{databaseId}/records/{recordId}/pdf-template","href":"/tableros/generar-pdf-registro"}]}]}]}]},"basePath":"","title":"Usar artifacts con OpenAI Agents - Insurance Boosters API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}