OpenAIアカウントをHubSpotに接続(ベータ)

「 OpenAIに質問」や「 OpenAIにアシスタントに聞く」などのAIを利用したワークフローアクションを使用する際にOpenAIとHubSpotを接続して、自分のOpenAIアカウントを使用できます。アプリは、アプリマーケットプレイスまたは ワークフロー内から接続できます。 

その後、これらのアクションからの出力を、通知の送信やタスクの作成などの他のワークフローアクションで使用できます。たとえば、登録されたレコードを集計するプロンプトを入力できます。次に、このサマリーを営業担当に送信するアクションを追加します。

始める前に

OpenAIアカウントを接続する際は、以下の点にご注意ください。

• OpenAIアカウントを接続すると、独自のOpenAIサブスクリプションを利用できるようになります。
  • APIの使用についてOpenAIから直接請求させていただきます。 
  • OpenAI連携を使用する場合、モデルの選択、推論の労力、および選択した温度は、従量課金制の価格に影響を与える可能性があります。OpenAIのAPIの価格とパッケージングの詳細をご確認ください。 
• 各HubSpotアカウントに接続できるOpenAIは 1つの みです。 
• OpenAIアカウントの管理者である場合は、[ OpenAIに質問 ]アクションまたは [OpenAI アシスタントに 質問]アクションを使用してワークフローを作成するときに、ユーザーが使用できるモデルを選択できます。OpenAIのモデルアクセスを更新し、API使用量の制限を設定する方法をご確認ください。 

OpenAIアカウントを接続

• OpenAIにアクセスします。次に、サインアップするか、アカウントにログインします。 
• APIキーを取得します。
  
  • 既存のプロジェクトの場合は、API を使用する ために必要なアクセス許可 があることを確認します。 
  • 新しいプロジェクトを作成し、対応するAPIキーを生成できるのは組織の所有者のみであり、 OpenAIアカウントのさまざまなロールと権限の詳細を確認してください。
  • APIキーがまだ有効であり、有効期限が切れていないことを確認してください。 

注:APIキーはOpenAIインスタンスへのアクセスを提供するため、安全に保管する必要があります。

OpenAIアカウントを接続

• HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコンmarketplaceをクリックし、［アプリマーケットプレイス］を選択します。
• OpenAI連携を探して選択します。 
• 右上の［アプリをインストール］をクリックします。次に、手順に従ってアカウントを接続します。 
• ダイアログボックスで APIキー を入力します。 
• [ 接続] をクリックして AI を開きます。
  • OpenAIアカウントを接続すると、OpenAIモデルがHubSpotワークフロー内で使用できるようになります。 
  • 「Breeze に尋ねる」ワークフロー アクションなどのアクションを使用する場合は、OpenAI アカウント内からモデルとモデルの使用制限を設定します。OpenAIのAPIプラットフォームでのプロジェクト管理についての詳細をご確認ください。
     

接続済みのOpenAIアカウントを管理

使用している OpenAI APIキーを切り替えたり、OpenAI アカウントを接続解除したりするには: 

• HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。左側のサイドバーメニューで、［連携］＞［接続されたアプリ］の順に進みます。
• [AI を開く] を検索してクリックします。 
• 上部にある[ 接続を管理]をクリックします。
• 使用する APIキーを変更するには、[ API キーの切り替え] をクリックします。 
• OpenAIとの連携を接続解除するには、[ 接続解除]をクリックします。次に、 [ 切断] を選択します。 

「OpenAIに質問 」ワークフローアクションを使用する

OpenAIにプロンプトを送信し、登録されたレコードのデータを分析、要約、分類するには、このアクションを使用します。

• HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
• 既存のワークフローの名前をクリックするか、新しいワークフローを作成します。
• 登録トリガーを設定します。
• ［＋］プラスアイコンをクリックしてアクションを追加します。
• 左側のパネルで、[ OpenAIとの連携 ]セクションをクリックして展開します。次に、[ OpenAIに聞く]をクリックします。 
• [プロンプト メッセージ] フィールドに、プロンプトを入力します。データ パネルから プロパティー を使用することもできます。 
• [ 高度なAPI設定 ]セクションをクリックして展開します。次に、次のように構成します。 
  • モデルの選択: API呼び出しに使用されるOpenAIモデル。モデルが選択されていない場合は、アシスタント定義のモデルが使用されます。
  • 推論の努力: 推論の努力。「高」、「中」、「低」から選択できます。値が大きいほど、応答はより詳細になりますが、生成に時間がかかる場合があります。
  • 温度: 生成されるテキストのランダム性。値が小さいほど応答が予測しやすくなり、値が大きいほど反応が独創的になります。

• 上部にある[ 保存]をクリックします。
   

「OpenAIアシスタントに質問 」ワークフローアクションを使用する

• HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
• 既存のワークフローの名前をクリックするか、新しいワークフローを作成します。
• 登録トリガーを設定します。
• ［＋］プラスアイコンをクリックしてアクションを追加します。
• 左側のパネルで、[ OpenAIとの連携 ]セクションをクリックして展開します。次に、[ OpenAIアシスタントに聞く]をクリックします。 
• [ アシスタントの選択 ]ドロップダウンメニューをクリックし、使用する AIアシスタント を選択します。こちらは、OpenAIアカウントで利用できるアシスタントです。 
• [ 高度なAPI設定 ]セクションをクリックして展開します。次に、次のように構成します。 
  • モデルの選択: API呼び出しに使用されるOpenAIモデル。モデルが選択されていない場合は、アシスタント定義のモデルが使用されます。
  • 温度: 生成されるテキストのランダム性。値が小さいほど応答が予測しやすくなり、値が大きいほど反応が独創的になります。
• 上部にある[ 保存]をクリックします。
   

出力を他のワークフローアクションで使用する

「OpenAIに聞く」または「OpenAIにアシスタントに尋ねる」アクションをワークフローに追加すると、生成された出力をデータパネルが使用されている 他のワークフローアクション で使用できます。 

• HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
• 既存のワークフローの名前をクリックするか、新しいワークフローを作成します。
• 「OpenAIに聞く」または「OpenAIにアシスタントに聞く」アクションを設定します。
• 「+」プラスアイコンをクリックしてアクションを追加します。次に、ワークフローアクションを選択します。 
• [ データ変数を選択]パネルで、[次からプロパティーまたはアクション出力を表示] ドロップダウンメニューをクリックし、[ アクション出力]を選択します。 
• [ OpenAIに聞く] または [OpenAIにアシスタントに聞く]セクションをクリックして展開し、[ 応答]を選択します。 
• ワークフローアクションの設定を続行します。
   

使用例

以下の例は、ワークフローで 「OpenAIに聞く」 アクションと 「OpenAIアシスタントに聞く」アクションを使用して、より複雑なプロセスを自動化するさまざまな方法を示しています。

• 訪問者を選別する: 「OpenAIに質問」または 「OpenAIに尋ねる」アシスタントアクションを使用して、フォームやアンケートで訪問者から提供されたフリーテキスト情報を分析し、関心を判断します。次に、最も見込みありのリードを最初にフォローアップするようアカウント内のユーザーに通知します。
• レコードデータをフォーマットする: 「OpenAIに質問」または「OpenAIにアシスタントに質問」アクションを使用して、アカウント内のデータをフォーマットします。データが異なる形式で入力または送信されている場合は、「 Breezeに尋ねる 」アクションを使用して、値を特定の形式に標準化できます。例えば、 州内のさまざまな値を 2 文字の略語に書式設定できますプロパティー。 
• セールスイネーブルメント用のEメールの下書き:セールスイネーブルメントのために 「OpenAIに質問」または 「OpenAIに尋ねる」アシスタントアクションを使用します。レコード内の特定のプロパティーに基づいてアプローチEメールを下書きするプロンプトを入力できます。次に、Eメールを関連付けられたタスクレコードに保存し、このEメールを確認して送信する営業担当を割り当てる。