AI 에이전트

목록 조회

GET /ai-agents — 워크스페이스의 AI 에이전트 설정을 조회합니다.

Scope: ai-agents:read
쿼리: limit(기본 50, 최대 100)

AI 에이전트 설정은 워크스페이스당 1개이므로 목록은 항상 0개 또는 1개 항목을 반환합니다. 정상적으로 생성된 워크스페이스는 기본 설정이 항상 시드되므로 1개를 반환하며, 0개(빈 배열)는 설정이 {}로 수동 초기화된 예외적인 경우에만 발생합니다. id는 워크스페이스 ID와 동일합니다.

enabled는 기본값이 false이며(운영자가 직접 AI를 켜야 활성화됨), 아래 예시의 enabled: true는 활성화된 워크스페이스의 경우입니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/ai-agents" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "5f3e8c10-...",
      "enabled": true,
      "failover_timeout": 60,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "meta": { "has_more": false }
}

failover_timeout은 AI 응답 대기 후 상담원에게 넘기기까지의 시간(초)입니다. 활성 상태일 때는 10~300초 범위이며, AI가 비활성이거나 설정에 값이 없는 경우 0이 반환될 수 있으므로 0을 오류로 처리하지 마세요. 워크스페이스당 항상 단일 항목이므로 meta.has_more는 항상 false이며 next_cursor는 반환되지 않습니다.

프롬프트 본문(prompt_template)과 LLM API 키(model_api_key)는 민감 정보로 응답에서 항상 제외되며 이 엔드포인트로 노출되지 않습니다.

목록 조회​

목록 조회