Skip to main content

​
Vercel

Shanoneのvercel連携は、プロジェクト、デプロイ、ドメイン/DNS、環境変数、Edge Config、キャッシュ、チーム/セキュリティ管理まで、デプロイライフサイクル全体をカバーする107個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにVercel関連の作業を依頼(例: 「Vercelのプロジェクト一覧を見せて」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Sign in with Vercelで許可する

Shanoneに操作させたいチーム/アカウントについて、VercelのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、vercel_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

Shanoneはvercel向けに107個のツールを、以下のカテゴリに整理して提供しています。
vercel_list_projects, vercel_get_project, vercel_create_project, vercel_delete_project, vercel_update_project, vercel_pause_project, vercel_unpause_project, vercel_list_project_domains, vercel_add_project_domain
vercel_list_deployments, vercel_get_deployment, vercel_cancel_deployment, vercel_redeploy, vercel_get_deployment_events, vercel_get_deployment_logs, vercel_promote_deployment, vercel_list_deployment_files, vercel_get_deployment_file_contents, vercel_create_deployment, vercel_delete_deployment, vercel_get_deployments_extended, vercel_get_promote_aliases
vercel_list_edge_configs, vercel_get_edge_config, vercel_create_edge_config, vercel_delete_edge_config, vercel_get_edge_config_items, vercel_update_edge_config_items, vercel_create_edge_config_token, vercel_list_edge_config_tokens, vercel_get_edge_config_token, vercel_delete_edge_config_tokens, vercel_get_edge_config_item, vercel_list_edge_config_backups, vercel_get_edge_config_schema, vercel_update_edge_config_schema
vercel_check_domain_availability, vercel_get_bulk_domain_availability, vercel_buy_domain, vercel_buy_domains, vercel_list_supported_tlds, vercel_get_tld_info, vercel_get_tld_price, vercel_get_domain_price
vercel_check_cache_artifact_exists, vercel_get_cache_status, vercel_get_artifact_info, vercel_delete_all_cache_artifacts, vercel_record_cache_event, vercel_invalidate_cache_by_tags, vercel_delete_cache_by_tags, vercel_invalidate_cache_by_image
vercel_list_env_vars, vercel_create_env_var, vercel_delete_env_var, vercel_update_env_var, vercel_list_shared_env_vars, vercel_create_shared_env_var, vercel_delete_shared_env_var
vercel_get_rolling_release, vercel_get_rolling_release_config, vercel_update_rolling_release_config, vercel_start_rolling_release, vercel_complete_rolling_release, vercel_abort_rolling_release, vercel_approve_rolling_release_stage
vercel_create_auth_token, vercel_get_auth_token, vercel_delete_auth_token, vercel_list_auth_tokens, vercel_get_authenticated_user
vercel_list_dns_records, vercel_create_dns_record, vercel_update_dns_record, vercel_delete_dns_record
vercel_list_domains, vercel_get_domain, vercel_add_domain, vercel_remove_domain
vercel_list_log_drains, vercel_get_log_drain, vercel_create_log_drain, vercel_delete_log_drain, vercel_list_integration_log_drains
vercel_list_team_members, vercel_list_project_members, vercel_get_team, vercel_update_team
vercel_get_attack_status, vercel_update_attack_mode, vercel_get_firewall_config, vercel_list_firewall_events
vercel_list_webhooks, vercel_get_webhook, vercel_create_webhook, vercel_delete_webhook
vercel_list_deployment_checks, vercel_get_deployment_build_logs, vercel_get_runtime_logs
vercel_list_aliases, vercel_list_deployment_aliases, vercel_assign_alias, vercel_delete_alias
vercel_get_user, vercel_list_teams, vercel_list_git_namespaces, vercel_search_git_repositories

​
よくあるユースケース

デプロイのトリアージ

最近のデプロイを一覧し、ビルド/実行ログを取得して失敗したビルドを調査する

新規プロジェクトの環境構築

プロジェクトを作成し、環境変数を設定してカスタムドメインを追加する

段階的なロールアウト

ローリングリリースを開始し、各ステージを監視して指標に基づき承認または中止する

ドメイン・DNS管理

ドメインの空き状況を確認・購入し、プロジェクトのDNSレコードを設定する

​
トラブルシューティング

プロジェクト/ドメイン/チーム系ツールの多くは、接続中のVercelアカウントが所属するチームに対して操作します。権限バグと決めつける前に、vercel_list_teamsとvercel_get_teamで正しいチームコンテキストを確認してください。
どちらも暗黙的に「最新の」デプロイを対象にするのではなく、特定のデプロイIDに対して操作します — まずvercel_list_deploymentsを呼び出し、意図したデプロイを対象にしているか確認してください。
Edge Configの読み取りは高速だが結果整合性のあるエッジキャッシュから提供されます。vercel_update_edge_config_itemsの変更がvercel_get_edge_config_itemsにグローバルに反映されるまで、短い伝播時間がかかることがあります。
VercelのOAuthトークンは有効期間が短めです。認証エラーで呼び出しが失敗した場合は、トークンが永続的だと考えるのではなく連携画面から再接続してください。