Aggiornare un endpoint di un agente ospitato e la scheda dell'agente

Importante

Gli elementi contrassegnati come anteprima in questo articolo sono attualmente in anteprima. Questa anteprima viene fornita senza un contratto di servizio e Microsoft non lo consiglia per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per ulteriori informazioni, vedere Condizioni supplementari per l'uso delle versioni di anteprima di Microsoft Azure.

Usare azd ai agent endpoint update per aggiornare con una patch i metadati dell'endpoint e della scheda in un agente Microsoft Foundry già distribuito. È possibile aggiornare i dettagli visibili ai consumatori senza creare una nuova versione dell'agente.

Se si usa un agente di codifica come GitHub Copilot, la competenza Microsoft Foundry consente di aggiornare i metadati dell'endpoint e le impostazioni della scheda agente mantenendo separate le modifiche alla distribuzione.

Prerequisiti

Decidere quando aggiornare i metadati

Utilizzare azd ai agent endpoint update quando è sufficiente aggiornare i metadati sull'agente letti dai client e dagli strumenti. Questi metadati includono l'endpoint pubblico, il nome visualizzato, la descrizione e le informazioni di contatto.

I casi comuni includono:

  • Hai modificato il nome visualizzato pubblicamente o la descrizione nella scheda dell'agente e vuoi che la modifica si rifletta nel portale Foundry senza eseguire una nuova distribuzione.
  • È stato spostato o riemesso l'URL dell'endpoint pubblico dell'agente.
  • Sono stati aggiornati il proprietario o i metadati di contatto sulla scheda ai fini del routing o della governance.

Se il modello, le istruzioni, gli strumenti, il codice o le variabili di ambiente sono state modificate, non usare endpoint update. Queste modifiche richiedono una nuova versione. Eseguire invece azd deploy o azd up.

Aggiornare l'endpoint e la scheda

  1. Modifica la sezione agent_endpoint, la sezione agent_card o entrambe le sezioni nel servizio azure.ai.agent nel file azure.yaml.

  2. Eseguire il comando update:

    azd ai agent endpoint update

  3. In un progetto multiservizio passare il nome del servizio come parametro posizionale:

    azd ai agent endpoint update my-agent

La CLI legge le due sezioni dal servizio dell'agente in azure.yaml e aggiorna il record dell'agente esistente. Il processo non crea una nuova versione dell'agente, ricompila un contenitore o modifica un'infrastruttura.

Verifica l'aggiornamento

Confermare che la modifica è stata applicata:

azd ai agent show

L'output riflette i nuovi valori di endpoint e scheda. Il numero di versione è invariato.

Rivedere i campi aggiornati

endpoint update aggiorna solo i metadati dell'endpoint e della scheda. Utilizza la tabella per decidere se la modifica richiede una distribuzione completa.

Campo del servizio azure.ai.agent Aggiornato da endpoint update?
agent_endpoint Sì
agent_card Sì
model, model_deployment No - richiede azd deploy
instructions No - richiede azd deploy
tools, toolboxes, skills No - richiede azd deploy
env No - richiede azd deploy
Immagine del contenitore/punto di ingresso/runtime No - richiede azd deploy

Se non si è certi che una modifica sia idonea a endpoint update, eseguire azd ai agent doctor in un secondo momento. Contrassegna eventuali differenze tra azure.yaml e lo stato dell'agente distribuito.

Contenuti correlati

  • Ultimo aggiornamento: