Integrowanie poręczy innych firm

usługa Microsoft Foundry obsługuje integracje z systemami bezpieczeństwa i zabezpieczeń innych firm. Możesz połączyć zewnętrzne rozwiązania z modelami i agentami sztucznej inteligencji podczas działania, aby wzbogacić rozwiązania Foundry Guardrails i Controls z najlepszymi w swojej klasie możliwościami zabezpieczeń od zaufanych partnerów.

Wymagania wstępne

Przed skonfigurowaniem integracji upewnij się, że masz następujące elementy:

• subskrypcja Azure: potrzebujesz rolę właściciela w subskrypcji.

• Key Vault: Utwórz co najmniej jedną Key Vault z przypisaną rolą administratora Key Vault.

• Projekt Foundry: Utwórz projekt z przypisanymi do Ciebie rolami Foundry User i Foundry Account Owner.

  Ważna

  Niedawno zmieniono nazwy ról RBAC w usłudze Foundry. Użytkownik Foundry, właściciel Foundry, właściciel konta Foundry i menedżer projektu Foundry były wcześniej nazywane odpowiednio użytkownikiem Azure AI, właścicielem Azure AI, właścicielem konta Azure AI i menedżerem projektu Azure AI. Poprzednie nazwy mogą być nadal widoczne w niektórych miejscach, podczas gdy zmiana nazwy jest wdrażana. Identyfikatory ról i uprawnienia podstawowe są niezmienione przez zmianę nazwy.

• Zarządzana tożsamość: Utwórz co najmniej jedną tożsamość zarządzaną przypisaną przez użytkownika i dołącz ją do Foundry w portalu Azure w Zarządzanie zasobami>Tożsamość.

Umożliwienie i przetwarzanie danych

Integracje innych firm są włączane za pomocą podejścia ByOL (Bring Your Own License), co umożliwia korzystanie z istniejących licencji oprogramowania innych firm od obsługiwanych partnerów. Dane są przetwarzane poza Azure AI Foundry przy użyciu wybranej usługi. Do tego przetwarzania są stosowane warunki i zobowiązania dotyczące prywatności w odniesieniu do innych usług.

Kroki łączenia integracji

1. Wykonaj kroki integracji innych firm i pobierz klucz API związany z Twoim niestandardowym profilem zabezpieczeń. Zalecamy, aby projekt Foundry znajdował się w tym samym regionie co punkt końcowy innej firmy. Wyświetl obsługiwane regiony tutaj.
2. Przejdź do AI Foundry i wybierz Guardrails.
3. Wybierz kartę Integracje i dodaj integrację innej firmy. Następnie wybierz wybraną integrację zewnętrznej firmy.
4. Wybierz usługę Keyvault i tożsamość zarządzaną.
5. Dodaj punkt dostępu i klucze interfejsu API. Aby uzyskać parę kluczy endpoint-API, wykonaj kroki integracji zewnętrznych podmiotów.

Integracje innych firm

Ta sekcja łączy zasoby z instrukcjami innych firm dotyczącymi pobierania kluczy interfejsu API i tworzenia profilów niestandardowych. W sekcji dotyczącej kroków łączenia integracji możesz użyć tych łączy, aby kontynuować proces integracji.

Dołączanie integracji do poręczy foundry

1. Wybierz jedną lub więcej zasad Foundry Guardrails, aby dołączyć integrację.
2. Wybierz Zapisz i potwierdź integrację oraz mocowanie poręczy w tabeli integracji.
3. Potwierdź stan. Działanie wskazuje, że połączenie zostało pomyślnie nawiązane.
4. Komunikaty o błędach wskazują konkretne zalecenia (na przykład brak "Managed Identity").
5. Postępuj zgodnie z głównym przepływem Foundry Guardrail, aby przypisać niestandardową blokadę z aktywną integracją innej firmy do modelu lub agenta.
6. Test na placu zabaw.

Przykłady kodu

from openai import OpenAI

# Replace with your endpoint and API key
endpoint = "<your-endpoint>"
deployment_name = "gpt-5.2-chat"
api_key = "<your-api-key>"

client = OpenAI(
    base_url=endpoint,
    api_key=api_key
)

response = client.chat.completions.create(
    model=deployment_name,
    messages=[
        {
            "role": "user",
            "content": "<prompt-that-violates-rai-policy>",
        }
    ],
    temperature=0.7,
)

print(response)

Wyjście

openai.BadRequestError: Error code: 400 - 
{
  "error": {
    "message": "The response was filtered due to the prompt triggering Azure OpenAI's content management policy. Please modify your prompt and retry. To learn more about our content filtering policies please read our documentation: https://go.microsoft.com/fwlink/?linkid=2198766",
    "type": null,
    "param": "prompt",
    "code": "content_filter",
    "status": 400
  }
}

{
  "innererror": {
    "code": "ResponsibleAIPolicyViolation",
    "content_filter_result": {
      "external_safety_provider": {
        "detected": true,
        "filtered": true,
        "results": [
          {
            "provider_name": "Palo Alto Networks Prisma AIRS",
            "error": false,
            "detected": true,
            "filtered": true,
            "role": "User",
            "source": "AI-Runtime-Azure-AI-Foundry",
            "details": {
              "created_at": "2026-02-18T01:11:29.3949427Z",
              "completed_at": "2026-02-18T01:11:29.436312651Z",
              "detections": {
                "action": "block",
                "category": "malicious",
                "content_detected": {
                  "injection": false,
                  "toxic_content": true
                }
              }
            },
            "profile_id": "b44235eb-2960-49f9-bc44-13c69cb3f5f6",
            "profile_name": "safety-provider-do-not-use",
            "scan_id": "c41ac678-c675-4180-9f74-a109a25457cc",
            "report_id": "Rc41ac678-c675-4180-9f74-a109a25457cc",
            "session_id": "182e5add-f49a-4a63-931f-30c864866dd6",
            "tr_id": "182e5add-f49a-4a63-931f-30c864866dd6"
          }
        ]
      },
      "hate": {
        "filtered": false,
        "severity": "safe"
      },
      "self_harm": {
        "filtered": false,
        "severity": "safe"
      },
      "sexual": {
        "filtered": false,
        "severity": "safe"
      },
      "violence": {
        "filtered": false,
        "severity": "safe"
      },
      "jailbreak": {
        "detected": false,
        "filtered": false
      }
    }
  }
}

Dostępność regionów

W poniższej tabeli przedstawiono obsługiwane regiony. Zalecamy, aby projekt Foundry znajdował się w tym samym regionie co punkt końcowy innej firmy. Różne regiony mogą powodować większe opóźnienia i potencjalne przekroczenia limitu czasu.

Następne kroki

• Dowiedz się więcej o zasadach bezpieczeństwa Foundry