Source: https://ailoot.ai/docs/it/integrations/openai-agents-sdk/
Canonical: https://ailoot.ai/docs/it/integrations/openai-agents-sdk/
Language: it

[SDK e framework](https://ailoot.ai/docs/it/integrations/#sdk) 

# OpenAI Agents SDK

[Markdown](https://ailoot.ai/docs/it/integrations/openai-agents-sdk/index.md)

Framework per agenti · OpenAI Chat, OpenAI Responses

| Formato | Dove configurare |
| --- | --- |
| OpenAI Chat, OpenAI Responses | AsyncOpenAI(base\_url=..., api\_key=...) + OpenAIChatCompletionsModel(model=..., openai\_client=client), oppure globalmente set\_default\_openai\_client(client) |

## [](https://ailoot.ai/docs/it/integrations/openai-agents-sdk/#setup)Configurazione

Copia la configurazione e sostituisci `sk-...` con la tua chiave dall’area personale Ailoot. È meglio conservarla nella variabile d’ambiente `AILOOT_API_KEY`, se l’applicazione lo supporta.

Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.

```python
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
set_tracing_disabled(disabled=True)
client = AsyncOpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
model = OpenAIChatCompletionsModel(model="claude-sonnet-5-5", openai_client=client)
agent = Agent(name="Assistente", instructions="Rispondi in russo", model=model)
print(Runner.run_sync(agent, "Ciao").final_output)
```

Modello di esempio: `claude-sonnet-5-5, gpt-6.1-sol`. Scegli qualsiasi altro modello dal [catalogo](https://ailoot.ai/models/it/) — verifica che supporti il formato necessario.

## [](https://ailoot.ai/docs/it/integrations/openai-agents-sdk/#notes)Da sapere

Indirizzo con /v1. Disabilita il tracing tramite set\_tracing\_disabled(True): altrimenti l’SDK tenterà di inviare tracce a OpenAI senza una chiave OpenAI. Chat Completions è disponibile solo per i modelli per cui questo metodo è indicato nel catalogo ed è accessibile alla tua chiave; Responses (predefinito nell’SDK) solo per i modelli con il metodo responses nel catalogo. Gli strumenti integrati di OpenAI (ricerca web, file) non sono garantiti tramite un gateway di terze parti.

## [](https://ailoot.ai/docs/it/integrations/openai-agents-sdk/#check)Verifica

- Per il formato OpenAI l’indirizzo è `https://api.ailoot.ai/v1` (oppure il percorso completo, se l’applicazione chiede l’indirizzo completo).
- Fai una domanda breve. Se ricevi un errore, controlla codice e Request ID e consulta la pagina [Errori e limiti](https://ailoot.ai/docs/it/errors/).
- 404 subito dopo la configurazione indica quasi sempre un indirizzo errato: manca o è superfluo il segmento `/v1`.
- 402 — il saldo non basta per la riserva. Gli agenti riservano più di una chat: [perché](https://ailoot.ai/docs/it/billing/reserve/).

Documentazione dell’applicazione: [https://openai.github.io/openai-agents-python/models/](https://openai.github.io/openai-agents-python/models/)

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.