개요
DAIOps AI 직원을 외부 서비스·챗봇·자동화에 연결하는 개발자 API 문서입니다. API 키 하나로 웹앱과 동등하게 대화하고, 파일을 주고받고, 과거 대화를 조회할 수 있어요.
세 가지 연결 방식
같은 직원을 목적에 맞는 프로토콜로 연결합니다. 셋 다 같은 dai_ API 키를 씁니다.
| 방식 | 언제 쓰나 | 대표 엔드포인트 |
|---|---|---|
| REST | 직접 HTTP 연동, 챗봇, 서버-투-서버. 토큰 스트리밍 지원 | POST /api/v1/workspaces/:id/messages |
| MCP | Claude Desktop 등 MCP 클라이언트에서 도구로 사용 | POST /api/v1/workspaces/:id/mcp |
| A2A | 표준 A2A 에이전트로 노출(에이전트 간 통신) | POST /api/v1/workspaces/:id/a2a |
처음이라면 REST로 시작하세요 — 가장 직관적이고 예제가 많습니다.
시작 전 준비
- AI 직원 채용 — 웹앱에서 워크스페이스(직원)를 하나 만드세요.
:id가 그 워크스페이스 ID입니다. - API 키 발급 — 설정 > 개발자 도구에서
dai_live_…키를 만듭니다. → 인증 & 스코프 - 첫 요청 보내기 — → 빠른 시작
알아두면 좋은 것
- 직원 라이프사이클: 직원은 유휴 시 "퇴근"(중지)했다가 요청이 오면 자동으로 "출근"합니다. 첫 요청은 워밍업으로 몇 초 걸릴 수 있어요.
- 응답 형태: 스트리밍(SSE)으로 토큰을 실시간으로 받거나, 블로킹 JSON으로 최종 결과만 받을 수 있습니다.
- 기계용 스펙: 전체 엔드포인트·스키마는 무인증 OpenAPI 스펙
GET /api/v1/openapi에서 확인하세요.
다음 단계
- 빠른 시작 — 키 발급부터 첫 응답까지 5분
- 인증 & 스코프 — 키 권한 이해하기
- REST (스트리밍) — 프로토콜 상세