クイックスタート: 根拠性検出 (プレビュー) を使用する

このセクションでは、cURL を使用したサンプル要求について説明します。 以下のコマンドをテキスト エディターに貼り付け、次の変更を加えます。

1. <endpoint> を、リソースに関連付けられたエンドポイント URL で置き換えます。

2. <your_subscription_key> を、お使いのリソースのいずれかのキーで置き換えます。

3. 必要に応じて、本文の "query" フィールドまたは "text" フィールドを、分析する独自のテキストに置き換えます。

   curl --___location --request POST '<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview' \
   --header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
   --header 'Content-Type: application/json' \
   --data-raw '{
     "___domain": "Generic",
     "task": "QnA",
     "qna": {
       "query": "How much does she currently get paid per hour at the bank?"
     },
     "text": "12/hour",
     "groundingSources": [
       "I'm 21 years old and I need to make a decision about the next two years of my life. Within a week. I currently work for a bank that requires strict sales goals to meet. IF they aren't met three times (three months) you're canned. They pay me 10/hour and it's not unheard of to get a raise in 6ish months. The issue is, **I'm not a salesperson**. That's not my personality. I'm amazing at customer service, I have the most positive customer service \"reports\" done about me in the short time I've worked here. A coworker asked \"do you ask for people to fill these out? you have a ton\". That being said, I have a job opportunity at Chase Bank as a part time teller. What makes this decision so hard is that at my current job, I get 40 hours and Chase could only offer me 20 hours/week. Drive time to my current job is also 21 miles **one way** while Chase is literally 1.8 miles from my house, allowing me to go home for lunch. I do have an apartment and an awesome roommate that I know wont be late on his portion of rent, so paying bills with 20hours a week isn't the issue. It's the spending money and being broke all the time.\n\nI previously worked at Wal-Mart and took home just about 400 dollars every other week. So I know i can survive on this income. I just don't know whether I should go for Chase as I could definitely see myself having a career there. I'm a math major likely going to become an actuary, so Chase could provide excellent opportunities for me **eventually**."
     ],
     "reasoning": false
   }'
   

コマンド プロンプトを開き、cURL コマンドを実行します。

quickstart.py という名前の新しい Python ファイルを作成します。 好みのエディターまたは IDE で新しいファイルを開きます。

1. quickstart.py の内容を次のコードで置き換えます。 エンドポイント URL とキーを適切なフィールドに入力します。 必要に応じて、本文の "query" フィールドまたは "text" フィールドを、分析する独自のテキストに置き換えます。

   import http.client
   import json
   
   endpoint = "<your_custom_subdomain>.cognitiveservices.azure.com"
   conn = http.client.HTTPSConnection(endpoint)
   payload = json.dumps({
     "___domain": "Generic",
     "task": "QnA",
     "qna": {
       "query": "How much does she currently get paid per hour at the bank?"
     },
     "text": "12/hour",
     "groundingSources": [
       "I'm 21 years old and I need to make a decision about the next two years of my life. Within a week. I currently work for a bank that requires strict sales goals to meet. IF they aren't met three times (three months) you're canned. They pay me 10/hour and it's not unheard of to get a raise in 6ish months. The issue is, **I'm not a salesperson**. That's not my personality. I'm amazing at customer service, I have the most positive customer service \"reports\" done about me in the short time I've worked here. A coworker asked \"do you ask for people to fill these out? you have a ton\". That being said, I have a job opportunity at Chase Bank as a part time teller. What makes this decision so hard is that at my current job, I get 40 hours and Chase could only offer me 20 hours/week. Drive time to my current job is also 21 miles **one way** while Chase is literally 1.8 miles from my house, allowing me to go home for lunch. I do have an apartment and an awesome roommate that I know wont be late on his portion of rent, so paying bills with 20hours a week isn't the issue. It's the spending money and being broke all the time.\n\nI previously worked at Wal-Mart and took home just about 400 dollars every other week. So I know i can survive on this income. I just don't know whether I should go for Chase as I could definitely see myself having a career there. I'm a math major likely going to become an actuary, so Chase could provide excellent opportunities for me **eventually**."
     ],
     "reasoning": false
   })
   headers = {
     'Ocp-Apim-Subscription-Key': '<your_subscription_key>',
     'Content-Type': 'application/json'
   }
   conn.request("POST", "/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview", payload, headers)
   res = conn.getresponse()
   data = res.read()
   print(data.decode("utf-8"))
   

   重要

   Microsoft Entra 認証と Azure リソースのマネージド ID を併用して、クラウドで実行されるアプリケーションに資格情報を格納しないようにすることをお勧めします。

   API キーは慎重に使用してください。 API キーは、コード内に直接含めないようにし、絶対に公開しないでください。 API キーを使用する場合は、Azure Key Vault に安全に格納し、キーを定期的にローテーションし、ロールベースのアクセス制御とネットワーク アクセス制限を使用して Azure Key Vault へのアクセスを制限してください。 アプリで API キーを安全に使用する方法の詳細については、Azure Key Vault を使用した API キーに関する記事を参照してください。

   AI サービスのセキュリティの詳細については、「Azure AI サービスに対する要求の認証」を参照してください。

2. python コマンドを使用してアプリケーションを実行します。

   python quickstart.py
   

   応答が返されるまで少し時間がかかります。

このセクションでは、cURL を使用したサンプル要求について説明します。 以下のコマンドをテキスト エディターに貼り付け、次の変更を加えます。

1. <endpoint> を、Azure AI Content Safety リソースに関連付けられているエンドポイント URL に置き換えます。

2. <your_subscription_key> を、お使いのリソースのいずれかのキーで置き換えます。

3. <your_OpenAI_endpoint> を、Azure OpenAI リソースに関連付けられたエンドポイント URL に置き換えます。

4. <your_deployment_name> を、Azure OpenAI デプロイの名前に置き換えます。

5. 必要に応じて、本文の "query" フィールドまたは "text" フィールドを、分析する独自のテキストに置き換えます。

   curl --___location --request POST '<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview' \
   --header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
   --header 'Content-Type: application/json' \
   --data-raw '{
     "___domain": "Generic",
     "task": "QnA",
     "qna": {
       "query": "How much does she currently get paid per hour at the bank?"
     },
     "text": "12/hour",
     "groundingSources": [
       "I'm 21 years old and I need to make a decision about the next two years of my life. Within a week. I currently work for a bank that requires strict sales goals to meet. If they aren't met three times (three months) you're canned. They pay me 10/hour and it's not unheard of to get a raise in 6ish months. The issue is, **I'm not a salesperson**. That's not my personality. I'm amazing at customer service, I have the most positive customer service \"reports\" done about me in the short time I've worked here. A coworker asked \"do you ask for people to fill these out? you have a ton\". That being said, I have a job opportunity at Chase Bank as a part time teller. What makes this decision so hard is that at my current job, I get 40 hours and Chase could only offer me 20 hours/week. Drive time to my current job is also 21 miles **one way** while Chase is literally 1.8 miles from my house, allowing me to go home for lunch. I do have an apartment and an awesome roommate that I know wont be late on his portion of rent, so paying bills with 20hours a week isn't the issue. It's the spending money and being broke all the time.\n\nI previously worked at Wal-Mart and took home just about 400 dollars every other week. So I know i can survive on this income. I just don't know whether I should go for Chase as I could definitely see myself having a career there. I'm a math major likely going to become an actuary, so Chase could provide excellent opportunities for me **eventually**."
     ],
     "reasoning": true,
     "llmResource": {
           "resourceType": "AzureOpenAI",
           "azureOpenAIEndpoint": "<your_OpenAI_endpoint>",
           "azureOpenAIDeploymentName": "<your_deployment_name>"
   }'
   

6. コマンド プロンプトを開き、cURL コマンドを実行します。

quickstart.py という名前の新しい Python ファイルを作成します。 好みのエディターまたは IDE で新しいファイルを開きます。

1. quickstart.py の内容を次のコードで置き換えます。 エンドポイント URL とキーを適切なフィールドに入力します。 また、Azure OpenAI エンドポイントとデプロイ名も入力します。 必要に応じて、本文の "query" フィールドまたは "text" フィールドを、分析する独自のテキストに置き換えます。

   import http.client
   import json
   
   conn = http.client.HTTPSConnection("<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview")
   payload = json.dumps({
     "___domain": "Generic",
     "task": "QnA",
     "qna": {
       "query": "How much does she currently get paid per hour at the bank?"
     },
     "text": "12/hour",
     "groundingSources": [
       "I'm 21 years old and I need to make a decision about the next two years of my life. Within a week. I currently work for a bank that requires strict sales goals to meet. IF they aren't met three times (three months) you're canned. They pay me 10/hour and it's not unheard of to get a raise in 6ish months. The issue is, **I'm not a salesperson**. That's not my personality. I'm amazing at customer service, I have the most positive customer service \"reports\" done about me in the short time I've worked here. A coworker asked \"do you ask for people to fill these out? you have a ton\". That being said, I have a job opportunity at Chase Bank as a part time teller. What makes this decision so hard is that at my current job, I get 40 hours and Chase could only offer me 20 hours/week. Drive time to my current job is also 21 miles **one way** while Chase is literally 1.8 miles from my house, allowing me to go home for lunch. I do have an apartment and an awesome roommate that I know wont be late on his portion of rent, so paying bills with 20hours a week isn't the issue. It's the spending money and being broke all the time.\n\nI previously worked at Wal-Mart and took home just about 400 dollars every other week. So I know i can survive on this income. I just don't know whether I should go for Chase as I could definitely see myself having a career there. I'm a math major likely going to become an actuary, so Chase could provide excellent opportunities for me **eventually**."
     ],
     "reasoning": True
     "llmResource": {
      "resourceType": "AzureOpenAI",
      "azureOpenAIEndpoint": "<your_OpenAI_endpoint>",
      "azureOpenAIDeploymentName": "<your_deployment_name>"
     }
   })
   headers = {
     'Ocp-Apim-Subscription-Key': '<your_subscription_key>',
     'Content-Type': 'application/json'
   }
   conn.request("POST", "/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview", payload, headers)
   res = conn.getresponse()
   data = res.read()
   print(data.decode("utf-8"))
   

2. python コマンドを使用してアプリケーションを実行します。

   python quickstart.py
   

   応答が返されるまで少し時間がかかります。

このセクションでは、cURL を使用したサンプル要求を示します。 プレースホルダーは必要に応じて置き換えます。

• <endpoint> は、リソースのエンドポイント URL に置き換えます。
• <your_subscription_key> は、実際のサブスクリプション キーに置き換えます。
• 必要に応じて、"text" フィールドを分析するテキストに置き換えます。

curl --___location --request POST '<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "___domain": "Generic",
  "task": "Summarization",
  "text": "The patient name is Kevin.",
  "groundingSources": [
    "The patient name is Jane."
  ],
  "correction": true,
  "llmResource": {
        "resourceType": "AzureOpenAI",
        "azureOpenAIEndpoint": "<your_OpenAI_endpoint>",
        "azureOpenAIDeploymentName": "<your_deployment_name>"
  }
}'

quickstart.py という名前の Python スクリプトを作成し、次のコードを含めます。 必要に応じて、エンドポイントの URL とキーを更新します。

conn = http.client.HTTPSConnection("<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview")
payload = json.dumps({
  "___domain": "Generic",
  "task": "Summarization",
  "text": "The patient name is Kevin.",
  "groundingSources": [
    "The patient name is Jane."
  ],
  "correction": True,
  "llmResource": {
   "resourceType": "AzureOpenAI",
   "azureOpenAIEndpoint": "<your_OpenAI_endpoint>",
   "azureOpenAIDeploymentName": "<your_deployment_name>"
  }
})
headers = {
  'Ocp-Apim-Subscription-Key': '<your_subscription_key>',
  'Content-Type': 'application/json'
}
conn.request("POST", "/contentsafety/text:detectGroundedness?api-version=2024-09-15-preview", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))