すべてのプロダクト
Search
ドキュメントセンター

AI Guardrails:人物情報の設定

最終更新日:Apr 01, 2026

Content Moderation PHP SDK を使用して、カスタム人物に氏名および備考を追加します。この操作は任意です — 設定した情報は、カスタム取得結果に表示されます。

API の完全なリファレンスについては、「人物情報設定の API オペレーション」をご参照ください。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

  • 必要な PHP バージョンを使用して Content Moderation PHP SDK をインストール済みであること。「インストール」で、バージョン要件とセットアップ手順をご確認ください。

重要

サポート対象外の PHP バージョンを使用すると、その後の API 呼び出しに失敗します。

注意事項

setPerson は、personId で特定されるカスタム人物に備考および氏名を追加します。設定後、氏名および備考はカスタム取得結果に返されます。

この操作は任意です。

この SDK を呼び出す際には、Content Moderation API エンドポイントを使用します。 詳細については、「エンドポイント」をご参照ください。

サンプル

以下のサンプルでは、カスタム人物の氏名および備考を設定するリクエストを送信します。

リクエストパラメーター

パラメーター必須説明
personIdはいStringカスタム人物の ID
nameいいえStringカスタム人物の氏名
noteいいえStringカスタム人物に関する備考

コード

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
    // 環境変数から認証情報を使用してクライアントを初期化します。
    // パフォーマンス向上および重複接続の回避のため、このクライアントインスタンスを複数のリクエストで再利用できます。
    AlibabaCloud::accessKeyClient(
        getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),     // AccessKey ID
        getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')  // AccessKey Secret
    )
        ->timeout(10)        // クライアントレベルのリクエストタイムアウト:10 秒
        ->connectTimeout(3)  // クライアントレベルの接続タイムアウト:3 秒
        ->regionId('cn-shanghai')
        ->asDefaultClient();

    // リクエストボディを構築します。
    // プレースホルダーの値を実際の personId、氏名、および備考に置き換えてください。
    $person = [
        'personId' => '<your-person-id>',   // 必須
        'name'     => '<person-name>',       // 任意
        'note'     => '<remarks>',           // 任意
    ];

    $result = Green::v20180509()->setPerson()
        ->timeout(10)        // リクエストレベルのタイムアウト:10 秒
        ->connectTimeout(3)  // リクエストレベルの接続タイムアウト:3 秒
        ->body(json_encode($person))
        ->request();

    print_r($result->toArray());

} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}

以下のプレースホルダーを置き換えてください。

プレースホルダー説明
<your-person-id>更新対象のカスタム人物の IDperson_001
<person-name>人物に割り当てる氏名Jane Smith
<remarks>人物にアタッチする備考セキュリティ担当者、A 号館