mcpField
A
alibabacloud-analyticdb-postgresql-ai-coaching-best-practice

alibabacloud-analyticdb-postgresql-ai-coaching-best-practice

github.com/aliyun開発281125 回インストール1 日前に更新
リポジトリ

alibabacloud-analyticdb-postgresql-ai-coaching-best-practice について

Alibaba Cloud 上に AI コーチング基盤を構築するエージェントスキルです。Supabase プロジェクトで構造化されたコーチングデータを管理し、ADBPG ベクトルナレッジベースで RAG 対話を支援します。

主な機能

  1. 01Supabase プロジェクトの作成
  2. 02ADBPG ベクトルナレッジベースの設定
  3. 03構造化コーチングデータの管理
  4. 04RAG によるコーチング対話
  5. 05クラウドリソース設定のガイド

活用シーン

  1. 01営業やプロジェクトの業務フロー指導
  2. 02技術的な選択肢の評価支援
  3. 03コミュニケーションや交渉の練習
  4. 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.md
cli-installation-guide.md
cli-parameter-guide.md
database-schema.md
ram-policies.md
related-apis.md
verification-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

aliyun CLI コマンドを実行するたびに、次のオプションを含める必要があります: --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 ゲートウェイと EIPvpc:DescribeNatGateways、vpc:CreateNatGateway、vpc:DescribeEipAddresses、vpc:AllocateEipAddress、vpc:AssociateEipAddress、vpc:CreateSnatEntry

推奨システムポリシー: AliyunGPDBFullAccess、AliyunVPCFullAccess(NAT がすでに存在する場合は AliyunVPCReadOnlyAccess)

完全なリストは、references/ram-policies.md を参照してください。

[必須] 権限エラーへの対応: 権限エラーが原因でコマンドが失敗した場合:

  1. 必要な権限を確認するため、references/ram-policies.md を読む
  2. ram-permission-diagnose スキルを使用してユーザーを案内する
  3. ユーザーが権限の付与を確認するまで待機する

基本的なワークフロー

ユーザーが「AI コーチングシステムのセットアップを手伝って」などと依頼した場合は、次の手順を実行します。

スマートデフォルトモード:ユーザーが入力する情報は最小限で済みます(例:「北京i」)。エージェントがリージョンを自動解析し、VPC/VSwitch を検出してパスワードを生成したうえで、すべてのパラメーターを提示し、ワンクリックで確認できるようにします。

ステップ 1:Supabase プロジェクトを作成する

このステップで確認するパラメーター:

パラメーターデフォルト備考
RegionId自動解析「北京i」→ cn-beijing、「上海b」→ cn-shanghai、「杭州」→ cn-hangzhou、「深圳」→ cn-shenzhen
ZoneId自動解析「北京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仕様リージョンステータス説明
1gp-xxxxx4C32Gcn-hangzhou実行中本番環境
2gp-yyyyy8C64Gcn-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 コンソールから解放または一時停止してください。

構成デフォルト備考
RegionIdcn-hangzhouユーザー指定
ZoneIdcn-hangzhou-j選択後に VPC/VSwitch を自動照会
EngineVersion7.0
DBInstanceModeStorageElasticストレージ弾性モード
DBInstanceCategoryBasicデフォルトは Basic。オプションで HighAvailability
InstanceSpec4C16GBasic:4C16G/8C32G/16C64G。HA:4C32G/8C64G/16C128G
SegNodeNum2Basic のデフォルトは 2(2 の倍数)。HA のデフォルトは 4(4 の倍数)
StorageSize50 GB範囲:50~8000 GB
SegStorageTypecloud_essdESSD クラウドディスク
VPC/VSwitch自動検出利用可能な IP が最も多い VSwitch を選択
VectorConfigurationStatusenabledAI コーチングには有効化が必須です
PayTypePostpaid従量課金。オプションで 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 を参照してください。

簡易確認:

  1. Supabase プロジェクトが存在し、Running になっている
  2. ADBPG インスタンスの VectorConfigurationStatus=enabled
  3. データベーステーブル(coaching_domains、coaching_personas、learners、coaching_sessions)が存在する
  4. プリセットのコーチングドメインをクエリできる
  5. ChatWithKnowledgeBase が有意義なコーチング応答を返す

ベストプラクティス

  1. データには Supabase、AI には KB を使用 — セッション記録は Supabase に保存し、コーチングの対話には RAG を使用します
  2. コーチングペルソナが鍵 — system_prompt の品質がコーチングの効果を左右します
  3. セッション記録は必ず保存 — レビューと改善のため、コーチングの各ラウンドを記録します
  4. すべての操作で --profile adbpg を使用 — 認証情報を一貫して管理します
  5. Namespace でチームを分離 — チームごとに異なる Namespace を使用します
  6. TopK の推奨値:5 — トークン消費を抑えます
  7. 日々の練習:qwen-turbo(低コスト)、評価:qwen-max(高品質)
  8. 書き込み操作は冪等にする — リソースの作成(CreateSupabaseProject、CreateDBInstance、CreateAccount、CreateNamespace など)の前に、必ず先にクエリ(Describe/List)して、リソースがすでに存在するか確認します。リソースが存在しない場合にのみ作成します。これにより、再試行時のリソース重複を防止できます

参考資料

ドキュメント説明
references/cli-installation-guide.mdAliyun CLI のインストール
references/related-apis.md使用する CLI コマンドと API の一覧
references/ram-policies.md必要な RAM 権限
references/database-schema.mdSQL スキーマとコーチング分野のプリセット
references/acceptance-criteria.md正しいパターンと誤ったパターン
references/verification-method.md成功を確認する手順

コメント