Unary · Agents
Starts (or triggers) an agent run using a provided agent.
Use this method to:
- Launch an agent based on a known agent
Examples
-
Start an agent with a project ID:
Endpoint
https://app.ona.com with that domain.
Request example
Request
gitpod.v1.StartAgentRequest
Response
gitpod.v1.StartAgentResponse
Related types
AgentCodeContext
AgentCodeContext
gitpod.v1.AgentCodeContextContextURL
ContextURL
gitpod.v1.AgentCodeContext.ContextURLCodexSettings
CodexSettings
CodexSettings contains settings consumed only by the Codex app agent.
gitpod.v1.CodexSettingsPullRequest
PullRequest
PullRequest represents pull request metadata from source control systems.
This message is used across workflow triggers, executions, and agent contexts
to maintain consistent PR information throughout the system.
gitpod.v1.PullRequestTurnOptions
TurnOptions
gitpod.v1.TurnOptionsAgentMode
AgentMode
AgentMode defines the operational mode of an agent
CodexOpenAIModel
CodexOpenAIModel
CodexOpenAIModel is the static allowlist of concrete OpenAI models that the
Codex app runtime can select through Ona’s Codex picker.
CodexReasoningEffort
CodexReasoningEffort
CodexReasoningEffort is the static allowlist of reasoning efforts supported
by the Codex app runtime.
CodexServiceTier
CodexServiceTier
CodexServiceTier is the static allowlist of service tiers supported by the
Codex app runtime.
State
State
Current state of the pull request