Skip to main content
POST
Cargar archivos para una ejecución
Los artifacts permiten que un agente analice documentos e imágenes sin enviar URLs de almacenamiento ni contenido en base64.
Solo puedes usar artifacts cuando el agente tiene runtime: "openai-agents" y mode: "chat-conversation".

Antes de empezar

Necesitas:
  • Una API key.
  • El agentId, disponible en la URL del agente dentro de la plataforma.
  • Un agente configurado con el runtime OpenAI Agents (runtime: "openai-agents").

Flujo de uso

1

Carga los archivos

Envía uno o más archivos como multipart/form-data. Usa files como nombre de campo para cada archivo:
2

Guarda los identificadores

La respuesta contiene una referencia opaca por archivo:
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:

Formatos admitidos

El tipo MIME del archivo debe coincidir con uno de los formatos admitidos.

Límites y vigencia

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

Authorizations

x-ib-api-key
string
header
required

Path Parameters

agentId
string
required

Identificador del agente. Solicítalo con tu ejecutivo de cuenta.

Body

multipart/form-data
files
file[]
required
Maximum array length: 10

Response

Archivos cargados.

artifacts
object[]
required