Skip to main content

LaunchDarkly

ShanoneのLaunchDarkly連携では、LaunchDarklyの機能管理プラットフォームのほぼ全機能——フラグ、環境、セグメント、実験、AI Config、承認、監査ログ、チーム/ロール管理を扱う76のツールをエージェントが利用できるようになります。

はじめに

1

LaunchDarklyのアクセストークンを発行する

LaunchDarklyアカウントでAccount Settings → Authorizationに移動し、Personal ScoreまたはService Access Tokenを作成します(SDK/Mobileキーは使用できません)。
2

Shanoneに登録する

ShanoneダッシュボードのIntegrationsを開き、LaunchDarklyを選択してアクセストークンを貼り付けます。
3

リクエストを再試行する

保存が完了すると、launchdarkly_*ツールへのshanone_execute_tool呼び出しが成功するようになります。

利用可能なツール

ShanoneはLaunchDarkly用に76のツールを提供しており、以下のカテゴリに分類されています。
launchdarkly_list_feature_flags, launchdarkly_get_feature_flag, launchdarkly_create_feature_flag, launchdarkly_update_feature_flag, launchdarkly_toggle_feature_flag, launchdarkly_delete_feature_flag, launchdarkly_copy_feature_flag, launchdarkly_get_feature_flag_status, launchdarkly_list_feature_flag_statuses, launchdarkly_list_flag_triggers, launchdarkly_create_flag_trigger, launchdarkly_delete_flag_trigger
launchdarkly_list_approval_requests_for_flag, launchdarkly_create_approval_request_for_flag, launchdarkly_review_approval_request_for_flag, launchdarkly_apply_approval_request_for_flag, launchdarkly_delete_approval_request_for_flag, launchdarkly_list_scheduled_changes, launchdarkly_create_scheduled_change
launchdarkly_list_projects, launchdarkly_get_project, launchdarkly_create_project, launchdarkly_update_project, launchdarkly_delete_project, launchdarkly_list_environments, launchdarkly_get_environment, launchdarkly_create_environment, launchdarkly_update_environment, launchdarkly_delete_environment
launchdarkly_list_segments, launchdarkly_get_segment, launchdarkly_create_segment, launchdarkly_update_segment, launchdarkly_delete_segment, launchdarkly_search_contexts, launchdarkly_get_context_attribute_names, launchdarkly_evaluate_context_instance
launchdarkly_list_experiments, launchdarkly_get_experiment, launchdarkly_create_experiment, launchdarkly_list_metrics, launchdarkly_get_metric, launchdarkly_create_metric, launchdarkly_update_metric, launchdarkly_list_holdouts, launchdarkly_create_holdout
launchdarkly_list_ai_configs, launchdarkly_get_ai_config, launchdarkly_create_ai_config, launchdarkly_update_ai_config, launchdarkly_delete_ai_config, launchdarkly_list_ai_config_variations, launchdarkly_create_ai_config_variation, launchdarkly_get_ai_config_variation
launchdarkly_get_deployment_frequency_chart, launchdarkly_get_lead_time_chart, launchdarkly_get_flag_status_chart, launchdarkly_list_audit_log_entries, launchdarkly_get_audit_log_entry, launchdarkly_search_audit_log_entries, launchdarkly_get_audit_log_entry_counts
launchdarkly_list_account_members, launchdarkly_get_account_member, launchdarkly_list_custom_roles, launchdarkly_get_custom_role, launchdarkly_create_custom_role, launchdarkly_list_teams, launchdarkly_get_team, launchdarkly_create_team
launchdarkly_list_webhooks, launchdarkly_get_webhook, launchdarkly_create_webhook, launchdarkly_update_webhook, launchdarkly_delete_webhook, launchdarkly_list_workflows, launchdarkly_create_workflow

よくある使い方

段階的なロールアウト

トラフィックの一部に対してフラグをオンにし、完全展開前にステータスを監視する

キルスイッチ対応

問題のある機能のフラグを複数の環境で即座にオフにする

A/Bテスト分析

実験とメトリクスのデータを取得し、どのバリエーションが優れているかを要約する

コンプライアンス監査

特定のフラグを誰がいつ変更したかを監査ログから検索する

トラブルシューティング

フラグは環境ごとに切り替わります——正しいenvironmentKey(例:productionかstagingか)を指定しているか確認してください。ある環境での切り替えは他の環境には影響しません。
LaunchDarklyのワークスペースによっては、フラグの変更に承認ワークフローが必須な場合があります——直接更新する代わりにlaunchdarkly_create_approval_request_for_flagとlaunchdarkly_review_approval_request_for_flag/launchdarkly_apply_approval_request_for_flagを使用してください。
LaunchDarklyのアクセストークンには特定のロール/権限スコープが設定されています——単一プロジェクトや読み取り専用ロールにスコープされたトークンでは、launchdarkly_create_custom_roleやlaunchdarkly_create_projectのような管理者レベルのツールで失敗します。必要に応じてより広い権限を持つトークンを生成してください。