Responses API

OpenAI-Partnermodelle auf der Gemini Enterprise Agent Platform unterstützen die OpenAI Responses API (publishers/openai/v1/responses) für die Textgenerierung aus Text- und Bildeingaben, Toolaufrufe, die Steuerung des Reasoning-Aufwands und die Komprimierung von Unterhaltungen.

Hinweis

Wenn Sie OpenAI-Partnermodelle mit der Gemini Enterprise Agent Platform verwenden möchten, müssen Sie die folgenden Schritte ausführen. Die Gemini Enterprise Agent Platform API (aiplatform.googleapis.com) muss in Ihrem Cloud de Confiance -Projekt aktiviert sein.

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance project.

3. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the API

4. Führen Sie die Onboarding-Schritte unter OpenAI GPT-Modelle aus, einschließlich des Kaufs des Produkts über den Google Cloud Marketplace und der Aktivierung des Modells in Model Garden.

5. Wenn die Richtlinie Ihrer Organisation den Zugriff auf das Modell einschränkt, lassen Sie das Modell in dieser Richtlinie zu.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Platform User (roles/aiplatform.user) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von OpenAI-Partnermodellen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Endpunkte

OpenAI-Partnermodelle werden von den folgenden Basis-URLs der Agent Platform bereitgestellt:

• Globaler Endpunkt (global): https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/openai/v1
• Multiregionaler Endpunkt für die USA (us): https://aiplatform.us.rep.googleapis.com/v1/projects/PROJECT_ID/locations/us/publishers/openai/v1

Ersetzen Sie dabei <var>PROJECT_ID</var> durch die ID Ihres Projekts in Cloud de Confiance .

Responses API mit dem OpenAI Python SDK aufrufen

Sie können die offizielle Python-Bibliothek openai verwenden, indem Sie base_url auf den Endpunkt Ihrer Agent Platform festlegen und ein aktualisiertes OAuth 2.0-Zugriffstoken Cloud de Confiance by S3NS als api_key übergeben. Legen Sie store=False für zustandslose Anfragen und ZDR-Arbeitslasten fest.

import google.auth
from google.auth.transport.requests import Request
from openai import OpenAI

credentials, _ = google.auth.default(
    scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
credentials.refresh(Request())

project_id = "PROJECT_ID"
base_url = (
    f"https://aiplatform.googleapis.com/v1/projects/{project_id}"
    "/locations/global/publishers/openai/v1"
)

client = OpenAI(
    base_url=base_url,
    api_key=credentials.token,
)

response = client.responses.create(
    model="gpt-6.1-sol",
    input="Explain how Zero Data Retention works on Agent Platform.",
    reasoning={"effort": "medium"},
    store=False,
)
print(response.output_text)

Antworten nach und nach einblenden

Wenn Sie inkrementelle Textdeltas über vom Server gesendete Ereignisse (SSE) streamen möchten, legen Sie stream=True fest:

import google.auth
from google.auth.transport.requests import Request
from openai import OpenAI

credentials, _ = google.auth.default(
    scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
credentials.refresh(Request())

project_id = "PROJECT_ID"
base_url = (
    f"https://aiplatform.googleapis.com/v1/projects/{project_id}"
    "/locations/global/publishers/openai/v1"
)

client = OpenAI(
    base_url=base_url,
    api_key=credentials.token,
)

stream = client.responses.create(
    model="gpt-6-luna",
    input="Write a short Python function to validate a JSON schema.",
    stream=True,
    store=False,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="")

Kompakter Unterhaltungsverlauf

Rufen Sie für langfristige agentische Sitzungen den eigenständigen Komprimierungsendpunkt (POST .../responses/compact) auf, um vorherige Nachrichten in ein verschlüsseltes Komprimierungselement zu komprimieren, das an nachfolgende zustandslose /responses-Aufrufe übergeben werden kann:

import google.auth
from google.auth.transport.requests import Request
from openai import OpenAI

credentials, _ = google.auth.default(
    scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
credentials.refresh(Request())

project_id = "PROJECT_ID"
base_url = (
    f"https://aiplatform.googleapis.com/v1/projects/{project_id}"
    "/locations/global/publishers/openai/v1"
)

client = OpenAI(
    base_url=base_url,
    api_key=credentials.token,
)

compacted = client.responses.compact(
    model="gpt-6-astra",
    input=[
        {"role": "user", "content": "Audit our multi-region VPC firewall rules."},
        {"role": "assistant", "content": "I checked the ingress rules for us-east1 and us-central1."},
    ],
)
print(compacted.output)

Responses API mit dem OpenAI Node.js SDK aufrufen

Sie können die offizielle openai-Node.js-Bibliothek mit Cloud de Confiance by S3NS OAuth -Anmeldedaten verwenden:

import OpenAI from "openai";

const projectId = "PROJECT_ID";
const client = new OpenAI({
  apiKey: process.env.GOOGLE_CLOUD_ACCESS_TOKEN,
  baseURL: `https://aiplatform.googleapis.com/v1/projects/${projectId}/locations/global/publishers/openai/v1`,
});

const response = await client.responses.create({
  model: "gpt-6-luna",
  input: "Write a short summary of how authentication works on Agent Platform.",
  store: false,
});
console.log(response.output_text);

Responses API mit dem OpenAI Go SDK aufrufen

Sie können die offizielle openai-go-Bibliothek mit Cloud de Confiance by S3NS OAuth-Anmeldedaten verwenden:

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/option"
    "github.com/openai/openai-go/v3/responses"
)

func main() {
    ctx := context.Background()
    projectID := "PROJECT_ID"
    client := openai.NewClient(
        option.WithAPIKey(os.Getenv("GOOGLE_CLOUD_ACCESS_TOKEN")),
        option.WithBaseURL("https://aiplatform.googleapis.com/v1/projects/"+projectID+"/locations/global/publishers/openai/v1"),
    )

    response, err := client.Responses.New(ctx, responses.ResponseNewParams{
        Model: "gpt-6-luna",
        Input: responses.ResponseNewParamsInputUnion{
            OfString: openai.String("Write a one-sentence bedtime story about a unicorn."),
        },
        Store: openai.Bool(false),
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(response.OutputText())
}

Responses API mit curl aufrufen

Sie können mit curl eine REST-Anfrage direkt an die Responses API senden.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Cloud de Confiance Projekt-ID

HTTP-Methode und URL:

POST https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/openai/v1/responses

JSON-Text anfordern:

{
  "model": "gpt-6.1-sol",
  "input": "Summarize the key differences between Cloud de Confiance by S3NS and OpenAI terms.",
  "reasoning": {"effort": "medium"},
  "store": false
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/openai/v1/responses"

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/openai/v1/responses" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Fehlerbehandlung

Integrieren Sie exponentiellen Backoff mit Jitter bei 429- und 5xx-Antworten in Produktionsarbeitslasten.

Codex mit Cloud de Confiance by S3NSverbinden

Sie können OpenAI Codex (CLI oder Desktop-Anwendung) so konfigurieren, dass Modellanfragen über Ihr Cloud de Confiance -Projekt mit der Cloud de Confiance by S3NS -Authentifizierung weitergeleitet werden. Eine vollständige Anleitung zur Einrichtung, interaktive Schritte zur Anmeldung und manuelle config.toml-Optionen finden Sie unter OpenAI Codex mitCloud de Confiance by S3NSverbinden.

Nächste Schritte

• Konfigurieren Sie Entwicklertools in OpenAI Codex mitCloud de Confiance by S3NSverbinden.
• Modellspezifikationen, ZDR-Verfahren und geltende Bedingungen finden Sie unter OpenAI GPT-Modelle.
• Monitoring von Missbrauch und Keine Datenaufbewahrung.