メインコンテンツへ移動

オートノマス連携（Autonomous Integration）

基本AI機能の概要​

基本AI機能には、以下が含まれます。

  • ワークシート項目の提案
  • カスタムワークシート項目の追加
  • ワークフロープログラム（コードブロック）の自動生成
  • 多言語インテリジェント翻訳

HAPの基本AI機能は、デフォルトでOpenAIのChatCompletion APIを利用します。 OpenAI APIの基本情報は以下の通りです。

デフォルトではOpenAI ChatCompletion APIを使用しますが、オートノマス連携モードでは、OpenAIと互換性のあるサードパーティAPIに置き換えることも可能です。

1. OpenAI互換のサードパーティAPI連携​

一般的な設定方法​

設定パス： プラットフォーム管理 > サービス連携 > AIサービス > 基本AI機能

「オートノマス連携」タイプを選択し、下記イメージのように関連パラメーターを設定します。

パラメーター説明

パラメーター説明例
リクエストURLOpenAI互換のサードパーティサービスにより提供される完全なAPIパス。注意：サーバーとインターフェース間のネットワーク接続が安定していることを確認してください。https://api.deepseek.com/v1/chat/completions
モデル名サービスプロバイダーより指定されたモデル識別子を入力してください。deepseek-chat
keyサードパーティサービスが提供するアクセストークンを入力してください。sk-********************************

DeepSeek連携例​

パラメーター例
リクエストURLhttps://api.deepseek.com/v1/chat/completions
モデル名deepseek-chat
keyDeepSeekコンソールで取得したAPIキー

アリババクラウド百煉（Bailian）プラットフォーム連携例​

パラメーター例
リクエストURLhttps://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
モデル名qwen-plus
keyAlibaba Cloud Bailianコンソールで取得したAPIキー

Ollamaローカル大規模モデル連携例​

パラメーター例
リクエストURL通常は {host}/v1/chat/completions例：http://192.168.10.154:11434/v1/chat/completions
モデル名deepseek-r1:32b
keyインターフェース認証用のキーを入力してください。認証不要な場合は任意の非空文字列（例：example-key）を入力します。注意：キー認証はリクエスト正当性を検証するためのため、セキュリティの観点より正確なキーを設定することを推奨します。

2. OpenAI互換APIの自社実装​

開発者はOpenAI ChatCompletion APIの入出力形式と一致する自社APIを構築する必要があります。その後、オートノマス連携モードにてカスタムAPIを設定し、OpenAIと同一の入出力仕様を維持してください。

リクエストヘッダー​

HAPからOpenAIへリクエストを送信する際は、以下のAuthorizationヘッダーが必要です。

Authorization: Bearer $API_KEY

リクエストボディ​

HAPがOpenAIへ送信するリクエストボディでは以下のパラメーターが利用されます。

{
  "model": "gpt-4o-mini", // モデル名
  "messages": [
    {
      "role": "developer", // ロール
      "content": "You are a helpful assistant." // 内容
    }
  ],
  "temperature": 1, // 生成テキストのランダム性。値が高いほどランダム度が上がります。
  "top_p": 1, // コア確率の閾値。テキスト多様性の制御。
  "frequency_penalty": 0, // 同一単語の繰り返しをペナルティ化し、繰り返しを抑制。
  "presence_penalty": 0, // 新出単語をペナルティ化し、新語出力を促進。
  "stream": false // ストリーミングを利用するか。
}

レスポンス仕様​

HAPはOpenAIのレスポンスから以下の値のみを利用します。

  • streamがfalseの場合：
{
  "choices": [
    {
      "message": {
        "content": "全出力テキスト"
      }
    }
  ]
}
  • streamがtrueの場合：
{
  "choices": [
    {
      "delta": {
        "content": "出力テキストの一部"
      }
    }
  ]
}

サンプルコード​

Baidu AIに基づくサンプルコードを参照してください。

カスタムOpenAI互換APIの連携手順​

API開発・デプロイ後、HAPの プラットフォーム管理 > サービス連携 > AIサービス > 基本AI機能 にて、タイプをオートノマス連携に設定し、リクエストURL・モデル名・Keyを、下記イメージ通り登録してください。