Canal API

El canal API expone el agente como un endpoint compatible con la API de OpenAI. Sirve para integrarlo en una app, un CRM, un backend o una automatización: cualquier SDK de OpenAI funciona cambiando la dirección base.

Dos formas de obtener una API key

	Canal API (esta página)	API key del workspace
Dónde se crea	Estudio del agente → Canales → «Conectar canal» → «API»	Configuración → API keys
Alcance	Un solo agente	Todos los agentes del workspace, o uno
Aparece como canal	Sí, con sus conversaciones en la vista Canales	No
Límite por minuto	600	Configurable (60 por defecto)
Ideal para	Integrar un agente puntual	Un sistema que conversa con varios agentes

Las dos funcionan igual y se usan con la API REST.

Crear el canal

En el Estudio del agente, vista Canales, hacé clic en «Conectar canal» → «API».
Elegí Nombre y Ambiente: «Producción» (versión publicada) o «Borrador (prueba)» (para integrar mientras desarrollás).
Hacé clic en «Crear canal».

La tarjeta muestra la API key con el aviso «se muestra una sola vez». Copiala y guardala en un gestor de secretos.

Probarla

La tarjeta trae un ejemplo listo:

curl https://app.sherlock.posselab.net/v1/chat/completions \
  -H "Authorization: Bearer sk-sherlock-..." \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"¿Qué cubre la póliza contra todo riesgo?"}],"stream":false}'

Como la key es de un solo agente, el campo model se puede omitir. La respuesta trae el texto del agente y, en el campo sherlock, el conversation_id para seguir la conversación y las citas. Todos los detalles (streaming, conversaciones, errores) están en API REST.

Las conversaciones que llegan por este canal aparecen en Conversaciones con el canal «API», con su traza y su costo, y pasan por los mismos guardrails.