Snabbstart: Använd detektering av grundning (förhandsgranskning)

Det här avsnittet går igenom en exempelbegäran med cURL. Klistra in kommandot nedan i en textredigerare och gör följande ändringar.

1. Ersätt <endpoint> med slutpunkts-URL:en som är associerad med resursen.

2. Ersätt <your_subscription_key> med en av nycklarna för resursen.

3. Alternativt kan du ersätta fälten "query" eller "text" i brödtexten med din egen text som du vill analysera.

   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
   }'
   

Öppna en kommandotolk och kör kommandot cURL.

Skapa en ny Python-fil med namnet quickstart.py. Öppna den nya filen i önskad redigerare eller IDE.

1. Ersätt innehållet i quickstart.py med följande kod. Ange din slutpunkts-URL och nyckel i lämpliga fält. Alternativt kan du ersätta fälten "query" eller "text" i brödtexten med din egen text som du vill analysera.

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

   Viktigt!

   Vi rekommenderar Microsoft Entra-ID-autentisering med hanterade identiteter för Azure-resurser för att undvika att lagra autentiseringsuppgifter med dina program som körs i molnet.

   Använd API-nycklar med försiktighet. Inkludera inte API-nyckeln direkt i koden och publicera den aldrig offentligt. Om du använder API-nycklar lagrar du dem säkert i Azure Key Vault, roterar nycklarna regelbundet och begränsar åtkomsten till Azure Key Vault med hjälp av rollbaserad åtkomstkontroll och begränsningar för nätverksåtkomst. Mer information om hur du använder API-nycklar på ett säkert sätt i dina appar finns i API-nycklar med Azure Key Vault.

   Mer information om säkerhet för AI-tjänster finns i Autentisera begäranden till Azure AI-tjänster.

2. Kör programmet med python kommandot :

   python quickstart.py
   

   Vänta en stund för att få svaret.

Det här avsnittet går igenom en exempelbegäran med cURL. Klistra in kommandot nedan i en textredigerare och gör följande ändringar.

1. Ersätt <endpoint> med slutpunkts-URL:en som är associerad med din Azure AI Content Safety-resurs.

2. Ersätt <your_subscription_key> med en av nycklarna för resursen.

3. Ersätt <your_OpenAI_endpoint> med slutpunkts-URL:en som är associerad med din Azure OpenAI-resurs.

4. Ersätt <your_deployment_name> med namnet på din Azure OpenAI-distribution.

5. Alternativt kan du ersätta fälten "query" eller "text" i brödtexten med din egen text som du vill analysera.

   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. Öppna en kommandotolk och kör kommandot cURL.

Skapa en ny Python-fil med namnet quickstart.py. Öppna den nya filen i önskad redigerare eller IDE.

1. Ersätt innehållet i quickstart.py med följande kod. Ange din slutpunkts-URL och nyckel i lämpliga fält. Ange även azure OpenAI-slutpunkten och distributionsnamnet. Alternativt kan du ersätta fälten "query" eller "text" i brödtexten med din egen text som du vill analysera.

   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. Kör programmet med python kommandot :

   python quickstart.py
   

   Vänta en stund för att få svaret.

Det här avsnittet visar en exempelbegäran med hjälp av cURL. Ersätt platshållarna efter behov:

• Ersätt <endpoint> med resursens slutpunkts-URL.
• Ersätt <your_subscription_key> med din prenumerationsnyckel.
• Du kan också ersätta fältet "text" med den text som du vill analysera.

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>"
  }
}'

Skapa ett Python-skript med namnet quickstart.py och inkludera följande kod. Uppdatera slutpunkts-URL:en och nyckeln efter behov:

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