alibabacloud-analyticdb-postgresql-ai-coaching-best-practice について
Alibaba Cloud 上に AI コーチング基盤を構築するエージェントスキルです。Supabase プロジェクトで構造化されたコーチングデータを管理し、ADBPG ベクトルナレッジベースで RAG 対話を支援します。
主な機能
- 01Supabase プロジェクトの作成
- 02ADBPG ベクトルナレッジベースの設定
- 03構造化コーチングデータの管理
- 04RAG によるコーチング対話
- 05クラウドリソース設定のガイド
活用シーン
- 01営業やプロジェクトの業務フロー指導
- 02技術的な選択肢の評価支援
- 03コミュニケーションや交渉の練習
- 04新入社員のオンボーディング
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aliyun/ alibabacloud-aiops-skills --skill alibabacloud-analyticdb-postgresql-ai-coaching-best-practiceインストール後、Claude Code で/alibabacloud-analyticdb-postgresql-ai-coaching-best-practiceを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/acceptance-criteria.mdcli-installation-guide.mdcli-parameter-guide.mddatabase-schema.mdram-policies.mdrelated-apis.mdverification-method.md詳細
ADBPG AI コーチングのベストプラクティス
ADBPG Supabase(トレーニングデータ管理)+ADBPG Vector Knowledge Base(RAG 主導のインテリジェントなコーチング)を使用して、RAG 主導のコーチングシステムを構築します。
主な機能:
- Supabase プロジェクト:コーチング領域、学習者、セッション記録を管理する PostgreSQL ベースのプラットフォーム
- Vector Knowledge Base:RAG 主導のコーチングに最適化されたベクトル機能を備えた ADBPG インスタンス
- シームレスな統合:Supabase が構造化データを保存し、ADBPG がインテリジェントな AI コーチング対話を実現します
事前確認:Aliyun CLI >= 3.3.3 が必要です
重要:
aliyun versionを実行して、バージョンが >= 3.3.3 であることを確認してください。未インストールの場合、またはバージョンが古い場合は、curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bashを実行して更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。次に、プラグインの自動インストールを有効にするため、[必須]
aliyun configure set --auto-plugin-install trueを実行してください。 ローカルマシンに既存のプラグインがある場合に常に最新の状態に保つため、[必須]aliyun plugin updateを実行してください。
[必須] CLI User-Agent
aliyunCLI コマンドを実行するたびに、次のオプションを含める必要があります:--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
[必須] CLI AI モードの設定
コアワークフローの開始時(CLI を実行する前)に行います。
[必須] AI モードを有効にする — エージェントスキルの実行には AI モードが必要です。 CLI を実行する前に、次のコマンドを実行してください。
aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice"
[必須] あらゆる終了時に AI モードを無効にする — どのような理由であっても、最終応答を送信する前に、必ず最初に AI モードを無効にしてください。これは、ワークフローの成功、ワークフローの失敗、エラー/例外、ユーザーによるキャンセル、セッションの終了、または以降に CLI コマンドを実行しないその他すべての状況を含む、すべての終了経路に適用されます。 AI モードはエージェントスキルの呼び出し時のみ使用し、スキルの実行停止後も有効なままにしてはなりません。
aliyun configure ai-mode disable
事前確認:Alibaba Cloud の認証情報が必要です
セキュリティルール:
- AK/SK の値を読み取ったり、エコーしたり、出力したりしてはなりません
- ユーザーに AK/SK の直接入力を求めてはなりません
- パスワードや API キーをログや標準出力に平文で出力してはなりません
- 認証情報の状態確認には
aliyun configure listのみを使用してください- API キーを表示する場合は、先頭 6 文字と
***のみを表示してください(例:sk-abc1***)
aliyun configure list
有効なプロファイルが存在しない場合は、ここで停止してください。このセッション外で aliyun configure または環境変数を使用して認証情報を設定してください。
シナリオの説明
| シナリオ | ユースケース | 対象ユーザー |
|---|---|---|
| ワークフローコーチング | 構造化されたビジネスプロセス(営業サイクル、プロジェクト管理)を専門家が進められるよう支援します | 営業チーム、プロジェクトマネージャー |
| 意思決定支援 | エンジニアがトレードオフを評価し、十分な情報に基づいて技術的な意思決定を行えるよう支援します | エンジニア、アーキテクト |
| スキル開発 | ガイド付きの実践を通じて、コミュニケーション、交渉、または技術的なスキルを伸ばします | 専門家、新入社員 |
| オンボーディング | 新しいチームメンバーが技術面およびプロセス面のオンボーディングを段階的に進められるよう支援します | 新入社員、メンター |
アーキテクチャ
User (Web / Terminal / Agent)
│
┌──────┴──────┐
v v
┌─────────────┐ ┌────────────────────────┐
│ Supabase │ │ Agent Mode │
│ (spb-xxx) │ │ ChatWithKnowledgeBase │
│ - Domains │ └───────────┬────────────┘
│ - Sessions │ │
└──────┬──────┘ │
v v
┌────────────────────────────────────────┐
│ ADBPG Instance (gp-xxx) + KB │
│ Domain Knowledge + RAG + LLM │
└────────────────────────────────────────┘
RAM ポリシー
必要な権限
| 操作 | RAM 権限 |
|---|---|
| Supabase プロジェクト管理 | gpdb:CreateSupabaseProject、gpdb:GetSupabaseProject、gpdb:ModifySupabaseProjectSecurityIps |
| ADBPG インスタンス管理 | gpdb:CreateDBInstance、gpdb:DescribeDBInstances、gpdb:ModifySecurityIps |
| アカウント管理 | gpdb:DescribeAccounts、gpdb:CreateAccount |
| ナレッジベース操作 | gpdb:InitVectorDatabase、gpdb:CreateNamespace、gpdb:CreateDocumentCollection、gpdb:UploadDocumentAsync、gpdb:ChatWithKnowledgeBase |
| VPC ネットワーク | vpc:DescribeVpcs、vpc:DescribeVSwitches、vpc:DescribeVSwitchAttributes |
| NAT ゲートウェイと EIP | vpc:DescribeNatGateways、vpc:CreateNatGateway、vpc:DescribeEipAddresses、vpc:AllocateEipAddress、vpc:AssociateEipAddress、vpc:CreateSnatEntry |
推奨システムポリシー: AliyunGPDBFullAccess、AliyunVPCFullAccess(NAT がすでに存在する場合は AliyunVPCReadOnlyAccess)
完全なリストは、references/ram-policies.md を参照してください。
[必須] 権限エラーへの対応: 権限エラーが原因でコマンドが失敗した場合:
- 必要な権限を確認するため、references/ram-policies.md を読む
ram-permission-diagnoseスキルを使用してユーザーを案内する- ユーザーが権限の付与を確認するまで待機する
基本的なワークフロー
ユーザーが「AI コーチングシステムのセットアップを手伝って」などと依頼した場合は、次の手順を実行します。
スマートデフォルトモード:ユーザーが入力する情報は最小限で済みます(例:「北京i」)。エージェントがリージョンを自動解析し、VPC/VSwitch を検出してパスワードを生成したうえで、すべてのパラメーターを提示し、ワンクリックで確認できるようにします。
ステップ 1:Supabase プロジェクトを作成する
このステップで確認するパラメーター:
パラメーター デフォルト 備考 RegionId自動解析 「北京i」→ cn-beijing、「上海b」→cn-shanghai、「杭州」→cn-hangzhou、「深圳」→cn-shenzhenZoneId自動解析 「北京i」→ cn-beijing-i。都市名のみの場合はゾーンを照会VpcId自動検出 利用可能な VPC を照会し、利用可能な IP アドレスが最も多いものを選択 VSwitchId自動検出 対象ゾーン内の VSwitch を照会し、利用可能な IP アドレスが最も多いものを選択 ProjectNameai_coachingSupabase プロジェクト名 AccountPassword自動生成 パスワードのルール: 8~32 文字で、大文字・小文字・数字・特殊文字( @#$%^&*)のうち少なくとも 3 種類を使用し、!は避けてください
1.1 NAT ゲートウェイを確認/作成する
重要: Supabase のパブリック接続には、VPC 内の SNAT ルールを持つ NAT ゲートウェイが必要です。
# Check existing NAT Gateways in VPC
aliyun vpc describe-nat-gateways --profile adbpg \
--biz-region-id <RegionId> --vpc-id <VpcId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
TotalCount > 0で、SNAT エントリが VSwitch の CIDR をカバーしている場合 → ステップ 1.2 に進む- NAT ゲートウェイがない場合 → ユーザーの確認を得てから、次を実行します。
# 1.1a: Get VSwitch CIDR
aliyun vpc describe-vswitch-attributes --profile adbpg \
--biz-region-id <RegionId> --vswitch-id <VSwitchId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# Record: CidrBlock
# 1.1b: Create Enhanced NAT Gateway (requires user confirmation)
# 💰 Cost note: NAT Gateway incurs hourly charges
aliyun vpc create-nat-gateway --profile adbpg \
--biz-region-id <RegionId> --vpc-id <VpcId> --vswitch-id <VSwitchId> \
--nat-type Enhanced \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# Record: NatGatewayId and SnatTableIds.SnatTableId[0]
# Poll until Status=Available
# 1.1c: Find or allocate EIP (requires user confirmation)
# 💰 Cost note: EIP incurs charges; release via VPC console when no longer needed
aliyun vpc describe-eip-addresses --profile adbpg \
--biz-region-id <RegionId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# If no available EIP:
aliyun vpc allocate-eip-address --profile adbpg \
--biz-region-id <RegionId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# Record: AllocationId and EipAddress
# 1.1d: Bindind EIP to NAT Gateway (requires user confirmation)
aliyun vpc associate-eip-address --profile adbpg \
--biz-region-id <RegionId> \
--allocation-id <EIP-AllocationId> --instance-id <NatGatewayId> \
--instance-type Nat \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# 1.1e: Create SNAT entry (requires user confirmation)
aliyun vpc create-snat-entry --profile adbpg \
--biz-region-id <RegionId> \
--snat-table-id <SnatTableId> \
--source-cidr "<VSwitch-CidrBlock>" --snat-ip "<EipAddress>" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
1.2 Supabase プロジェクトを作成する
aliyun gpdb create-supabase-project --profile adbpg \
--biz-region-id <RegionId> --zone-id <ZoneId> \
--project-name <ProjectName> --account-password '<AccountPassword>' \
--security-ip-list "127.0.0.1" --vpc-id <VpcId> --vswitch-id <VSwitchId> \
--project-spec 2C4G --storage-size 20 --pay-type Postpaid \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
記録する情報: ProjectId(sbp-xxx)、PublicConnectUrl、API キー(安全に保管し、ログに API キー全体を出力しないでください)
タイムアウト: Supabase プロジェクトの作成には 5~10 分かかります。ステータスが
runningになるまでポーリングします。aliyun gpdb get-supabase-project --profile adbpg \ --biz-region-id <RegionId> --project-id <ProjectId> \ --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
Statusフィールドを確認します。Status=runningになるまで 30 秒ごとに再試行します。
ステップ 2:コーチングプラットフォームのデータベースを初期化する
注: ステップ 2~3 は Supabase プロジェクトで実行し、ステップ 4~8 は ADBPG インスタンスで実行します。これらは独立しています。
許可リストを変更してから、psql で接続し、references/database-schema.md のスキーマを実行します。
# Ask user for whitelist IP (do NOT use curl to external services)
# Example: "Please provide the IP address to add to the whitelist"
# Set whitelist
aliyun gpdb modify-supabase-project-security-ips --profile adbpg \
--biz-region-id <RegionId> --project-id <ProjectId> \
--security-ip-list "<WhitelistIP>" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
ステップ 3:コーチング分野のプリセットを挿入する
psql を使用して references/database-schema.md の SQL を実行し、コーチング分野とコーチングペルソナを挿入します。
ステップ 4:ADBPG インスタンスを検出/選択/作成する
4.1 既存のインスタンスを検出する
aliyun gpdb describe-db-instances --profile adbpg \
--biz-region-id <RegionId> --page-size 100 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
結果をフィルタリングします:DBInstanceStatus=Running かつ VectorConfigurationStatus=enabled。
4.2 ユーザーがインスタンスを選択
条件を満たすインスタンスをユーザーに提示します。
利用可能なインスタンス(実行中+ベクトル有効):
# インスタンス ID 仕様 リージョン ステータス 説明 1 gp-xxxxx4C32G cn-hangzhou 実行中 本番環境 2 gp-yyyyy8C64G cn-hangzhou 実行中 テスト インスタンスを選択するか、「Create New」と入力してください。
- ユーザーが既存のインスタンスを選択 → ステップ 4.3 に進みます
- ユーザーが「Create New」を選択 → ステップ 4.4 に進みます
- 条件を満たすインスタンスがない → ユーザーに知らせ、ステップ 4.4 に進みます
4.3 選択したインスタンスを検証(既存のものを使用する場合)
aliyun gpdb describe-db-instance-attribute --profile adbpg \
--db-instance-id <DBInstanceId> --region <RegionId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
確認します:DBInstanceStatus=Running と VectorConfigurationStatus=enabled。その後、ステップ 5 に進みます。
4.4 新しいインスタンスを作成(既存のものがない場合、またはユーザーが新規作成を選択した場合)
実行前に、構成を提示してユーザーの確認を得る必要があります:
💰 費用に関する注意: インスタンスの作成には料金が発生します。使用しないときは、ADBPG コンソールから解放または一時停止してください。
| 構成 | デフォルト | 備考 |
|---|---|---|
| RegionId | cn-hangzhou | ユーザー指定 |
| ZoneId | cn-hangzhou-j | 選択後に VPC/VSwitch を自動照会 |
| EngineVersion | 7.0 | |
| DBInstanceMode | StorageElastic | ストレージ弾性モード |
| DBInstanceCategory | Basic | デフォルトは Basic。オプションで HighAvailability |
| InstanceSpec | 4C16G | Basic:4C16G/8C32G/16C64G。HA:4C32G/8C64G/16C128G |
| SegNodeNum | 2 | Basic のデフォルトは 2(2 の倍数)。HA のデフォルトは 4(4 の倍数) |
| StorageSize | 50 GB | 範囲:50~8000 GB |
| SegStorageType | cloud_essd | ESSD クラウドディスク |
| VPC/VSwitch | 自動検出 | 利用可能な IP が最も多い VSwitch を選択 |
| VectorConfigurationStatus | enabled | AI コーチングには有効化が必須です |
| PayType | Postpaid | 従量課金。オプションで Prepaid |
ゾーンの VSwitch 一覧を照会します:
aliyun vpc describe-vswitches --profile adbpg \
--biz-region-id <RegionId> --zone-id <ZoneId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
VSwitch の候補をユーザーに提示し、利用可能な IP が最も多いものを推奨します。
ユーザーの確認後:
aliyun gpdb create-db-instance --profile adbpg \
--biz-region-id <RegionId> --zone-id <ZoneId> \
--engine gpdb --engine-version "7.0" \
--db-instance-mode StorageElastic --db-instance-category Basic \
--instance-spec 4C16G --seg-node-num 2 \
--storage-size 50 --seg-storage-type cloud_essd \
--vpc-id <VpcId> --vswitch-id <VSwitchId> \
--vector-configuration-status enabled --pay-type Postpaid \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
タイムアウト: インスタンスの作成には 10~15 分 かかります(最大 30 分)。30~60 秒ごとにポーリングします:
aliyun gpdb describe-db-instance-attribute --profile adbpg \ --db-instance-id <DBInstanceId> --region <RegionId> \ --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
DBInstanceStatus=Runningになるまで待ちます。
ステップ 5:データベースアカウントの構成
ADBPG インスタンスにデータベースアカウントがすでに存在するか確認します。
aliyun gpdb describe-accounts --profile adbpg \
--db-instance-id <DBInstanceId> \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
ケース A:既存のアカウントがない → 新しいアカウントを作成します:
アカウントの作成を提案し、実行前にユーザーの確認を得てください:
- アカウント名:
ai_coaching_XXを自動生成(XX はランダムな 2 桁の数字)するか、ユーザー指定の名前を使用します- パスワード:準拠するパスワード(8~32 文字、少なくとも 3 種類の文字を使用し、
!は避ける)を自動生成するか、ユーザー指定のものを使用します- 例:
Account: ai_coaching_01, Password: Coach3Acc#2x9K— 確認するか、ご自身の値を入力してください。⚠️ 重要:
- 作成後にアカウント名を変更することはできません — 慎重に確認してください!
- パスワードはコンソールからリセットできますが、今すぐ安全な場所に保存してください。
- このアカウントは、ステップ 6 で
ManagerAccountとして使用します。
aliyun gpdb create-account --profile adbpg \
--db-instance-id <DBInstanceId> --region <RegionId> \
--account-name <ManagerAccount> --account-password '<ManagerAccountPassword>' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
ケース B:アカウントがすでに存在する → ユーザーに知らせます。エージェントが作成したアカウントではない場合は、ステップ 6 に進む前に既存アカウントのパスワードをユーザーに尋ねてください。
記録:
ManagerAccountとManagerAccountPassword— ナレッジベースの初期化のため、ステップ 6 で使用します。
ステップ 6:ナレッジベースを作成する
このステップで確認するパラメーター: 以下の項目を自動生成してユーザーに提示し、確認します(ユーザーは変更できます)。その後、実行します。
パラメーター デフォルト 備考 Namespacens_coachingNamespace 名。作成後は変更できません NamespacePassword自動生成 Namespace のパスワード(同じパスワードルールが適用されます)。アップロードとコーチングセッションに必要です Collectioncoaching_knowledgeナレッジベース名 EmbeddingModeltext-embedding-v4埋め込みモデル
Step 5 の
ManagerAccountとManagerAccountPasswordを使用し、ユーザーが上記のパラメーターを確認した後、次を実行します。
# Initialize vector database
aliyun gpdb init-vector-database --profile adbpg \
--biz-region-id <RegionId> --db-instance-id <DBInstanceId> \
--manager-account <ManagerAccount> --manager-account-password '<ManagerAccountPassword>' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# Create namespace
aliyun gpdb create-namespace --profile adbpg \
--biz-region-id <RegionId> --db-instance-id <DBInstanceId> \
--manager-account <ManagerAccount> --manager-account-password '<ManagerAccountPassword>' \
--namespace <Namespace> --namespace-password '<NamespacePassword>' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
# Create document collection
aliyun gpdb create-document-collection --profile adbpg \
--biz-region-id <RegionId> --db-instance-id <DBInstanceId> \
--manager-account <ManagerAccount> --manager-account-password '<ManagerAccountPassword>' \
--namespace <Namespace> --collection <Collection> \
--embedding-model <EmbeddingModel> --dimension 1024 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
ステップ 7(任意):ドメイン知識のドキュメントをアップロードする
ドメイン知識のドキュメント(PDF/TXT/Markdown など)がある場合は、ナレッジベースにアップロードするとコーチングの質を高められます。このステップは省略できます。ステップ 8 に進み、コーチングを開始してください。
aliyun gpdb upload-document-async --profile adbpg \
--biz-region-id <RegionId> --db-instance-id <DBInstanceId> \
--namespace <Namespace> --namespace-password '<NamespacePassword>' \
--collection <Collection> --file-name "domain_knowledge.pdf" \
--file-url "https://example.com/knowledge.pdf" \
--document-loader-name ADBPGLoader --chunk-size 500 --chunk-overlap 50 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
シナリオ別の推奨ドキュメント: 営業手法、プロセスガイド(ワークフロー);アーキテクチャパターン、設計ドキュメント(意思決定支援);コミュニケーションフレームワーク、ベストプラクティス(スキル開発);技術スタックのドキュメント、オンボーディングガイド(オンボーディング)。
ステップ 8:コーチングセッションを開始する
このステップの任意のパラメーター:
パラメーター デフォルト 備考 Modelqwen-maxLLM モデル。日々の練習には qwen-turboを使用します(低コスト)TopK5RAG の検索件数
注:
SourceCollection要素には 必ずNamespaceフィールドを含めてください。
aliyun gpdb chat-with-knowledge-base --profile adbpg \
--biz-region-id <RegionId> --db-instance-id <DBInstanceId> \
--model-params '{"Model": "<Model>", "Messages": [
{"Role": "system", "Content": "<system_prompt from coaching_personas>"},
{"Role": "user", "Content": "<learner message>"}
]}' \
--knowledge-params '{"SourceCollection": [{
"Collection": "<Collection>", "Namespace": "<Namespace>",
"NamespacePassword": "<NamespacePassword>", "QueryParams": {"TopK": <TopK>}
}]}' \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-postgresql-ai-coaching-best-practice
シナリオ別クイックリファレンス
| シナリオ | フロー |
|---|---|
| ワークフローコーチング | sales_workflow_coach をクエリ → コーチングペルソナとプロセス KB を注入 → 営業の各段階を学習者が進められるよう支援 → セッションを記録 |
| 意思決定支援 | architecture_advisor をクエリ → コーチングペルソナと技術 KB を注入 → トレードオフ分析を支援 → 意思決定を記録 |
| スキル開発 | communication_coach をクエリ → コーチングペルソナとベストプラクティス KB を注入 → シナリオを練習 → フィードバックを提供 |
| オンボーディング | onboarding_mentor をクエリ → コーチングペルソナと技術ドキュメント KB を注入 → 段階的に学習 → 理解度を確認 |
成功の確認
詳細な確認手順については、references/verification-method.md を参照してください。
簡易確認:
- Supabase プロジェクトが存在し、
Runningになっている - ADBPG インスタンスの
VectorConfigurationStatus=enabled - データベーステーブル(coaching_domains、coaching_personas、learners、coaching_sessions)が存在する
- プリセットのコーチングドメインをクエリできる
ChatWithKnowledgeBaseが有意義なコーチング応答を返す
ベストプラクティス
- データには Supabase、AI には KB を使用 — セッション記録は Supabase に保存し、コーチングの対話には RAG を使用します
- コーチングペルソナが鍵 —
system_promptの品質がコーチングの効果を左右します - セッション記録は必ず保存 — レビューと改善のため、コーチングの各ラウンドを記録します
- すべての操作で
--profile adbpgを使用 — 認証情報を一貫して管理します - Namespace でチームを分離 — チームごとに異なる
Namespaceを使用します - TopK の推奨値:5 — トークン消費を抑えます
- 日々の練習:qwen-turbo(低コスト)、評価:qwen-max(高品質)
- 書き込み操作は冪等にする — リソースの作成(CreateSupabaseProject、CreateDBInstance、CreateAccount、CreateNamespace など)の前に、必ず先にクエリ(Describe/List)して、リソースがすでに存在するか確認します。リソースが存在しない場合にのみ作成します。これにより、再試行時のリソース重複を防止できます
参考資料
| ドキュメント | 説明 |
|---|---|
| references/cli-installation-guide.md | Aliyun CLI のインストール |
| references/related-apis.md | 使用する CLI コマンドと API の一覧 |
| references/ram-policies.md | 必要な RAM 権限 |
| references/database-schema.md | SQL スキーマとコーチング分野のプリセット |
| references/acceptance-criteria.md | 正しいパターンと誤ったパターン |
| references/verification-method.md | 成功を確認する手順 |