AI Actions

API로 AI 에이전트의 AI Actions를 관리하세요.

선택적으로 사용할 수 있는 예시 검사

JSONPath 일치 미리보기. 제공한 JSON에서 루트, 필드, 배열 인덱스, 와일드카드 경로를 검사합니다. Action을 실행하거나 대화 메모리를 저장하지 않습니다.
예시 MCP 연결 검사하기. Cloudflare 문서 또는 Microsoft Learn 엔드포인트에서만 초기화하고 도구를 나열합니다. 로그인이나 도구 실행은 하지 않습니다.

호환되는 브라우저에서는 이 검사를 사이트 도구로도 사용할 수 있습니다. 링크는 일반 양식을 엽니다.

AI Actions

AI Actions는 지식 베이스 답변을 넘어 에이전트의 기능을 확장합니다. 대화에서 특정 상황을 감지할 때 수행할 동작을 정의할 수 있습니다.

AI Actions의 기능:

HTTP 요청 Actions: 실행 시 외부 API를 호출합니다. 대화 중 백엔드 주문 상태 조회, 지원 티켓 생성, 계정 정보 조회 등을 수행할 수 있습니다.
MCP Actions: Model Context Protocol 서버에 연결하여 Shopify 제품 조회, 맞춤 데이터베이스 쿼리 같은 고급 도구를 연동합니다.

일반적인 활용 사례:

대화 중 백엔드에서 주문 상태, 계정 정보, 재고 등 실시간 정보 조회
대화 맥락에 따라 티켓 생성, CRM 기록 수정, 외부 워크플로 실행
제품 카탈로그를 조회하여 맞춤 추천 제공

각 Action에는 name, description(HTTP 요청 Action에서는 실행 시점을 AI에 설명), 유형별 설정이 있습니다. API로 각각 켜거나 끌 수 있습니다. 생성과 전체 설정은 Quickchat 대시보드에서 합니다. API는 목록, 수정(활성화/비활성화), 삭제와 MCP Actions 생성 및 설정 전용 엔드포인트를 제공합니다.

모든 AI Actions 조회

권한 범위: read_all

GET https://app.quickchat.ai/v1/api/ai_actions

Shell
Python

curl https://app.quickchat.ai/v1/api/ai_actions \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/ai_actions",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

응답 200 OK

[
  {
    "id": 1,
    "name": "Check Order Status",
    "description": "Look up order status when customer asks about their order.",
    "is_active": true,
    "type": "http_request",
    "icon": null,
    "icon_color": null,
    "is_valid": true
  }
]

필드	설명
`id` 정수	AI Action 식별자
`name` 문자열	표시 이름
`description` 문자열	실행 조건
`is_active` 불리언	활성화 여부
`type` 문자열	`"http_request"`, `"remote_mcp"`, `"shopify_remote_mcp"`, `"knowledge_base"`
`icon` 문자열 또는 null	아이콘 식별자
`icon_color` 문자열 또는 null	아이콘 색상
`is_valid` 불리언	올바른 설정 여부

AI Action 수정

권한 범위: write_all

PATCH https://app.quickchat.ai/v1/api/ai_actions/{action_id}

요청 본문

매개변수	설명
`is_active` 불리언	Action 활성화/비활성화
`icon` 문자열	아이콘 식별자(최대 200자)
`icon_color` 문자열	아이콘 색상(최대 50자)

Shell
Python

curl -X PATCH https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"is_active": false}'

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"is_active": False},
)
data = response.json()

응답 200 OK: 수정된 AI Action 스냅샷을 반환합니다.

AI Action 삭제

권한 범위: write_all

DELETE https://app.quickchat.ai/v1/api/ai_actions/{action_id}

Shell
Python

curl -X DELETE https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

응답 200 OK(빈 본문)

MCP Action 생성

권한 범위: write_all

POST https://app.quickchat.ai/v1/api/ai_actions/remote_mcp

원격 MCP 서버를 AI 에이전트의 MCP Action으로 연결합니다. write_all 권한의 API 토큰이 필요하며 토큰에는 Business 플랜 이상가 필요합니다.

요청 본문

매개변수	설명
`remote_mcp_url` 문자열, 필수	MCP 서버 URL. `https://`여야 하며 사설 또는 내부 네트워크 주소로 연결되는 URL은 거부됩니다.
`headers` 배열, 필수	고정 `Authorization` 토큰 등 서버로 보낼 연결 헤더. 각 항목은 `{"id", "name", "value"}`이며 `id`는 임의의 고유 문자열입니다. 필요 없으면 `[]`를 보내세요.
`allowed_tools` 배열, 필수	도구별 스위치 `{"name", "is_active"}`. `default_tool_is_active`에 맡기려면 `[]`를 보내세요.
`name` 문자열	Actions 목록의 표시 이름(최대 100자). 기본값은 서버 호스트에서 만든 라벨입니다.
`description` 문자열	Actions 목록의 설명(최대 2,500자)
`icon` 문자열	아이콘 식별자(최대 200자)
`icon_color` 문자열	아이콘 색상(최대 50자)

name과 description은 운영자용 라벨로 대시보드에서 Action을 식별하며 AI는 읽지 않습니다. AI는 MCP 서버 자체가 게시한 도구 설명을 사용합니다.

Shell
Python

curl -X POST https://app.quickchat.ai/v1/api/ai_actions/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "remote_mcp_url": "https://mcp.example.com/mcp",
    "headers": [
      {"id": "h-1", "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
    ],
    "allowed_tools": [],
    "name": "Example MCP"
  }'

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/ai_actions/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "remote_mcp_url": "https://mcp.example.com/mcp",
        "headers": [
            {"id": "h-1", "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
        ],
        "allowed_tools": [],
        "name": "Example MCP",
    },
)
data = response.json()

응답 201 Created

{
  "id": 2,
  "name": "Example MCP",
  "description": "Connected MCP server",
  "is_active": false,
  "type": "remote_mcp",
  "icon": "FaMixcloud",
  "icon_color": "#EF4444",
  "is_valid": true,
  "validation_issues": [],
  "remote_mcp_url": "https://mcp.example.com/mcp",
  "remote_mcp_auth_token": "",
  "default_tool_is_active": true,
  "allowed_tools": [],
  "headers": [
    {"id": 10, "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
  ],
  "oauth": null,
  "recommended_tools": []
}

필드	설명
`remote_mcp_url` 문자열	연결한 MCP 서버 URL
`default_tool_is_active` 불리언	`allowed_tools`에 없는 도구의 사용 허용 여부
`allowed_tools` 배열	도구별 스위치 `{"name", "is_active"}`
`headers` 배열	저장된 연결 헤더
`remote_mcp_auth_token` 문자열 또는 null	기존 고정 토큰 필드. API로 설정할 수 없으므로 인증 정보는 `headers`로 전달하세요.
`oauth` 객체 또는 null	OAuth 로그인으로 연결한 서버의 승인 상태(그 외에는 `null`)
`recommended_tools` 배열	관리형 프로필이 있는 서버에 Quickchat이 권장하는 도구 이름(읽기 전용)
`validation_issues` 배열	실패한 설정 검사 이름. `is_valid`가 `true`이면 비어 있음

나머지 필드는 모든 AI Actions 조회와 같습니다.

Action은 is_active: false로 생성됩니다. Quickchat 관리형 프로필이 없는 서버는 default_tool_is_active: true로 시작하므로 제한하기 전까지 응답 시 발견한 모든 도구를 허용합니다. 켜려면 위 AI Action 수정 엔드포인트 PATCH /v1/api/ai_actions/{action_id}에 {"is_active": true}를 보내세요.

MCP Action 설정 조회

권한 범위: read_all

GET https://app.quickchat.ai/v1/api/ai_actions/{action_id}/remote_mcp

Shell
Python

curl https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>'

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

응답 200 OK: 위 생성 응답과 같은 형태의 MCP 전용 설정을 반환합니다.

MCP Action 설정 수정

권한 범위: write_all

PATCH https://app.quickchat.ai/v1/api/ai_actions/{action_id}/remote_mcp

모든 필드는 선택 사항이며 보낸 필드만 변경됩니다.

요청 본문

매개변수	설명
`remote_mcp_url` 문자열	새 서버 URL(생성과 같은 검증). OAuth 서버의 URL을 바꾸면 저장한 승인을 지우고 Action을 끕니다.
`headers` 배열	연결 헤더 교체
`allowed_tools` 배열	도구별 스위치 `{"name", "is_active"}` 교체
`default_tool_is_active` 불리언	`allowed_tools`에 없는 도구의 사용 허용 여부
`name` 문자열	표시 이름(최대 100자)
`description` 문자열	Actions 목록의 설명(최대 2,500자)

Shell
Python

curl -X PATCH https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_tools": [
      {"name": "search_docs", "is_active": true},
      {"name": "delete_page", "is_active": false}
    ],
    "default_tool_is_active": false
  }'

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "allowed_tools": [
            {"name": "search_docs", "is_active": True},
            {"name": "delete_page", "is_active": False},
        ],
        "default_tool_is_active": False,
    },
)
data = response.json()

응답 200 OK: 생성 응답과 같은 형태의 수정된 MCP Action을 반환합니다.

대시보드 연결 검사에 해당하는 연결 테스트와 도구 검색은 공개 API에서 제공하지 않습니다. 대시보드에서 서버를 연결하거나 다시 연결할 때 자동으로 검사합니다. OAuth로 보호된 서버는 대시보드에서 승인을 완료해야 하며 위 응답의 oauth 필드가 상태를 나타냅니다.

AI Actions

선택적으로 사용할 수 있는 예시 검사

AI Actions

모든 AI Actions 조회

AI Action 수정

AI Action 삭제

MCP Action 생성

MCP Action 설정 조회

MCP Action 설정 수정

시작하기

AI 에이전트

액션

대화

채널

웹사이트

헬프데스크 및 CRM

메신저 앱

계정 및 결제

시작하기

설정

지식 베이스

대화