Avvio rapido
Genera ed esegui un agente IA locale, poi aggiungi planner, tool tipizzati e integrazione con il modello.
Goa-AI: agenti da un progetto
Progetta tool tipizzati e contratti degli agenti in Go. Genera il codice di integrazione e usa un modello di esecuzione esplicito.
Panoramica
Goa-AI estende linguaggio e generatore di Goa alle applicazioni IA. Definisci agenti, input e risultati dei tool, completamenti strutturati, politiche e scenari di valutazione. Genera tipi, schemi, codec e collegamenti; scrivi planner e comportamento applicativo.
Crea il primo agente o segui il flusso con un agente di coding. Non serve distribuire prima un servizio Goa separato.
Sviluppa con un agente di coding
Schemi e codec Go derivano dallo stesso progetto. Un tool può riusare tipi e implementazione di un servizio tramite BindTo. La generazione produce anche AGENTS_QUICKSTART.md, una guida basata sul tuo progetto. Forniscila all’agente insieme ai file di design, poi implementa planner ed esecutori fuori da gen/. Rigenera, compila ed esegui valutazioni a ogni evoluzione.
Questo evita di far scrivere al modello schemi e integrazioni ripetitivi. Non implica una percentuale fissa di risparmio: misura compiti completi, inclusi contesto, tentativi e revisione.
Integra agenti nel prodotto
Contratti dei tool
Definisci input e risultati con tipi Goa, descrizioni, esempi e validazione. Il generatore produce schemi JSON e codec tipizzati. Gli argomenti del modello vengono validati prima dell’esecuzione. Vedi toolset.
Output strutturato
Completion(...) dichiara una risposta tipizzata. Gli helper generati, anche streaming, validano il risultato completo. Vedi DSL e runtime.
Valutazioni
Dichiara suite e scenari, genera hook tipizzati e implementa verifiche sugli esiti. La valutazione semantica richiede calibrazione. Vedi valutazioni generate.
Composizione
Esponi un agente come tool di un altro. Le esecuzioni figlie hanno identità, legami al genitore e cronologia. Vedi composizione.
Streaming
Il runtime emette eventi tipizzati per risposte, avanzamento dei tool, input umano e stato. L’applicazione decide cosa esporre e come trasportarlo. Vedi streaming.
Esecuzione durevole
Usa il motore in memoria in locale. Configura Temporal per persistenza, ripristino e retry delle attività. Gli effetti esterni richiedono idempotenza e politiche di retry appropriate nell’applicazione. Vedi produzione.
Server MCP e tool registry da ospitare
Crea server MCP. Esponi metodi come tool, pubblica risorse e fornisci template di prompt con gestione del protocollo e adapter generati. Gli agenti possono anche usare tool MCP esterni. Vedi integrazione MCP.
Ospita un tool registry. Esegui il server incluso come catalogo condiviso e gateway di invocazione basato su Redis e Pulse. I provider pubblicano toolset e schemi; i consumer scoprono tool e invocano provider sani. Gli helper generati collegano le applicazioni al registry. Vedi gestione del registry.
Modelli e stato
Sono disponibili adapter per OpenAI, Anthropic, AWS Bedrock e Google Vertex AI. Le capacità variano: consulta il runtime. L’applicazione fornisce storage e controlla sessioni, autorizzazione e memoria. Vedi memoria e sessioni.
Architettura
Il progetto possiede i contratti statici; il codice generato li rende pacchetti tipizzati. Il runtime coordina l’esecuzione e il motore fornisce workflow locali o durevoli. I planner decidono sul significato; i servizi applicativi possiedono il comportamento di business.
Guide
Inizia dal quickstart locale, poi aggiungi tool, modelli, stato e distribuzione. Consulta DSL e runtime per i contratti esatti.