Passa al contenuto principale
Documentazione
Documentazione
Administrator Guide
Ultimo aggiornamento: 2026-03-13
Registrare gli agenti esterni

Registrare gli agenti esterni

Prerequisiti

Potrebbe essere necessario eseguire ulteriori passaggi per abilitare questa funzionalità in base al contratto servizio in abbonamento dell'organizzazione. L' organizzazione ha aderito al contratto di servizio principale (MSA) o al contratto UMSA (Universal Main Service Agreement). Per determinare il contratto servizio in abbonamento dell'organizzazione:
  1. Selezionare l'avatar del profilo nella Workday Community .
  2. Selezionare
    Profilo
     .
  3. Nella pagina del profilo, selezionare il nome dell'organizzazione, che si trova sotto il nome e accanto al titolo impiego.
  4. Visualizzare il valore
    del Contratto di servizio in abbonamento
     .
Se il valore è:
I crediti flessibili sono obbligatorio solo per la registrazione e l'utilizzo degli agenti nei tenant di produzione. Non sarà possibile registrare e utilizzare gli agenti in produzione fino a quando non saranno stati attivati questi contratti. UMSA è obbligatorio per i tenant non di produzione e di produzione per gli agenti Workday-Built. L'UMSA non è obbligatorio per i tenant non di produzione per gli agenti creati autonomamente.
Configurare il sistema di registrazione degli agenti .
Criteri di sicurezza:
  • dominio
    Agent Management Hub
     nell'area area funzionale Agent System of Record . Obbligatorio per verificare che l'agente sia registrato in Workday.
  • dominio
    Manage Agents
     nell'area area funzionale Agent System of Record . Obbligatorio per l'attivazione e la configurazione skill .
  • Dominio
    Set Up: Tenant Setup - Security
     nell'area funzionale System Obbligatorio per la registrazione.

Contesto

Al momento, è possibile registrare e definire agenti esterni in Workday solo utilizzando l' API ASOR . Gli agenti esterni vengono definiti e registrati contemporaneamente utilizzando l' API, non sono due step separati. È possibile utilizzare qualsiasi client API di propria preferenza per richiamare l' API.
Per la risoluzione dei problemi, fare riferimento alla documentazione API ASOR v1.2 in Github e all'esempio di documentazione ASOR JSON Swagger .
Endpoint di registrazione:
  • Endpoint API REST :
     https://us.agent.workday.com/asor/v1/agentDefinition.
  • Token Endpoint:
     https://us.agent.workday.com/auth/oauth2/<Tenant_Name>/token
  • Autorizzazione endpoint:
     https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
Per informazioni relative alla disponibilità in altre aree geografiche al di fuori degli Stati Uniti, consultare la documentazione di Agent Gateway:Riferimenti: Disponibilità a livello regionale di Agent Gateway .

Opzioni di autenticazione:

Per registrare gli agenti esterni, è necessario un token di accesso nella chiamata API ASOR. Di seguito sono elencate le diverse opzioni per ottenere un token per richiamare la chiamata API ASOR.
Opzione 1: autenticare manualmente un client API
  1. Accedere attività
    Registrazione client API
     .
    • Nome cliente:
       immettere un nome univoco per l'agente. Si consiglia di utilizzare un client separato per ogni agente, in modo da semplificarne la gestione.
    • Tipo sovvenzione cliente:
      assegnazione codice autorizzazione
       .
    • Tipo token di accesso:
      Bearer
       .
    • URI di reindirizzamento:
       immettere un URL a cui reindirizzare gli utenti dopo l'autorizzazione.
    • Ambito (aree funzionali):
      sistema di registrazione agente
       .
    • Includi ambito di proprietà Workday :
       selezionare la casella di controllo.
  2. Copiare e salvare i valori
    ID client
     e
    Segreto client
     . È possibile utilizzarli per ottenere un token di accesso per chiamare l' API di definizione .
  3. Incollare questo URL in una nuova finestra. Dovrebbe reindirizzarti a google.com con un codice aggiunto che puoi utilizzare per chiamare l' API:
    https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
  4. Creare una nuova richiesta utilizzando un client API esterno (esempio: Bruno):
    https://<tenantHost>/ccx/oauth2/<tenantName>/ token
    • Corpo:
      grant_type=authorization_code&code=<authorizationCode>&client_id=<clientID>&client_secret=<ClientSecret>
    • Auth: Username =
      <ClientID>
       , Password =
      <ClientSecret>
       .
    • Questo genera un token di accesso e token aggiornare che è possibile utilizzare per chiamare l' API ASOR Agent Definition .
    • Questo step contiene i seguenti elementi:Concetto: Considerazioni su ASU agente esterno .
L'utente registrazione l'agente deve avere accesso al dominio Setup: Agents nell'area area funzionale Agent System of Record per poter registrare un agente utilizzando l' API ASOR .
Opzione 2: autenticazione tramite estensione
Gli utenti Workday Extend o Workday Orchestrate possono recuperare un token di accesso tramite il sito per sviluppatori di Workday.
  1. Accedere a developer.workday.com e accedere.
  2. In alto a destra, fare clic sul menu utente. Il menu dovrebbe visualizzare il nome azienda corrente.
  3. Fare clic su
    Tenant
    Accedi a tenant
     .
  4. Selezionare l'ambiente e il tenant e fare clic su
    Connetti a tenant
     .
  5. Accedere al tenant. Per registrare un agente utilizzando l' API ASOR , è necessario accedere con un account che abbia accesso al dominio
    Setup: Agents
     nell'area area funzionale Agent System of Record.

Registrare un agente esterno utilizzando l' API ASOR

Prerequisiti:
  • Un token di accesso per un account che ha accesso al dominio
    Setup: Agents
     nell'area area funzionale Agent System of Record .
  • Un client API a scelta.
  • Criteri di sicurezza: i seguenti domini nell'area funzionale System:
    • Custom Report Creation
    • Manage: All Custom Reports
    • Report Tag Management
Context:
Per registrare un agente esterno, è necessario:
  • Trovare gli ID Workday (WID) delle API Workday (SOAP e REST) pertinenti che si intende includere nella definizione degli strumenti dell'agente creando un report personalizzato.
  • Trovare il provider agente utilizzando l' attività
    Visualizzazione provider agente
     .
  • Richiamare l' API REST ASOR
Ricerca di WID basati su SOAP e REST per la definizione degli strumenti agente
  1. Accedere all'attività
    Creazione report personalizzato
    .
  2. La creazione del report contiene i seguenti elementi:
    Opzione
    Descrizione
    Tipo report
    Selezionare
    Avanzato
    .
    Ottimizzato per performance
    Deselezionare questa casella di controllo.
    Origine dati
    Selezionare
    Public Web Services
     for SOAP APIs e
    All Public Service Operations
     for REST APIs.
  3. Per le API SOAP: nella pagina
    Modifica report personalizzato
     , nella scheda
    Colonne
     della definizione del report, aggiungere le seguenti righe:
    Oggetto business
    Campo
    Servizio Web
    Servizio Web
    Operazione del servizio Web
    Nome operazione servizio Web
    Operazione del servizio Web
    ID Workday
  4. Per le API REST: nella pagina
    Modifica report personalizzato
     , nella scheda
    Colonne
     della definizione del report, aggiungere le seguenti righe:
    Oggetto business
    Campo
    Operazione di servizio
    Servizio
    Operazione di servizio
    Nome
    Operazione di servizio
    ID Workday
  5. Salvare ed eseguire il report.
Quando si recuperano i WID per le API, è anche possibile fare riferimento incrociato ai seguenti elenchi:
Individuare il provider dell'agente
I provider agente fanno riferimento a chi ha creato l'agente e vengono visualizzati nel campo
Creato da
 nel profilo dell'agente.
  1. Accedere attività
    View Agent Provider
     , protetto al dominio
    Setup: Agents
     nell'area area funzionale Agent System of Record .
  2. Utilizzare l'ID provider nella chiamata API di registrazione agente.
Trovare la piattaforma agente
Le piattaforme agente si riferiscono alla piattaforma o al sistema esterno su cui l'agente è sviluppato ed eseguito e vengono visualizzate nel campo
Integrazione
 del profilo dell'agente.
  1. Accedere attività
    View Agent Platforms
     , protetto al dominio Setup Agents nell'area area funzionale Agent System of Record .
  2. Utilizzare l'ID piattaforma nella chiamata API di registrazione agente.
Richiamare l' API REST ASOR
Creare una nuova richiesta per registrare l'agente utilizzando un client API esterno, ad esempio Bruno.
La richiesta contiene i seguenti elementi:

Hub gestione agenti

Dopo aver caricato la definizione dell'agente nel Workday, è possibile verificarne la registrazione visualizzandola nell'Hub
gestione agenti
 .
  1. Accedere al report
    Hub gestione agenti
     .
  2. Fare clic su
    Registro agenti
     per visualizzare un elenco degli agenti.
  3. Fare clic su un agente per visualizzarne le informazioni generali.

Passaggi successivi

Configurare l'agente in Workday.