Agent

Usa questa pagina per consultare prompt, modelli, tool, budget e subagenti di un agente.

Limiti

spec:
  limits:
    maxToolOutputTokens: 8000      # un output più lungo viene tagliato, con una nota al modello
    maxSubmitRetries: 2            # messaggi correttivi prima che il turno fallisca
    summarizeTokens: 60000         # riassume il contesto oltre questi token; null lo spegne
    summarizeKeepMessages: 20      # gli ultimi messaggi restano sempre

Campi

AgentSpec (spec)

Campo	Tipo	Predefinito	Significato
harness	str	basic	L'harness che esegue l'agente: basic, deep, acp o quello di un plugin.
systemPrompt	str or null	null	Il prompt inline, oppure None quando è un file.
systemPromptFile	str or null	null	Il prompt come file accanto al manifest.
writes	str	required	Lo Schema dell'artefatto che l'agente produce.
reads	list[str]	[]	Gli artefatti che l'agente legge; un nome che finisce con ? è facoltativo.
budget	Budget	Budget()	I tetti di budget dell'agente.
limits	AgentLimits	AgentLimits()	I limiti dell'harness.
model	str or null	null	L'alias di modello con cui partire, per l'harness basic.
tools	list[str]	[]	I tool che l'agente può chiamare, per nome.
workspaceAccess	read or write or null	null	deep: accesso read o write al workspace.
execute	bool	False	deep: se l'agente può eseguire comandi nella sandbox.
extraTools	list[str]	[]	deep: tool built-in aggiunti all'insieme predefinito.
subagents	list[SubagentSpec]	[]	deep: i subagenti a cui l'agente può passare lavoro.
agent	str or null	null	acp: il manifest AcpAgent che l'agente esegue.
permissions	dict[str, allow or deny or ask]	{}	acp: il permesso iniziale per nome di tool.

Budget (spec.budget)

Campo	Tipo	Predefinito	Significato
tokens	int or null	null	Il tetto di token.
toolCalls	int or null	null	Il tetto di chiamate ai tool.
costUsd	float or null	null	Il tetto di costo in dollari USA.
wallTime	duration or null	null	Il tetto di tempo reale.
maxTurns	int or null	null	Il tetto di turni.

AgentLimits (spec.limits)

Campo	Tipo	Predefinito	Significato
maxToolOutputTokens	int	8000	I token di un risultato di tool tenuti prima che venga tagliato.
maxSubmitRetries	int	2	Quante volte l'harness ritenta una sottomissione di artefatto rifiutata.
summarizeTokens	int or null	60000	Riassume il contesto oltre questi token; null lo spegne.
summarizeKeepMessages	int	20	Quanti messaggi recenti il riassunto tiene alla lettera.

SubagentSpec (spec.subagents)

Campo	Tipo	Predefinito	Significato
name	str	required	Il nome del subagente, come lo chiama il genitore.
description	str	required	A cosa serve il subagente; il genitore lo vede.
systemPrompt	str or null	null	Il prompt inline, oppure None quando è un file.
systemPromptFile	str or null	null	Il prompt come file accanto al manifest.
tools	list[str]	[]	I tool che il subagente può chiamare: un sottoinsieme di quelli del genitore.
model	str or null	null	L'alias di modello; ereditato dal genitore quando assente.

Vedi anche

• Tool built-in per i requisiti di accesso.
• Model per provider e prezzi.
• Flow per i nodi agent.