Saltar al contenido

Asistentes de IA

Asistentes que responden por ti, en privado o en público.

Abrir Asistentes de IA
Comprobado con el panel el 20 de noviembre de 2026

Asistentes de IA tiene seis métodos públicos. Actúan sobre un asistente que ya existe: la marca de favorito, la fijación, el archivado y su imagen. Cada uno actúa por la cuenta cuya clave de API uses.

Crear un asistente, cambiar su configuración, sus preajustes y sus invitaciones, enviar una invitación, leer sus sesiones y elegir un plan se hacen en el dashboard. Hoy no tienen método público.

Envía una solicitud a un método con tu clave:

curl -s https://xuda.ai/cpi/favorite_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_ASSISTANT_ID"}'
const res = await fetch('https://xuda.ai/cpi/favorite_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    agent_id: 'YOUR_ASSISTANT_ID',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/favorite_ai_agent',
    json={
        'api_key': 'YOUR_API_KEY',
        'agent_id': 'YOUR_ASSISTANT_ID',
    },
)

Una buena respuesta tiene code 1. Una rechazada tiene un code negativo y dice por qué en data. Consulta Llamar a un método para ver las formas de solicitud.

Las listas de Asistentes y de Habilidades comparten estos métodos, por eso el campo se llama agent_id: es el id del asistente. Todos los métodos toman también un workspace_id opcional, para actuar en un espacio de trabajo distinto del tuyo. Quien llama debe ser su propietario.

Marca un asistente

  • favorite_ai_agent toma agent_id y marca el asistente como favorito. Es el corazón de su tarjeta, y la opción Favoritos del menú Mostrar de la página lo enumera.
  • unfavorite_ai_agent toma el mismo campo y quita la marca.
  • pin_ai_agent toma agent_id y marca el asistente como fijado.
  • unpin_ai_agent toma el mismo campo y quita la fijación.

Archiva un asistente

archive_ai_agent toma agent_id y archiva el asistente. Sale de la lista Activo y aparece en Archivado, y sus conversaciones se archivan con él. Un conversation_id opcional limita las conversaciones que se archivan a esa.

Solo el creador del asistente puede archivarlo. Un asistente que se compartió contigo se rechaza con Operation not allowed. Un asistente que has compartido con otros se rechaza con active share found hasta que termine el uso compartido.

Restaurar un asistente archivado y eliminarlo definitivamente son acciones del dashboard: Desarchivar y Eliminar en el menú de la tarjeta, en el estado Archivado.

Dibuja una imagen

generate_ai_agent_image toma agent_id y dibuja una imagen nueva para un asistente tuyo, con el generador que se ejecuta cuando se crea uno. Úsalo cuando una tarjeta muestra el marcador de posición. Se ejecuta en segundo plano como un trabajo, y la imagen nueva aparece en la siguiente carga.

Las opciones de la imagen, como país, género, sector y tus propias palabras, el uso de tu propio retrato y una imagen subida, se definen en la ventana de configuración del dashboard.

Qué cambia cada plan

Ninguno de estos métodos lo restringe un plan. Lo que cambia un plan es lo que el asistente puede hacer por los visitantes, y eso no es accesible desde un método. Consulta Planes y facturación.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026