Chatbot Settings

REST API を使って AI Agent の設定全体を取得・更新します。

Chatbot Settings

パーソナリティ、会話スタイル、システムプロンプトを含む AI Agent の設定全体を取得・更新します。

Dashboard の Identity > Profile および Identity > Conversation Style に対応します。

Get Chatbot Settings

Scope: read_all

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

Shell
Python

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

import requests

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

Response 200 OK

{
  "personality": 0,
  "profession": "helpful_assistant",
  "creativity_level": 1,
  "greeting": "<p>Hello! How can I help you today?</p>",
  "greeting2": "",
  "header": "Support Assistant",
  "header2": "",
  "language_chosen": "en",
  "reply_length": 1,
  "one_word_description": "Support Agent",
  "short_description": "A helpful customer support assistant.",
  "ai_commands": ["Be polite", "Stay on topic"]
}

Field	Description
`one_word_description` string	AI Agent 名。Dashboard: Identity > Profile > AI Agent Name（最大 200 文字）
`short_description` string	システムプロンプト / AI Agent の説明。Dashboard: Identity > Profile > AI Agent Description（最大 2000 文字）
`ai_commands` array of strings	AI の行動ガイドライン。Dashboard: Identity > Conversation Style > AI Guidelines（1 項目あたり最大 500 文字、全項目合計で最大 5000 文字）
`personality` integer (0–13)	AI パーソナリティのプリセット。Dashboard: Identity > Conversation Style > Personality。下表を参照
`profession` string	AI の職種 / 役割。Dashboard: Identity > Conversation Style > Profession（最大 200 文字）。下表を参照
`creativity_level` integer (0–2)	Dashboard: Identity > Conversation Style > Creativity。`0` = Deterministic、`1` = Balanced、`2` = Creative
`reply_length` integer (0–2)	Dashboard: Identity > Conversation Style > Reply Length。`0` = Short、`1` = Medium、`2` = Long
`greeting` string	メインの挨拶メッセージ（HTML）。Dashboard: Identity > Profile > Greeting messages（最大 1000 文字）
`greeting2` string	サブの挨拶メッセージ（HTML）。Dashboard: Identity > Profile > Greeting messages
`header` string	チャットヘッダーのテキスト。Dashboard: Identity > Profile > Chat header text（最大 200 文字）
`header2` string	サブのヘッダーテキスト。Dashboard: Identity > Profile > Chat header text（最大 200 文字）
`language_chosen` string	カンマ区切りの言語コード（例：`"en,es,de"`）。Dashboard: Identity > Profile > Languages（合計で最大 10 文字）

Personality の値:

Value	Label	Description
0	Classic	バランスが取れており、プロフェッショナルさと親しみやすさが調和（デフォルト）
1	Humorous	ダジャレやジョークを交えた機知に富んだトーンで、楽しいやり取り
2	Formal	フォーマルで真面目、ビジネス向けに簡潔で事実に基づいた情報
3	Friendly	親しみやすく個人的な雰囲気のカジュアルな会話
4	Sassy	自信に満ち、ユーモアを交えた遊び心のある対応
5	Intelligent	包括的な理解のための詳細で正確な情報
6	Empathetic	気持ちに配慮した、思いやりと共感のあるやり取り
7	Bold	自信を持って伝える、強い意見や推奨
9	Excited	活気にあふれエネルギッシュな関わり
10	Mysterious	ユニークな体験のための、謎めいて興味をそそる応答
11	Inspiring	コーチのようにポジティブ思考と目標達成を後押し
12	Adventurous	快適な領域を抜け出し、新たな機会を探ることを促す
13	Elegant	ユニークで上質なブランドのための洗練された体験

Profession の値:

Value	Dashboard Label	Description
`helpful_assistant`	Helpful Assistant	多用途で汎用的。ほとんどのユースケースに推奨
`customer_support_representative`	Support Agent	共感的で、ステップバイステップの解決策とトラブルシューティングを提供
`shopping_assistant`	Shopping Assistant	リンク付きの商品レコメンドを積極的に提示
`field_expert`	Field Expert	専門コンサルタントとして、明確化のための質問を行い、専門的な指針を提供
`interviewer`	Interviewer	回答する代わりに質問する。アンケート、インタビュー、フィードバック向け

Update Chatbot Settings

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/chatbot_settings

Request Body — すべてのフィールドは任意です。更新したいフィールドのみを含めてください。

Parameter	Description
`personality` integer (0–13)	AI パーソナリティのプリセット
`profession` string	AI の職種 / 役割（最大 200 文字）
`creativity_level` integer (0–2)	`0` = Deterministic、`1` = Balanced、`2` = Creative
`greeting` string	メインのウェルカムメッセージ（HTML、最大 1000 文字）
`greeting2` string	サブのウェルカムメッセージ
`header` string	チャットヘッダーのテキスト（最大 200 文字）
`header2` string	サブのヘッダーテキスト（最大 200 文字）
`language_chosen` string	カンマ区切りの言語コード（合計で最大 10 文字）
`reply_length` integer (0–2)	`0` = Short、`1` = Medium、`2` = Long
`one_word_description` string	AI Agent 名（最大 200 文字）
`short_description` string	AI Agent のシステムプロンプト / 説明（最大 2000 文字）
`ai_commands` array of strings	AI Guidelines（1 項目あたり最大 500 文字）

Shell
Python

curl -X PATCH https://app.quickchat.ai/v1/api/chatbot_settings \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "greeting": "<p>Welcome! Ask me anything.</p>",
  "creativity_level": 2
}'

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/chatbot_settings",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "greeting": "<p>Welcome! Ask me anything.</p>",
        "creativity_level": 2,
    },
)
data = response.json()

Response 200 OK — 更新された chatbot settings を返します（Get Chatbot Settings のレスポンスと同じスキーマ）。

Chatbot Settings