クイックスタート: 根拠性検出 (プレビュー)

このセクションでは、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"))
   

   重要

   終わったらコードからキーを削除し、公開しないよう注意してください。 運用環境では、資格情報を安全に保存してアクセスできる方法を使用してください。 詳しくは、Azure Key Vault に関する記事をご覧ください。

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"))