Definiciones de modelos personalizados
- Última actualización2024/12/23
Definiciones de modelos personalizados
Las definiciones de modelos personalizados le permiten integrar y aprovechar modelos externos IA generativa alojados en diversas plataformas en varios entornos, incluidas las infraestructuras Local, nubes privadas y plataformas de nube pública.
Las API de modelos personalizados le permiten conectarse a cualquier modelo compatible con API REST, lo cual le da la capacidad de acceder a una gama más amplia de soluciones de IA.
La necesidad de modelos personalizados
La rápida evolución de las tecnologías de IA generativa ha resultado en una amplia gama de modelos fundamentales disponibles, cada uno con sus propias fortalezas y especializaciones. Aunque Automation Anywhere ofrece una selección de modelos previamente integrados dentro de AI Agent Studio, la necesidad de utilizar otros modelos podría deberse a lo siguiente:
- Modelos especializados
-
Ha desarrollado o adquirido modelos entrenados en conjuntos de datos específicos o ajustados para tareas únicas relevantes a las necesidades de su empresa.
- Seguridad y residencia de datos
-
Es posible que las organizaciones con estrictas políticas de seguridad de datos o requisitos regulatorios necesiten usar modelos alojados dentro de sus propios entornos seguros, como infraestructura local o nubes privadas.
- Cómo aprovechar las inversiones existentes
-
Las organizaciones que ya han invertido en desarrollar e implementar modelos de IA en plataformas pueden beneficiarse de la capacidad de integrar estos modelos directamente en sus flujos de trabajo de Automation Anywhere.
API de modelos personalizados
Para abordar estas necesidades, Automation Anywhere ha desarrollado API de modelos personalizados para definir y conectar modelos personalizados de IA generativa. Esta API funciona al introducir información sobre el modelo, que incluye su proveedor, nombre, mecanismo de autenticación, parámetros de entrada y asignación de resultado, en la base de datos de una instancia de Control Room.
-
POST https:/{{ControlRoomURL}}/gai/prompttools/v1/custommodel
- Esta API crea una nueva definición de modelo personalizado.
- Requiere un esquema de carga útil JSON, que encapsula información sobre el modelo. El esquema define atributos como el nombre del proveedor, el nombre del modelo específico, protocolos de autenticación, detalles del punto final de API (incluidos los parámetros de ruta, los parámetros de consulta y encabezados obligatorios) y la estructura de la solicitud y los cuerpos de respuesta.
- La API permite a los usuarios definir variables dentro de la solicitud y
los cuerpos de respuesta que se pueden completar dinámicamente durante el tiempo de ejecución.
Estas variables se pueden designar para diferentes propósitos a través de
anotaciones específicas:
-
PROMPT_QUERY
: Esta anotación indica que la variable correspondiente debe reemplazarse con la indicación facilitada por el usuario en la página Habilidades de IA. Esto es esencial para pasar los indicadores de entrada del usuario al modelo. -
REQUEST_PARAMETER
: Esta anotación indica que la variable debe ser expuesta como un parámetro configurable en la página Conexiones del modelo. -
MODEL_PARAMETER
: Es similar aREQUEST_PARAMETER
, esta anotación designa la variable para la configuración en la página Habilidades de IA. -
RESPONSE_PARAMETER
: Esta Esta anotación significa que la variable será devuelta en la respuesta del modelo de IA.
-
- La API devuelve una respuesta
200 OK
con el modelo creado tras la creación exitosa.
-
GET https:/{{ControlRoomURL}}/gai/prompttools/v1/custommodel/vendors/{vendorName}/models/{modelName}
- Esta API recupera la definición de modelos personalizados existentes.
- Requiere el nombre del proveedor (
vendorName
) y el nombre del modelo (modelName
) como parámetros de ruta. - La API devuelve una respuesta
200 OK
que contiene los objetos que representan el modelo solicitado.
-
DELETE https:/{{ControlRoomURL}}/gai/prompttools/v1/custommodel/vendors/{vendorName}/models/{modelName}
- Esta API elimina un modelo personalizado existente.
- Similar a la API GET, utiliza (
vendorName
) y (modelName
) como parámetros de ruta para identificar el modelo de destino.Nota: El modelo solo puede eliminarse si no está actualmente asociado con Conexiones del modelo activas. Esto significa que primero debe quitar todos los Habilidades de IA y Bots de tarea que dependen del Conexión del modelo antes de intentar eliminar la definición del modelo. - La API devuelve una respuesta
204 No Content
tras la eliminación exitosa.
-
POST https:/{{ControlRoomURL}}/gai/prompttools/v1/custommodel/list
- Esta API recupera una lista de todos los modelos personalizados definidos para todos los proveedores dentro de Control Room.
- Acepta un cuerpo de solicitud opcional que contiene un
FilterRequest
, lo que le permite a los usuarios filtrar los resultados basados en criterios específicos. - La API devuelve una respuesta
200 OK
con objetos que contienen los modelos solicitados.
Para obtener más detalles sobre estas API, consulte API de AI Agent Studio. Puede descargar aquí una colección de Postman para AI Agent Studio: definiciones de modelos personalizados que contienen ejemplos de llamadas a la API para conectarse a los modelos personalizados.