v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1336218221.3 KB
projects

Creates a new agent in the given app.

post/v1/{+parent}/agents

Path parameters

parentstring required

Required. The resource name of the app to create an agent in.

Query parameters

agentIdstring

Optional. The ID to use for the agent, which will become the final component of the agent's resource name. If not provided, a unique ID will be automatically assigned for the agent.

Request body

toolsstring[]

Optional. List of available tools for the agent. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool}

etagstring

Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.

generatedSummarystring

Output only. If the agent is generated by the LLM assistant, this field contains a descriptive summary of the generation.

childAgentsstring[]

Optional. List of child agents in the agent tree. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

validationErrorsstring[]

Output only. Misconfigurations or errors in the agent that may affect agent quality.

llmAgentAgentLlmAgent

Default agent type. The agent uses instructions and callbacks specified in the agent to perform the task using a large language model.

displayNamestring

Required. Display name of the agent.

guardrailsstring[]

Optional. List of guardrails for the agent. Format: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}

instructionstring

Optional. Instructions for the LLM model to guide the agent's behavior.

descriptionstring

Optional. Human-readable description of the agent.

createTimestring google-datetime

Output only. Timestamp when the agent was created.

updateTimestring google-datetime

Output only. Timestamp when the agent was last updated.

namestring

Identifier. The unique identifier of the agent. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

Response

Successful response