Una API key para un solo asistente: qué ve y qué no

Le pasás una key a un freelance para que toque un solo asistente. ¿Qué más ve?

1. Una key, un asistente

En CognitionDesk una API key se puede atar a uno o varios asistentes. Desde ese momento, para esa key los demás asistentes de la cuenta no existen: no los lee, no los lista y no llega a ellos por un camino lateral, como un canal o un widget.

Eso vale para cada camino por el que alguien podría asomarse al resto de la cuenta:

Lo que pide	Key atada al asistente A
El asistente A	Lo ve y lo opera, según los permisos de la key
Otro asistente, pedido por su id	No lo ve
La lista de asistentes	Trae sólo A
La lista de canales	Trae sólo los canales de A; uno sin asignar tampoco aparece
El widget web de otro asistente	Responde igual que uno de otra cuenta: no existe, y su clave de embed tampoco
Crear una key hija	Como mucho, con A; no puede crear una sin restricción ni con otro asistente
Un asistente que la key crea	Queda dentro de su alcance: lo ve, lo lista y lo puede borrar

2. Lo que una key por asistente no recorta

Hay recursos que son de la cuenta y no de un asistente: la base de conocimiento, el inventario, los cobros, la agenda, los workflows, las tools y las skills. Atar la key a un asistente no los recorta. Esos se acotan con los permisos de la key (sus scopes).

En la práctica: a la key que le das a un tercero, dale el asistente y sólo los permisos que necesita. Si no tiene que tocar la agenda, que la key no tenga el permiso de agenda.

3. Comprobalo con tres pedidos

Un permiso que sólo se prueba pidiendo el recurso permitido no está probado. Con la key en la mano, hacé tres pedidos:

1. Por id: pedí el asistente A. Tiene que contestar.
2. Por lista: pedí la lista de asistentes y la de canales. Tiene que aparecer A y nada más.
3. Por un id vecino: pedí otro asistente de la misma cuenta, o su widget. Tiene que contestar como si no existiera.

curl -s https://api.cognitiondesk.com/platform-api/assistants \
  -H "x-api-key: TU_KEY_RESTRINGIDA"
# tiene que traer un solo asistente

4. Dónde se emite

Una key atada a uno o varios asistentes se crea desde el panel, en la conexión de la key, eligiendo los asistentes permitidos; o desde el MCP de CognitionDesk, pasando la lista de asistentes al crearla o editarla. Una lista vacía quiere decir «todos», así que para un tercero, siempre con lista.

¿Necesitás otro recorte, por ejemplo por base de conocimiento o por canal? Escribinos.