# Azure OpenAI

## Selecting the Connection Type

Once you have [selected your connection type](/ai-red-teaming/probe/target/add-target/integration-setup.md#selecting-a-connection-type), a configuration tab will appear on the next step, prompting you to input the required connection details.

## Integration Setup

The integration supports two API types:

1. ​**Chat Completions API** - The traditional industry-standard protocol (`/v1/chat/completions`). It operates on a message-based array system and requires manual context management. While robust and widely used, it is now considered a legacy path and may not receive the latest agentic features or reasoning optimizations.
2. **Responses API** - The modern, unified protocol designed to supersede Chat Completions. It offers better performance with reasoning models (like GPT-5), native **agentic loops** for multi-tool calling, lower costs through **improved cache utilization**, and built-in **stateful context** management.

The setup process and requirements for both API Types are defined below.

<figure><img src="/files/s4cZ6S0LYkchNwsGeBNW" alt=""><figcaption><p>Figure 1: Azure OpenAI - Chat Completions API</p></figcaption></figure>

<figure><img src="/files/kb7sADOkPz99jOMltGJL" alt=""><figcaption><p>Figure 2: Azure OpenAI - Responses API</p></figcaption></figure>

* **System Prompt** - Your application’s system prompt. It sets the initial instructions or context for the AI model, defines the behavior, tone, and specific guidelines the AI should follow while interacting. For best practices, refer to the [OpenAI documentation on prompt engineering](https://platform.openai.com/docs/guides/prompt-engineering).
* **API Key** - In the [Azure Portal](https://azure.microsoft.com/en-us/get-started/azure-portal), find a key on the Keys and Endpoint page of the Azure OpenAI resource.
* **URL**&#x20;
  * Supported Azure OpenAI endpoints (protocol and hostname)&#x20;
  * The general format for an endpoint is: https\://{your-resource-name}.openai.azure.com.
  * For example: <https://yourcompany.openai.azure.com&#x20>;
  * Endpoint is also found on the Keys and Endpoint page.
* **Deployment Name** - Configured when setting up your Azure OpenAI model. This is the unique identifier that links to your specific model deployment. Deployment names can be found on the Deployments section of your project on the [Azure AI Foundry](https://learn.microsoft.com/en-us/azure/ai-studio/what-is-ai-studio).

For more information, you can explore the official [Azure OpenAI Service](https://learn.microsoft.com/en-us/azure/ai-services/openai/) documentation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.probe.splx.ai/ai-red-teaming/probe/target/index/azure-openai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.