---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 에이전트 - 전역

# 에이전트 - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

에이전트 API는 에이전트 현재 상태 및 채널 가용성을 가져오거나 설정하는 메서드를 제공합니다.

에이전트 API는 `sn_awa` 네임스페이스 내에서 제공됩니다.  
다음이 필요합니다.

* 고급 작업 할당 플러그인(com.glide.awa)
* 역할: awa_integration_user 또는 admin
{#c_AgentAPI__ul_cgv_mtc_2gb}

## 에이전트 - get(문자열 user_sys_id) {#ariaid-title2}

sys_id로 에이전트를 가져옵니다.
{#r_agent_get__table_t4k_y54_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| user_sys_id | 문자열 | 테이블에 나열된 사용자의 sys_id sys_user입니다. |
[표 1. 매개변수]

{#r_agent_get__table_t4k_y54_3gb} {#r_agent_get__table_u4k_y54_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자가 존재하면 True, 그렇지 않으면 False입니다. |
[표 2. 반환]

{#r_agent_get__table_u4k_y54_3gb}  

    var agent = sn_awa.Agent.get("<user_sys_id>");
    var presence  = agent.getPresence();

## 에이전트 -- getPresence() {#ariaid-title3}

제공된 에이전트의 현재 현재 상태 및 채널 가용성을 가져옵니다.
{#r_getPresence__table_kt3_zrc_2gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#r_getPresence__table_kt3_zrc_2gb} {#r_getPresence__table_lt3_zrc_2gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 현재 상태 sys_id, 현재 상태 이름 및 채널 정보입니다. 그렇지 않은 경우 오류 메시지입니다. |
[표 4. 반환]

{#r_getPresence__table_lt3_zrc_2gb}  

    var agent = sn_awa.Agent.get("<user_sys_id>");
            var presence  = agent.getPresence();

## 에이전트 -- setPresence(Object setRequest) {#ariaid-title4}

제공된 에이전트의 현재 상태를 설정하고 해당 상태에 대한 에이전트의 채널 가용성을 설정합니다.
{#r_setPresence__table_hqw_pbm_yfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 세트요청 | 객체 | setRequest.sys_id 및 setRequest.channels |
| setRequest.sys_id | 문자열 | AWA 현재 상태 \[awa_presence_state\] 테이블의 presence_sys_id입니다. |
| setRequest.channels | 이름/값 쌍 | 옵션입니다. * sys_id: awa_service_channel 테이블에서 Channel_sys_id. * 사용 가능: 이 채널에 대한 작업을 받을 수 있는 에이전트 가용성(예 또는 아니오)입니다. {#r_setPresence__ul_vsh_tqn_kgb} |
[표 5. 매개변수]

{#r_setPresence__table_hqw_pbm_yfb} {#r_setPresence__table_iqw_pbm_yfb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 성공하면 예, 그렇지 않으면 아니오입니다. |
[표 6. 반환]

{#r_setPresence__table_iqw_pbm_yfb}  

    var agent = sn_awa.Agent.get("<user_sys_id>");
    var presence = agent.setPresence({
        sys_id: <presence_sys_id>,
        channels: [{
            sys_id: "<channel_sys_id>",
            available: true // or false
        }]
    });