Ajustes
Ajustes de desarrollador
Claves personales, clientes de aplicación y conexión de un agente o de la CLI: los mandos de la página Sofia API y cuál elegir.
Esta sección es la entrada a todo lo programático. La documentación de referencia está en las pestañas API, Agents y Añade Sofia a tu app; esta página describe los mandos de la interfaz. Abre los ajustes, sección «Sofia API».
Acceso
La página tiene dos pestañas: «Acceso personal» y «Clientes de aplicación».
Tu clave personal
- Crea la clave. «Nueva clave»: ponle un nombre si quieres, una caducidad (7 días, 30 días, 90 días, 1 año o sin caducidad) y sus permisos. Todos están marcados por defecto; conserva solo lo que necesita tu herramienta.
- Cópiala enseguida. Solo se muestra una vez, y Sofia solo guarda su huella.
- Úsala. Envíala en la cabecera
Authorization: Bearerde cada llamada. Una clave actúa sobre todos tus establecimientos, con tus derechos.
Conectar un asistente de IA
Para Claude, ChatGPT, Cursor, Gemini CLI o Claude Code, el conector de las aplicaciones conectadas suele ser más sencillo: no pide ninguna clave. Consulta El conector de IA.
CLI y agentes
«Copiar instrucciones para el agente» da el texto que hay que pegar en tu agente para que use la API. El comando sofia, publicado en npm con el nombre sofia-post, envuelve la API para publicar desde un terminal, un script o una tarea programada; su instalación está en la pestaña «Agents».
Clientes de aplicación
Un cliente de aplicación sirve para construir algo que autorizarán otros usuarios de Sofia, en lugar de algo que actúa como tú.
- Crea el cliente. «Nuevo cliente»: un nombre, un logotipo de al menos 180 × 180 píxeles, la dirección de tu política de privacidad, de una a cinco URL de redirección en HTTPS, y los permisos que la app puede pedir. El nombre y el logotipo se muestran a las personas durante la autorización.
- Copia los identificadores. Obtienes un Client ID y un Client Secret. Un cliente público, para una app cuyo código es público, no tiene secreto y se autentica con PKCE; esta elección es definitiva.
- Implementa el flujo. Consulta la pestaña «Añade Sofia a tu app».
¿Clave u OAuth con un cliente?
| Criterio | Clave personal | Cliente de aplicación |
|---|---|---|
| Actúa como | Tú | La persona que lo autoriza |
| Conviene para | Tus propios scripts y automatizaciones | Un producto que usarán otros usuarios de Sofia |
| Puesta en marcha | Copiar la clave | Declarar un cliente e implementar el flujo |
| Para revocar | «Revocar» la clave | La persona retira el acceso en «Aplicaciones conectadas», o tú eliminas el cliente |
Si automatizas tu propia publicación, usa la clave. Construye un cliente solo cuando estén en juego las cuentas de otras personas.
Para ir más lejos
- API: puntos de acceso, cargas útiles y ajustes por red, en la pestaña API.
- CLI: publicar desde un terminal, en la pestaña Agents.
- Conector de IA: conectar Claude, Cursor o ChatGPT; consulta El conector de IA.