Documentazione dell'infrastruttura Oracle Cloud

Strumenti API risposte

OCI Generative AI supporta strumenti con l'API Responses, consentendo AI modelli supportati di utilizzare strumenti integrati durante la generazione delle risposte. Aggiungere le definizioni degli strumenti nella proprietà tools di una richiesta API Responses in modo che il modello possa recuperare il contenuto pertinente dai dati, eseguire codice Python, chiamare funzioni definite dall'applicazione o utilizzare strumenti esposti da un server MCP remoto.

Il supporto degli strumenti è disponibile solo tramite l'API. A seconda della richiesta, il modello può decidere se utilizzare uno degli strumenti configurati. Se necessario, è anche possibile guidare il funzionamento dello strumento con la proprietà tool_choice.
Ad esempio, la richiesta seguente aggiunge uno strumento nella proprietà tools:
response = client.responses.create(
    model="openai.gpt-oss-120b",
    tools=[
        {
            "type": "file_search",
            "vector_store_ids": ["<vector_store_id>"]
        }
    ],
    input="Summarize the main ideas in these documents."
)
  • Ricerca file

    Utilizzare la ricerca file per consentire al modello di recuperare il contenuto pertinente da una memoria di vettore durante la generazione della risposta. Ciò è utile quando si desidera che il modello risponda utilizzando i documenti anziché basarsi solo sulla conoscenza integrata.

  • Interprete codice

    Utilizzare l'interprete di codice per consentire al modello di scrivere ed eseguire codice Python in una sandbox gestita da OCI. Questo è utile per i calcoli, l'analisi dei dati, l'elaborazione dei file e altre attività complesse di calcolo.

  • Chiamata funzione

    Utilizzare Chiamata funzione quando l'applicazione definisce ed esegue la logica dello strumento. Il modello restituisce il nome e gli argomenti della funzione, l'applicazione esegue la funzione e quindi l'applicazione invia l'output della funzione in modo che il flusso di lavoro possa continuare.

  • Chiamata MCP

    Utilizza la chiamata MCP per consentire agli strumenti di chiamata AI generativa OCI ospitati su un server MCP remoto direttamente durante la richiesta. Ciò riduce l'orchestrazione lato client perché la piattaforma comunica con il server MCP senza richiedere un ulteriore round trip dell'applicazione.