mcpField
A
add-provider

add-provider

github.com/bolna-aiエージェントワークフロー366 回インストール3 日前に更新
リポジトリ

add-provider について

Bolnaの音声エージェント向けにプロバイダーを設定するスキルです。LLM、文字起こし、音声、電話サービスの認証情報の追加・一覧表示・削除と、安全な設定やテスト手順を扱います。

主な機能

  1. 01プロバイダー認証情報の追加
  2. 02設定済みプロバイダーの一覧表示
  3. 03プロバイダー認証情報の削除
  4. 04LLM・文字起こし・音声・電話プロバイダーに対応
  5. 05安全な設定とテストの手順

活用シーン

  1. 01BolnaエージェントにLLMや音声サービスを設定
  2. 02エージェント設定用のプロバイダーIDを取得
  3. 03不要になった認証情報を確認後に削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bolna-ai/skills --skill add-provider

インストール後、Claude Code で/add-providerを入力して読み込まれたか確認します。

同梱ファイルscripts/add_provider.py

詳細

Bolna プロバイダーを追加する

エンドポイント

  • プロバイダーを追加：POST https://api.bolna.ai/providers
  • プロバイダーを一覧表示：GET https://api.bolna.ai/providers
  • プロバイダーを削除：DELETE https://api.bolna.ai/providers/{provider_key_name}

Authorization: Bearer $BOLNA_API_KEY を使用します。追加時は Content-Type: application/json を使用します。

プロバイダーのカテゴリ

  • テレフォニー：Twilio、Plivo、Exotel、Vobiz、SIP トランキング、およびその他の対応している通話プロバイダー。
  • LLM：OpenAI、Azure OpenAI、Anthropic、OpenRouter、DeepSeek、LiteLLM 互換のカスタムモデル。
  • 文字起こし：Deepgram、Sarvam、AssemblyAI、Azure、ElevenLabs Scribe、Gladia、Pixa。
  • 音声／TTS：ElevenLabs、Cartesia、Deepgram、Azure TTS、AWS Polly、Rime、Sarvam、Smallest。

プロバイダーのスキーマは変更されることがあるため、正確な認証情報フィールドを選ぶ前に、Bolna の最新のプロバイダードキュメントを確認してください。

安全なワークフロー

  1. プロバイダーの種類と正確なプロバイダー名を特定します。
  2. 認証情報が存在することをユーザーに確認します。
  3. シークレットをコミット対象のファイルに貼り付けないでください。
  4. API またはダッシュボードからプロバイダーを追加します。
  5. プロバイダーを一覧表示し、返されたプロバイダー ID を取得します。
  6. Bolna のドキュメントに従って、エージェントの設定でプロバイダー ID またはプロバイダー名を使用します。
  7. 本番のバッチ処理に展開する前に、ドライラン用のエージェントまたは通話でテストします。

プロバイダー追加時の形式

Bolna はプロバイダーの認証情報を名前付きキーとして保存します。Bolna が期待するプロバイダーキー名を使用し、その後にシークレット値を指定します。

{
  "provider_name": "OPENAI",
  "provider_value": "sk-0123456789az"
}

一般的なプロバイダーキー名は、OpenAI、Anthropic、ElevenLabs、Deepgram、Sarvam、Cartesia の API キーや、Twilio、Plivo、Exotel、Vobiz のテレフォニー認証情報など、該当するインテグレーションに対応しています。新しいキー名を追加する前に、Bolna の最新のプロバイダーページを確認してください。

curl --request POST \
  --url https://api.bolna.ai/providers \
  --header "Authorization: Bearer $BOLNA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "provider_name": "OPENAI",
    "provider_value": "sk-0123456789az"
  }'

プロバイダーの一覧表示

curl --request GET \
  --url https://api.bolna.ai/providers \
  --header "Authorization: Bearer $BOLNA_API_KEY"

プロバイダーの削除

curl --request DELETE \
  --url "https://api.bolna.ai/providers/$PROVIDER_KEY_NAME" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

削除する前に確認してください。設定されているプロバイダーキーを削除すると、既存のエージェントが動作しなくなる場合があります。

一般的な認証情報のキー名

プロバイダープロパティ
OpenAIOPENAI
OpenRouterOPENROUTER
Google GeminiGOOGLE
Azure OpenAIAZURE_OPENAI_API_KEY, AZURE_OPENAI_MODEL, AZURE_OPENAI_API_BASE, AZURE_OPENAI_API_VERSION
ElevenLabsELEVENLABS
CartesiaCARTESIA
SarvamSARVAM
SmallestSMALLEST
DeepgramDEEPGRAM
TwilioTWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER
PlivoPLIVO_AUTH_ID, PLIVO_AUTH_TOKEN, PLIVO_PHONE_NUMBER
VobizVOBIZ_AUTH_ID, VOBIZ_AUTH_TOKEN, VOBIZ_PHONE_NUMBER
ExotelEXOTEL_API_KEY, EXOTEL_API_TOKEN, EXOTEL_ACCOUNT_SID, EXOTEL_DOMAIN, EXOTEL_PHONE_NUMBER, EXOTEL_OUTBOUND_APP_ID, EXOTEL_INBOUND_APP_ID
カスタム LLMエージェントの llm_agent で provider: "custom" を使用し、OpenAI 互換の base_url を指定してから、POST /user/model/custom でモデル名を登録します。

プロバイダーごとの完全な一覧（各プロバイダーに適した言語／ユースケースを含む）は、https://raw.githubusercontent.com/bolna-ai/skills/main/references/providers-matrix.md にあります。

関連項目

  • https://raw.githubusercontent.com/bolna-ai/skills/main/references/providers-matrix.md — レイテンシの目安、対応言語、一般的な組み合わせ。
  • setup-sip-trunk — SIP トランクプロバイダー（エンドポイントが異なり、認証情報保管庫ではありません）。
  • create-agent — プロバイダー名を llm_agent、synthesizer、transcriber に設定する方法。

コメント

Markdown 対応