Saltar al contenido principal
Documentación
Documentación
Administrator Guide
Última actualización: 2026-03-13
Registro de agentes externos

Registro de agentes externos

Requisitos previos

Es posible que deba realizar pasos adicionales para activar esta función en función del acuerdo de servicio de suscripción de su organización. Su organización está en el acuerdo de servicios principal (MSA) o en el acuerdo de servicios principal universal (UMSA). Para determinar el acuerdo de servicio de suscripción de su organización:
  1. Seleccione su avatar de perfil en Workday Community .
  2. Seleccione
    Perfil
     .
  3. En su página de perfil, seleccione el nombre de su organización, que se encuentra debajo de su nombre y junto al título de puesto.
  4. Consulte el valor de su
    acuerdo de servicios de suscripción
     .
Si el valor es:
Los créditos flexibles solo son obligatorio para activando registro y utilizar agentes en sus entornos de cliente de producción. No podrá registrar ni utilizar ningún agente en producción hasta que haya aceptado estos acuerdos. UMSA es obligatorio para los entornos de cliente de producción y no de producción de los agentes creados por Workday. UMSA no es obligatorio para los entornos de cliente que no sean de producción para los agentes creados por el usuario.
Definición de sistema de registro de agente .
Seguridad:
  • dominio
    Centro de operaciones de gestión de agentes
     en el área funcional Agent System of Record . Obligatorio para validar que el agente está registrado en Workday.
  • dominio
    Manage Agents
     en el área funcional Agent System of Record. Obligatorio para la activación y configuración de habilidad .
  • Dominio
    Set Up: Tenant Setup - Security
     en el área funcional System. Obligatorio para el registro.

Contexto

Actualmente, solo puede registrar y definir agentes externos en Workday mediante la interfaz de programación de aplicaciones (API) de ASOR. Los agentes externos se definen y registran simultáneamente mediante la interfaz de programación de aplicaciones (API), no son dos pasos independientes. Puede utilizar cualquier cliente de interfaz de programación de aplicaciones (API) que prefiera para invocar la interfaz de programación de aplicaciones (API).
Puntos finales de registro:
  • REST API Endpoint:
     https://us.agent.workday.com/asor/v1/agentDefinition.
  • Token Endpoint:
     https://us.agent.workday.com/auth/oauth2/<Tenant_Name>/token
  • Autorice el punto final:
     https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
Para obtener información relacionada con otra disponibilidad regional fuera de EE. UU., consulte la documentación de Agent Gateway:Referencia: disponibilidad regional de Gateway de agente .

Opciones de autenticación:

Para registrar agentes externos, necesita una credencial de acceso en su invocación de interfaz de programación de aplicaciones (API) de ASOR. A continuación se muestran las distintas opciones para obtener una credencial para invocar la llamada interfaz de programación de aplicaciones (API) de ASOR.
Opción 1: autenticación manual de un cliente de interfaz de programación de aplicaciones (API)
  1. Acceda a la tarea
    Registro de cliente de interfaz de programación de aplicaciones (API)
     .
    • Nombre de cliente:
       introduzca un nombre identificable exclusivo para su agente. Le recomendamos que utilice un cliente independiente para cada agente, de modo que sea más fácil gestionarlos.
    • Tipo de concesión de cliente:
      concesión de código de autorización
       .
    • Tipo de credencial de acceso:
      portador
       .
    • URI de redirección:
       introduzca una URL a la que redirigir a los usuarios después de la autorización.
    • Ámbito (áreas funcionales):
      Agent System of Record
       .
    • Incluir ámbito propiedad de Workday :
       seleccione esta casilla (de selección).
  2. Copie y guarde los valores
    de ID de cliente
     y
    Clave secreta de cliente
     . Puede utilizarlos para obtener una credencial de acceso para llamar a la interfaz de programación de aplicaciones (API) de definición .
  3. Pegue esta URL en una nueva ventana. Debería redirigirle a google.com con un código adjunto que puede usar para llamar a la interfaz de programación de aplicaciones (API):
    https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
  4. Cree una nueva solicitud mediante un cliente de interfaz de programación de aplicaciones (API) externo (por ejemplo, Bruno):
    https://<tenantHost>/ccx/oauth2/<tenantName>/ credencial
    • Cuerpo:
      grant_type=authorization_code&code=<authorizationCode>&client_id=<clientID>&client_secret=<ClientSecret>
    • Auth: Username =
      <ClientID>
      , Password =
      <ClientSecret>
      .
    • Esto genera una credencial de acceso y una credencial de actualizar que puede utilizar para llamar a la interfaz de programación de aplicaciones (API) de definición de agente de ASOR.
    • Mientras realiza este paso, tenga en cuenta lo siguiente:Concepto: consideraciones sobre la ASU de agente externo .
El usuario que activando registro al agente debe tener acceso al dominio Setup: Agents en el área funcional Agent System of Record para registrar un agente mediante la interfaz de programación de aplicaciones (API) de ASOR.
Opción 2: autenticación mediante extensión
Si es usuario de Workday Extend o Workday Orchestrate, puede recuperar una credencial de acceso a través del sitio para desarrolladores de Workday.
  1. Acceda a desarrollador.workday.com y conectar con.
  2. En la parte superior derecha, haga clic en el menú de usuario. El menú debería mostrar el nombre de su empresa actual.
  3. Haga clic en
    Entorno de cliente
    Conectar con entorno de cliente
    .
  4. Seleccione su entorno y su entorno de cliente y haga clic en
    Conectar con entorno de cliente
     .
  5. Conéctese al entorno de cliente. Debe conectar con una cuenta que tenga acceso al dominio
    Setup: Agents
     en el área funcional Agent System of Record para registrar un agente mediante la interfaz de programación de aplicaciones (API) de ASOR.

Registro de un agente externo mediante la interfaz de programación de aplicaciones (API) de ASOR

Requisitos previos:
  • Una credencial de acceso para una cuenta que tiene acceso al dominio
    Setup: Agents
     en el área funcional Agent System of Record .
  • Un cliente de interfaz de programación de aplicaciones (API) de su elección.
  • Seguridad: los siguientes dominios del área funcional System:
    • Custom Report Creation
    • Manage: All Custom Reports
    • Report Tag Management
Contexto:
Para registrar un agente externo, debe hacer lo siguiente:
  • Busque los identificadores de Workday (WID) de las API de Workday pertinentes (SOAP y REST) que desea incluir en la definición de herramientas de su agente creando un informe personalizado.
  • Busque el proveedor de agentes mediante la tarea
    Consulta de proveedor de agentes
     .
  • Llamar a la API de REST de ASOR
Búsqueda de ID de Workday basado en SOAP y REST para definición de herramientas de agente
  1. Acceda a la tarea
    Creación de informe personalizado
    .
  2. Mientras crea el informe, tenga en cuenta lo siguiente:
    Opción
    Descripción
    Tipo de informe
    Seleccione
    Avanzado
    .
    Optimizado para rendimiento
    Anule la selección de esta casilla (de selección).
    Origen de datos
    Seleccione
    Public Web Services
     for SOAP APIs y
    All Public Service Operations
     for REST APIs.
  3. Para las API de SOAP: en la página
    Edición de informe personalizado
     , en la ficha
    Columnas
     de la definición de informe, añada las siguientes filas:
    Objeto de gestión
    Campo
    Servicio web
    Servicio web
    Operación de servicio web
    Nombre de operación de servicio web
    Operación de servicio web
    ID de Workday
  4. Para las API de REST: en la página
    Edición de informe personalizado
     , en la ficha
    Columnas
     de la definición de informe, añada las siguientes filas:
    Objeto de gestión
    Campo
    Operación de servicio
    Servicio
    Operación de servicio
    Nombre
    Operación de servicio
    ID de Workday
  5. Guarde y ejecute el informe.
Mientras recupera IDs de Workday para sus API, también puede hacer referencia cruzada a las siguientes listas:
Búsqueda de proveedor de agente
Los proveedores de agentes hacen referencia a quién ha creado el agente y se muestran en el campo
Creado por
 en el perfil del agente.
  1. Acceda a la tarea
    View Agent Provider
     , con protegido en el dominio
    Setup: Agents
     en el área funcional Agent System of Record.
  2. Utilice el ID de proveedor en la llamada a la interfaz de programación de aplicaciones (API) de registro de agente.
Búsqueda de plataforma de agente
Las plataformas de agente hacen referencia a la plataforma o sistema externo en el que se desarrolla y ejecuta el agente, y se muestran en el campo
Basado en
 en el perfil del agente.
  1. Acceda a la tarea
    View Agent Platforms
     , con protegido en el dominio Setup Agents en el área funcional Agent System of Record.
  2. Utilice el ID de plataforma en la llamada a la interfaz de programación de aplicaciones (API) de registro de agente.
Llamar a la API de REST de ASOR
Cree una nueva solicitud para registrar a su agente mediante un cliente de interfaz de programación de aplicaciones (API) externo. Ejemplo: Bruno.
Mientras crea la solicitud, tenga en cuenta lo siguiente:

Centro de operaciones de gestión de agentes

Una vez que haya cargado correctamente su definición de agente en Workday, puede comprobar que está registrada al consultarla en el
Centro de operaciones de gestión de agentes
 .
  1. Acceda al informe
    Centro de operaciones de gestión de agentes
     .
  2. Haga clic en
    Registro de agentes
     para mostrar una lista de sus agentes.
  3. Haga clic en un agente para mostrar información general sobre él.

Siguientes pasos

Configure su agente en Workday.