Skills
Lo que tu IA puede hacer, empaquetado.
La API pública tiene siete métodos para habilidades. La API sigue llamando a una habilidad un agente de IA, así que ese es el nombre en cada método. Actúan sobre habilidades que ya existen: fijan una, marcan una como favorita, archivan una, le crean una imagen y registran un consentimiento. Cada uno actúa por la cuenta cuya clave de API uses.
Crear una habilidad, planificarla a partir de tus palabras, cambiar sus instrucciones o herramientas, clonar, instalar desde el marketplace, publicar, compartir, desarchivar, eliminar 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:
Una buena respuesta tiene code 1. Una rechazada tiene un code negativo y dice por qué en data.
Todos los métodos toman el id de la habilidad como agent_id, que es la última parte de la dirección de la habilidad en el dashboard. Salvo set_agent_tool_consent, cada uno toma también un workspace_id opcional, para actuar en un espacio de trabajo distinto de tu espacio de origen. Debes ser propietario de ese espacio de trabajo.
Fija y marca como favorita
pin_ai_agentyunpin_ai_agentfijan una habilidad y quitan la fijación. Se avisa al dashboard al instante, así que una página abierta muestra el cambio.favorite_ai_agentyunfavorite_ai_agentponen y quitan la marca de favorito, el corazón en la tarjeta de la habilidad. Un favorito es también lo que enumera la opción Favoritos del menú Mostrar.
Archiva
archive_ai_agent mueve una habilidad fuera de la lista activa y la lleva a Archivado. Una habilidad archivada deja de contar para el número que admite el plan del espacio de trabajo, lo que la convierte en una forma de hacer sitio bajo un límite.
- Solo la persona que creó la habilidad puede archivarla. Para cualquier otra, la respuesta es un rechazo que dice que la operación no está permitida.
- Una habilidad que has compartido con otros se rechaza mientras ese uso compartido esté activo. Termina primero el uso compartido.
conversation_ides opcional. Con él, solo se archiva esa conversación de la habilidad. Sin él, se archivan con ella todas las conversaciones de la habilidad.
Recuperar una habilidad, o eliminarla definitivamente, se hace en el dashboard, desde la vista Archivado.
Crea una imagen
generate_ai_agent_image crea una imagen nueva para una habilidad tuya y la guarda en la habilidad. Úsalo cuando una habilidad no tiene imagen y su tarjeta recurre al marcador de posición. Se ejecuta en segundo plano, así que la imagen nueva aparece la próxima vez que se carga la habilidad. Es lo mismo que Generar imagen en el menú de la tarjeta.
Permite que una habilidad instalada use las herramientas de su editor
set_agent_tool_consent registra si permites que una habilidad instalada use herramientas de plugins que se ejecutan en el espacio de trabajo de su editor. Todo lo que crean esas herramientas se guarda en el drive del editor y no en el tuyo. Toma agent_id y granted, true para permitir y false para retirar, y opcionalmente owner_uid, la cuenta del editor. Solo registra siempre tu propia decisión, nunca la de otra persona.
Las habilidades se cuentan según el plan del espacio de trabajo en el que están. Consulta Planes y facturación para ver qué cuenta y qué pasa en el límite.