Per Iniziare

Inizia rapidamente con Goa-AI - installazione, setup e il tuo primo agente.

Questa sezione ti guida attraverso l’inizio dello sviluppo con Goa-AI. Imparerai come:

Cosa Aspettarsi

Quando lavori con Goa-AI, il tuo workflow di sviluppo segue tipicamente questi passi:

Design First: Scrivi la definizione del tuo agente usando il DSL di Goa-AI in Go
Genera Codice: Usa la CLI Goa per generare package agente, specifiche tool e workflow
Implementa Planner: Aggiungi la tua logica planner (integrazione LLM, selezione tool)
Collega Runtime: Configura il runtime con engine, store e moduli feature
Testa e Esegui: Usa il client generato per testare il tuo agente

Dopo aver completato le guide per iniziare, puoi:

Seguire il Tutorial Agente Semplice per un approfondimento sulla costruzione di agenti base
Esplorare la Composizione di Agenti per imparare i pattern agent-as-tool
Scoprire l’Integrazione MCP per consumare suite di tool esterni

Mantieni i tuoi file di design in un package design separato: Questa separazione aiuta a mantenere una chiara distinzione tra il design e l’implementazione del tuo agente. Rende più facile gestire le modifiche al contratto dell’agente indipendentemente dalla logica del planner.
Esegui goa gen dopo qualsiasi modifica al design: Mantenere il codice generato sincronizzato con il tuo design è cruciale. Eseguire goa gen assicura che i tuoi package agente, specifiche tool e workflow riflettano sempre il design corrente dell’agente.
Versiona il tuo codice generato: Mentre il codice generato può essere ricreato, versionarlo aiuta a tracciare l’evoluzione dell’agente, rende i deployment più affidabili e abilita revisioni del codice più facili per le modifiche all’agente.
Usa le specifiche tool generate: Le specifiche tool auto-generate servono come risorsa preziosa sia per lo sviluppo che per la validazione. Forniscono accesso type-safe ai payload e risultati dei tool.
Segui convenzioni di naming consistenti: Usa nomi descrittivi e consistenti per i tuoi agenti, toolset e tool nel tuo design. Questo rende l’architettura del tuo agente più intuitiva e facile da mantenere.
Sfrutta il sistema di tipi di Goa: Approfitta del ricco sistema di tipi di Goa per definire payload tool precisi e regole di validazione nel tuo design. Questo riduce il codice di validazione boilerplate e assicura una gestione dei dati consistente.

Pronto per iniziare? Parti con l’Installazione per configurare il tuo ambiente di sviluppo Goa-AI.