Personalizzazione dello schema per gli strumenti

Molte organizzazioni utilizzano sistemi personalizzati per soddisfare esigenze aziendali specifiche. Gli strumenti che si connettono a questi sistemi potrebbero richiedere schemi diversi rispetto a quelli forniti dalle implementazioni standard integrate in watsonx Orchestrate. Ad esempio, potrebbero esserci differenze in termini di nomi dei campi e parametri di input o output. Di conseguenza, gli strumenti che si integrano con questi sistemi richiedono schemi che riflettano l'implementazione effettiva di un'organizzazione piuttosto che un'impostazione predefinita generica.

Modifica dello schema per uno strumento

Per modificare lo schema:

  1. Dal menu Menu, seleziona Compilazione > Tutti gli strumenti. In alternativa, vai alla pagina Agent Builder e accedi alla sezione Toolset.

  2. Seleziona lo strumento, fai clic sull'icona Opzioni icona opzione e seleziona Modifica dettagli.

  3. Fai clic sulla scheda Parametri. Vengono visualizzati i parametri di input e output dello schema.

La modifica dei parametri di input e output può essere controllata separatamente utilizzando la configurazione dello schema per uno strumento. I parametri di input potrebbero essere bloccati, mentre quelli di output potrebbero rimanere modificabili, oppure i parametri di output potrebbero essere bloccati mentre quelli di input rimangono modificabili. Ad esempio, è possibile utilizzare l'Agent Development Kit (ADK) per configurare gli strumenti di " Python " con schemi di input e output dinamici (enable_dynamic_input_schema=True). Per ulteriori informazioni, consultare la sezione "Creazione di strumenti basati su Python - Schemi di input e output dinamici".

A seconda della configurazione dello schema dello strumento, viene visualizzato un messaggio che indica se è possibile modificare i parametri di input, i parametri di output o entrambi. Alcuni parametri potrebbero essere bloccati e non modificabili; in tal caso, nella colonna "Tipo" viene visualizzato Icona Blocco un simbolo. È comunque possibile modificare la descrizione di un parametro bloccato, tranne quando il parametro appartiene a uno strumento MCP. Tuttavia, non è possibile eliminare i parametri di input o output bloccati per nessuno strumento.

Nota:

È possibile personalizzare lo schema in modo che corrisponda al sistema dell'organizzazione, ma se lo schema personalizzato non è compatibile con il sistema, lo strumento non funziona correttamente durante l'esecuzione.

Le opzioni Aggiungi input e Aggiungi output vengono visualizzate nella finestra di dialogo in base alla configurazione dello schema dello strumento. Per aggiungere un parametro di input o output, fare clic su Aggiungi input o Aggiungi output, selezionare un tipo e inserire i dettagli del parametro, quali nome, descrizione e altre proprietà. Dopo che un parametro è stato aggiunto, rimane sbloccato e può essere modificato.