AI Agent (Tool-Calling Loop)

ai_agent_tool_loop · ai · AI & Liara · Disponibile · v1.2.0

Descrizione

Agente con tool-calling: cicla finché il modello non risponde senza richiedere altri tool. Default = Liara (gateway FlowForge, gratis, metered sulla quota); override per-nodo: Anthropic (nativo), OpenAI, Gemini, DeepSeek, xAI, OpenRouter, Groq, Mistral, Ollama. Tool disponibili: http_request, flowforge_invoke, get_time, rag_search.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`provider` LLM provider (opzionale, override)	`enum` `liaraanthropicopenaigeminideepseekxaiopenroutergroqmistralollama`	no	—	Vuoto = usa il default da Settings → AI Providers (Liara free se non configuri nulla). NB: se compili solo la API key senza provider, vale Anthropic (compatibilità con le config esistenti del nodo).
`apiKey` API key (override)	`string (encrypted)`	no	—	Vuoto = chiave da Settings → AI Providers (Liara non ne richiede). Compilata SENZA provider = Anthropic (legacy).
`model` Modello (override)	`string`	no	— es. claude-sonnet-4-5, gpt-4o, gemini-2.0-flash, llama-3.3-70b-versatile	Vuoto = default del provider (Liara: decide il gateway; Anthropic: claude-sonnet-4-5).
`baseUrl` Base URL (per Ollama / self-hosted)	`string`	no	— http://localhost:11434	—
`systemPrompt` System prompt	`expression`	no	`You are a senior automation agent. Use the available tools (http_request, flowforge_invoke, get_time, rag_search) to accomplish the user's goal. Be concise.`	Direttive di ruolo/tono/regole. Supporta {{espressioni}} per iniettare contesto dinamico (es. {{ctx.tenantId}}).
`goal` Obiettivo (default = input)	`expression`	no	— Riassumi gli ordini di {{$today}} e mandami una notifica Slack	Cosa l'agent deve fare. Se vuoto, usa l'output del nodo precedente come obiettivo.
`maxIterations` Iterazioni massime	`number`	no	`10`	Quanti round tool-call → modello al massimo. Il modello chiama tool, vede l'output, decide se chiamare altri tool o rispondere. Cap anti-loop infinito.
`embedProvider` Provider embedding (per rag_search)	`enum` `openaivoyageollama`	no	`openai`	Usato solo se l'agent invoca il tool rag_search. Deve matchare il provider con cui hai popolato il vector DB.
`embedApiKey` API key embedding	`string (encrypted)`	no	—	Necessaria per openai/voyage. Vuoto per ollama (locale).
`embedModel` Modello embedding	`string`	no	— text-embedding-3-small / voyage-3 / nomic-embed-text	Modello del provider scelto. DEVE matchare quello usato per popolare il vector DB.
`defaultRagDatabaseId` Knowledge base default (DB vettoriale)	`db-picker`	no	—	Se impostato, l'agente sa dove cercare quando invoca rag_search senza specificare il DB. Mantieni vuoto per richiederlo nel prompt.
`defaultRagCollection` Collezione knowledge base	`db-collection-picker`	no	—	Collezione (namespace) all'interno del DB selezionato sopra.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-ai_agent_tool_loop-1",
  "defId": "ai_agent_tool_loop",
  "label": "AI Agent (Tool-Calling Loop)",
  "config": {
    "systemPrompt": "You are a senior automation agent. Use the available tools (http_request, flowforge_invoke, get_time, rag_search) to accomplish the user's goal. Be concise.",
    "maxIterations": 10,
    "embedProvider": "openai"
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare AI Agent (Tool-Calling Loop)?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi