Oracle Cloud Infrastructureドキュメント

生成AIエージェントでのカスタム関数呼出しツールの作成

生成AIエージェントでは、各エージェントに1つ以上のツールが必要です。エージェントの作成中または作成後にエージェントのツールを作成できます。どちらのオプションでも、ツールの作成手順は同じです。この項では、ファンクション・コール・ツールを作成するステップを示します。

関数呼び出しツールの作成

  1. 「ツールの作成」を選択します。
  2. 「カスタム・ツール」を選択します。
  3. (オプション)次の情報を入力します:
    • 名前: 文字またはアンダースコアで始まり、その後に文字、数字、ハイフンまたはアンダースコアが続くカスタム・ツールの名前。長さは1文字から255文字までです。
    • 説明: 説明(オプション)。
  4. 「ツール構成」で、「ファンクション呼出し」を選択します
  5. 次の情報を入力します。
    • 名前: 文字またはアンダースコアで始まり、その後に文字、数字、ハイフンまたはアンダースコアが続く関数の名前。長さは1文字から255文字までです。
    • 説明: 説明(オプション)。
  6. 「ファンクション・パラメータ」に、ファンクションが受け入れるパラメータをJSON形式で入力します。
    いくつかの例を示します。
    // Get Compute Instance Details
{
            "name": "get_compute_instance_details",
            "description": "Fetch details of an OCI Compute instance given an instance OCID.",
            "parameters": {
                "type": "object",
                "properties": {
                    "instance_ocid": {
                        "type": "string",
                        "description": "The OCID of the compute instance."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the instance."
                    }
                },
                "required": ["instance_ocid"],
                "additionalProperties": false
            }
        }


// Create an Object Storage Bucket
{
            "name": "create_object_storage_bucket",
            "description": "Creates a new bucket in OCI Object Storage within a specified compartment.",
            "parameters": {
                "type": "object",
                "properties": {
                    "bucket_name": {
                        "type": "string",
                        "description": "The name of the bucket to create."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment where the bucket will be created."
                    },
                    "storage_tier": {
                        "type": "string",
                        "enum": ["Standard", "Archive"],
                        "description": "The storage tier for the bucket."
                    }
                },
                "required": ["bucket_name", "compartment_ocid"],
                "additionalProperties": false
            }
        }


// Check Database Service Status
{
            "name": "check_database_status",
            "description": "Checks the operational status of an OCI Autonomous Database instance.",
            "parameters": {
                "type": "object",
                "properties": {
                    "db_ocid": {
                        "type": "string",
                        "description": "The OCID of the database instance."
                    }
                },
                "required": ["db_ocid"],
                "additionalProperties": false
            }
        }

// List Available Load Balancers
{
            "name": "list_load_balancers",
            "description": "Lists all load balancers in the given compartment in OCI.",
            "parameters": {
                "type": "object",
                "properties": {
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the load balancers."
                    }
                },
                "required": ["compartment_ocid"],
                "additionalProperties": false
            }
        }
  7. 「ツールの作成」を選択します。
  8. 「Java SDKを使用したファンクションの設定」のステップを確認します。
ヒント

次のいずれかのアクションを行います:

  • エージェントを作成する場合は、「生成AIエージェントでのエージェントの作成」に戻って、別のツールまたはエンドポイントを作成します。
  • ツールを既存のエージェントに追加した場合、ツールがアクティブになった後、エージェントの詳細ページで「チャットを起動」を選択し、このツールを使用してエージェントとチャットします。
  • エンドポイントなしでエージェントを作成した場合は、エージェントを使用する準備ができたら、このエージェントのエンドポイントを作成します。