Questa lezione coprirà come eseguire gli esempi di codice di questo corso.
Prima di iniziare a clonare il tuo repository, unisciti al canale Discord AI Agents For Beginners per ricevere aiuto con la configurazione, per qualsiasi domanda sul corso o per connetterti con altri studenti.
Per iniziare, clona o fai il fork del repository GitHub. Questo ti permetterà di avere una tua versione del materiale del corso per eseguire, testare e modificare il codice!
Puoi farlo cliccando sul link per
Dovresti ora avere la tua versione forkata di questo corso al seguente link:
Questo corso offre una serie di Jupyter Notebook che puoi eseguire per ottenere esperienza pratica nella creazione di AI Agents.
Gli esempi di codice utilizzano:
Richiede un Account GitHub - Gratuito:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Etichettato come (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Etichettato come (autogen.ipynb)
Richiede un Abbonamento Azure: 3) Azure AI Foundry + Azure AI Agent Service. Etichettato come (azureaiagent.ipynb)
Ti incoraggiamo a provare tutti e tre i tipi di esempi per vedere quale funziona meglio per te.
Qualunque opzione tu scelga, determinerà quali passaggi di configurazione dovrai seguire di seguito:
Abbiamo incluso un file requirements.txt
nella radice di questo repository che contiene tutti i pacchetti Python richiesti per eseguire gli esempi di codice.
Puoi installarli eseguendo il seguente comando nel terminale alla radice del repository:
pip install -r requirements.txt
Consigliamo di creare un ambiente virtuale Python per evitare conflitti e problemi.
Assicurati di utilizzare la versione corretta di Python in VSCode.
Questo corso utilizza il GitHub Models Marketplace, che offre accesso gratuito a Large Language Models (LLMs) che utilizzerai per creare AI Agents.
Per utilizzare i modelli GitHub, dovrai creare un GitHub Personal Access Token.
Puoi farlo accedendo al tuo account GitHub.
Segui il Principio del Minimo Privilegio quando crei il tuo token. Questo significa che dovresti assegnare al token solo le autorizzazioni necessarie per eseguire gli esempi di codice di questo corso.
Seleziona l’opzione Fine-grained tokens
sul lato sinistro dello schermo accedendo a Developer settings
Poi seleziona Generate new token
.
Inserisci un nome descrittivo per il tuo token che rifletta il suo scopo, rendendolo facile da identificare in seguito.
🔐 Raccomandazione sulla Durata del Token
Durata raccomandata: 30 giorni
Per una maggiore sicurezza, puoi optare per un periodo più breve, come 7 giorni 🛡️
È un ottimo modo per fissare un obiettivo personale e completare il corso mentre il tuo slancio di apprendimento è alto 🚀.
Limita l’ambito del token al tuo fork di questo repository.
Restringi le autorizzazioni del token: Sotto Permissions, clicca sulla scheda Account e premi il pulsante “+ Add permissions”. Apparirà un menu a tendina. Cerca Models e seleziona la casella corrispondente.
Verifica le autorizzazioni richieste prima di generare il token.
Prima di generare il token, assicurati di essere pronto a conservarlo in un luogo sicuro come un gestore di password, poiché non sarà mostrato di nuovo dopo la sua creazione.
Copia il nuovo token che hai appena creato. Ora lo aggiungerai al file .env
incluso in questo corso.
.env
Per creare il file .env
, esegui il seguente comando nel terminale.
cp .env.example .env
Questo copierà il file di esempio e creerà un .env
nella tua directory, dove potrai inserire i valori per le variabili di ambiente.
Con il tuo token copiato, apri il file .env
nel tuo editor di testo preferito e incolla il token nel campo GITHUB_TOKEN
.
Ora dovresti essere in grado di eseguire gli esempi di codice di questo corso.
Segui i passaggi per creare un hub e un progetto in Azure AI Foundry qui: Panoramica delle risorse Hub
Una volta creato il tuo progetto, dovrai recuperare la stringa di connessione per il tuo progetto.
Puoi farlo accedendo alla pagina Overview del tuo progetto nel portale Azure AI Foundry.
.env
Per creare il file .env
, esegui il seguente comando nel terminale.
cp .env.example .env
Questo copierà il file di esempio e creerà un .env
nella tua directory, dove potrai inserire i valori per le variabili di ambiente.
Con il tuo token copiato, apri il file .env
nel tuo editor di testo preferito e incolla il token nel campo PROJECT_ENDPOINT
.
Come buona pratica di sicurezza, utilizzeremo l’autenticazione senza chiavi per autenticarti ad Azure OpenAI con Microsoft Entra ID.
Successivamente, apri un terminale ed esegui az login --use-device-code
per accedere al tuo account Azure.
Una volta effettuato l’accesso, seleziona il tuo abbonamento nel terminale.
Per la lezione Agentic RAG - Lezione 5 - ci sono esempi che utilizzano Azure Search e Azure OpenAI.
Se desideri eseguire questi esempi, dovrai aggiungere le seguenti variabili di ambiente al tuo file .env
:
AZURE_SUBSCRIPTION_ID
- Controlla Project details nella pagina Overview del tuo progetto.
AZURE_AI_PROJECT_NAME
- Guarda in alto nella pagina Overview del tuo progetto.
AZURE_OPENAI_SERVICE
- Trova questo nella scheda Included capabilities per Azure OpenAI Service nella pagina Overview.
AZURE_OPENAI_RESOURCE_GROUP
- Vai a Project properties nella pagina Overview del Management Center.
GLOBAL_LLM_SERVICE
- Sotto Connected resources, trova il nome della connessione Azure AI Services. Se non elencato, controlla il portale Azure sotto il tuo gruppo di risorse per il nome della risorsa AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
- Seleziona il tuo modello di embedding (es. text-embedding-ada-002
) e annota il Deployment name dai dettagli del modello.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
- Seleziona il tuo modello di chat (es. gpt-4o-mini
) e annota il Deployment name dai dettagli del modello.
AZURE_OPENAI_ENDPOINT
- Cerca Azure AI services, clicca su di esso, poi vai a Resource Management, Keys and Endpoint, scorri verso il basso fino agli “Azure OpenAI endpoints” e copia quello che dice “Language APIs”.
AZURE_OPENAI_API_KEY
- Dalla stessa schermata, copia KEY 1 o KEY 2.
AZURE_SEARCH_SERVICE_ENDPOINT
- Trova la tua risorsa Azure AI Search, cliccaci sopra e vedi Overview.
AZURE_SEARCH_API_KEY
- Poi vai su Settings e poi Keys per copiare la chiave primaria o secondaria dell’amministratore.
AZURE_OPENAI_API_VERSION
- Visita la pagina API version lifecycle sotto Latest GA API release.Piuttosto che codificare le tue credenziali, utilizzeremo una connessione senza chiavi con Azure OpenAI. Per farlo, importeremo DefaultAzureCredential
e successivamente chiameremo la funzione DefaultAzureCredential
per ottenere le credenziali.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Se hai problemi con questa configurazione, entra nel nostro
Ora sei pronto per eseguire il codice di questo corso. Buon apprendimento sul mondo degli AI Agents!
Introduzione agli AI Agents e ai Casi d’Uso degli Agent
Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Sebbene ci impegniamo per garantire l’accuratezza, si prega di notare che le traduzioni automatiche potrebbero contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si consiglia una traduzione professionale eseguita da un traduttore umano. Non siamo responsabili per eventuali fraintendimenti o interpretazioni errate derivanti dall’uso di questa traduzione.