La Responses API collega l'applicazione con modelli e strumenti. La Agents SDK organizza il lavoro dell'agente al proprio codice. Per capire la differenza impedisce l'attributo alle attività del modello di esecuzione e il controllo che appartengono al tempo di esecuzione.
Concetti Chiave
Pensa a tre livelli: modelli produzione di risposte e proposte di azioni Responses API come interfaccia per invocarli con contesto e strumenti; e Agents SDK per definire gli agenti e coordinare il vostro loop. Il modulo studia questa base di corsi, e non l'intero catalogo di prodotti che può essere pubblicato in seguito.
Utilizzando SDK non significa che OpenAI ospita automaticamente l'applicazione Python. La vostra applicazione rimane responsabile dal vostro distribuzione, integrazioni, dati e decisioni di autorizzazione. Lo strumento ospitato A e una caratteristica del tuo backend possono apparire nello stesso flusso, anche se funzionano in ambienti diversi.
Per una semplice richiesta puoi rispondere direttamente a chiamata. Se hai bisogno di diversi passaggi, puoi anche implementare il loop nella tua applicazione. La SDK sarà utile se siete interessati a riutilizzare il coordinamento, gli strumenti, i handoff e i guarrail. La scelta dipende da quanto controllo è necessario e da quanto logico si desidera mantenere, e non da come un'opzione è sempre migliore.
Modulo Obiettivi
- Per scegliere da uno chiamata direttamente a risposte e un loop di gestione SDK.
- Differenziate ha ospitato strumenti, strumenti di funzione e agenti come strumenti.
- Per spiegare chi mantiene il controllo dopo un decollo.
- Per porre la validazione, l'approvazione e l'osservabilità in cui realmente proteggono il flusso.
Risposte e contesto
A richiesta to Responses specifica modello, input e, se del caso, istruzioni e strumenti. L'output può contenere testo e altri elementi, tra cui richieste esecuzione. output_text più facile da leggere il testo finale, ma un integrer dovrebbe esaminare gli elementi pertinenti durante l'applicazione del loop.
Per condurre discussioni ci sono opzioni come una storia amministrata dall'applicazione, previous_response_id Per canalizzare le risposte e le Conversazioni per preservare gli elementi in una conversazione. Avere un identificatore di continuità non rimuove i confini del contesto, i costi o le decisioni di ritenzione. Scegli una strategia e conserva i dati che richiede tale strategia. The Guida ufficiale di conversazione di stato spiega le sue differenze.
Agenti, Runner e Tools
A Agente riunisce una responsabilità, istruzioni, modello e funzionalità. The Runner condurre il ciclo: invoca il modello, assiste strumenti o delegazioni e restituisce un risultato dopo la sua fine. A Python, Runner.run è asincrono e Runner.run_sync serve in un contesto sincrono appropriato. final_output contiene l'output finale del risultato. Il tipo dipende da come l'agente è stato istituito.
Uno. strumento di funzione Esegui il codice della tua applicazione. L'arredatore @function_tool afferra la firma, i tipi e la descrizione per rappresentare la capacità. Il modello richieste un'operazione con argomenti. Il runtime gestisce l'implementazione. Uno. strumento ospitatocome ricerca compatibile con il modello scelto, opera dal servizio. Agenti come strumenti permette ad un agente leader di consultare uno specialista come una capacità chiusa e quindi preparare la risposta.
Gli schemi migliorano la forma di argomenti, ma una funzione di rimborso dovrebbe ancora controllare responsabile, importo, stato e duplicati. La chiave A API viene salvata sul server o in un ambiente protetto, mai al pubblico JavaScript da una pagina di studio.
Manifestazione e responsabilità
con un manomissioneIl controllo di quel ramo va allo specialista. con un manager utilizzando gli agenti come strumenti, il principale mantiene la responsabilità per la risposta. Diversi attori non sono necessari solo perché ci sono diversi strumenti: si dividono quando le responsabilità, le politiche o le capacità cambiano. The schema di orchestrazione ufficiale Descrive questa distinzione.
Esempio guidato
Crea mentalmente un sistema di supporto con triage, ordini e ritorni.
- L'utente chiede "Dov'è il mio ordine P-204?" Input che controlla l'intervallo e il formato.
- Triage identifica l'intenzione ed esegue un handoff allo specialista dell'ordine.
- Quell'agente sta applicando.
consultar_pedido. Il backend controlla l'accesso e restituisce "in preparazione". - Lo specialista scrive la risposta utilizzando quel risultato, senza pretendere che fosse già consegnato.
- Se l'utente dopo aver chiesto un rimborso, la politica di rimborso e l'autorizzazione dell'azione concreta vengono applicate prima di emettere un rimborso.
La dimostrazione utilizza dati fittizi e una funzione che simula solo l'operazione. Ordine di prova inesistente, negato l'accesso e richiesta fuori argomento. In ogni caso ci dovrebbe essere una risposta controllata e nessuna reale operazione finanziaria.
Wagons e tracce
Input, l'output e gli strumenti hanno diversi intervalli. Nella SDK, l'ingresso viene applicato al primo agente della catena e all'agente finale a cui risulta la risposta finale. Non presumo che siano ripetuti ad ogni specialista. La validazione di un'azione sensibile è posta accanto allo strumento e un'approvazione può mettere in pausa il flusso. I controlli paralleli riducono la latenza ma possono consentire il lavoro speculativo: utilizzando il blocco esecuzione come necessario. Query e monitoraggio umano.
Nell'esempio di supporto, un voucher può produrre un output strutturato come is_support_question: bool, come definito con un modello pidantico. Se il risultato non soddisfa la regola, il guarrail può attivare un tripwire: The Runner intersects esecuzione con un'eccezione che la domanda deve gestire. Non scoprire le operazioni già intraprese. E' per questo che conta quando e' valida. The implementazione ufficiale di guarrail SDK mostra il risultato strutturato e le modalità esecuzione.
A traccia mostra stadi, chiamate e risultati disponibili. aiuta a distinguere il tempo dal modello, da uno API e dalla validazione. Protegge i dati registrati e controlla la configurazione del layout. Non interpretare una traccia come ragionamento interno completo o sentire che la funzione più visibile è necessariamente il collo della bottiglia.
Errori comuni
- Per unire il client SDK API con Agents SDK: hanno responsabilità diverse.
- Per sperare che la definizione di uno strumento eseguirà immediatamente il tuo codice.
- Credere che un handoff garantisca il suo ritorno all'agente di triage.
- Fidatevi della guardia d'ingresso per approvare tutti i rimborsi successivi.
Esercizio di progettazione
A membro del personale dovrebbe consultare due specialisti e mettere insieme i suoi risultati in un unico rapporto. Cosa c'e' di meglio che questa responsabilita'?
Soluzione
A manager con specialisti esposti come strumenti tiene traccia e sintetizza il rapporto. Il handoff è adatto quando un altro specialista deve prendersi cura della conversazione. Nessuno di essi ha autorizzato le azioni sensibile: ogni strumento mantiene le sue validazioni e autorizzazioni.
Fonti e recensioni
The introduzione ufficiale a Agents SDK link definizioni, esecuzione e strumenti. Esaminare il caso di supporto indicando quale configurazione appartiene all'agente e come logico dovrebbe rimanere nell'applicazione. La sintassi e le funzionalità esatte devono essere controllate con la versione SDK e il modello scelto.