> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/ai-1.md).

# AI 가용성

## AI agent 가용성 일괄 조회

> 모든 ST025 agent 의 가용성을 한 번에 반환합니다. 프론트는 enum 이름(AI\_TRANSLATE, COPY\_WRITER 등)으로 단건 조회합니다.

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AiAvailabilityResponse":{"type":"object","description":"AI agent 가용성 일괄 응답","properties":{"xgenEnabled":{"type":"boolean","description":"xgen 마스터 스위치 여부"},"agents":{"type":"object","additionalProperties":{"type":"boolean"},"description":"agent 별 가용성"}}}}},"paths":{"/v1/common/ai/availability":{"get":{"tags":["AI 가용성"],"summary":"AI agent 가용성 일괄 조회","description":"모든 ST025 agent 의 가용성을 한 번에 반환합니다. 프론트는 enum 이름(AI_TRANSLATE, COPY_WRITER 등)으로 단건 조회합니다.","operationId":"getAvailability","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiAvailabilityResponse"}}}}}}}}}
```

## 단일 AI agent 가용성 조회

> 특정 agent 의 가용성을 단건으로 반환합니다. agent 는 ST025 enum 이름입니다.

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/common/ai/availability/{agent}":{"get":{"tags":["AI 가용성"],"summary":"단일 AI agent 가용성 조회","description":"특정 agent 의 가용성을 단건으로 반환합니다. agent 는 ST025 enum 이름입니다.","operationId":"getAgentAvailability","parameters":[{"name":"agent","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"boolean"}}}}}}}}}
```