---
sidebar:
  label: roboto.ai.agent_thread
  order: 1
title: roboto.ai.agent_thread
---
## Submodules

- [roboto.ai.agent_thread.agent_thread](/docs/reference/python-sdk/roboto/ai/agent_thread/agent_thread)
- [roboto.ai.agent_thread.agent_thread_goal_view](/docs/reference/python-sdk/roboto/ai/agent_thread/agent_thread_goal_view)
- [roboto.ai.agent_thread.client_tool](/docs/reference/python-sdk/roboto/ai/agent_thread/client_tool)
- [roboto.ai.agent_thread.event](/docs/reference/python-sdk/roboto/ai/agent_thread/event)
- [roboto.ai.agent_thread.feedback](/docs/reference/python-sdk/roboto/ai/agent_thread/feedback)
- [roboto.ai.agent_thread.record](/docs/reference/python-sdk/roboto/ai/agent_thread/record)

## Package Contents

- [AGENT_CONTENT_MODEL_BY_TYPE](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AGENT_CONTENT_MODEL_BY_TYPE) (data): `AGENT_CONTENT_MODEL_BY_TYPE: dict[AgentContentType, type[AgentContent]]`. The model class for each JSON-serialized content type, keyed by discriminator.

- [AdminUpdateFeedbackRequest](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.AdminUpdateFeedbackRequest) (class): Triage fields editable by Roboto admins.

- [AgentClientContextEntry](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentClientContextEntry) (class): The caller's attached viewing context, carried on their own message.

- [AgentCompressionFillerContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentCompressionFillerContent) (class): Filler standing in for a message the compression deletion pass emptied.

- [AgentContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentContent) (type alias): `type AgentContent = AgentTextContent | AgentToolUseContent | AgentToolResultContent | AgentErrorContent | AgentDeletedContent | AgentCompressionFillerContent | AgentClientContextEntry`. Type alias for all possible content types within agent messages.

- [AgentContentType](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentContentType) (class): Enumeration of different types of content within agent messages.

- [AgentDeletedContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentDeletedContent) (class): Tombstone for a content block removed by compression.

- [AgentErrorContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentErrorContent) (class): Error content within an agent message.

- [AgentErrorEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentErrorEvent) (class): Signals that message generation failed or was cancelled.

- [AgentEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentEvent) (type alias): `type AgentEvent = typing.Union[AgentStartTextEvent, AgentTextDeltaEvent, AgentTextEndEvent, AgentToolUseEvent, AgentToolResultEvent, AgentErrorEvent]`

- [AgentGoalStatus](/reference/python-sdk/roboto/ai/goals/types#roboto.ai.goals.types.AgentGoalStatus) (class): Lifecycle of a per-turn declared goal.

- [AgentMessage](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentMessage) (class): A single message within an agent thread.

- [AgentMessageStatus](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentMessageStatus) (class): Enumeration of possible message generation states.

- [AgentRole](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentRole) (class): Enumeration of possible roles in an agent thread.

- [AgentStartTextEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentStartTextEvent) (class): Signals the beginning of text generation in a chat response.

- [AgentSubtask](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentSubtask) (class): A lightweight checklist item under a top-level task.

- [AgentSubtaskStatus](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentSubtaskStatus) (class): Lifecycle state of a sub-task.

- [AgentTask](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentTask) (class): A top-level task the agent is tracking within a thread.

- [AgentTaskBoundary](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentTaskBoundary) (class): Position in the conversation where a top-level task's active span begins or ends.

- [AgentTaskMinimal](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentTaskMinimal) (class): Minimal acknowledgement returned by the task mutation tools.

- [AgentTaskStatus](/reference/python-sdk/roboto/ai/core/task#roboto.ai.core.task.AgentTaskStatus) (class): Lifecycle state of a top-level agent task.

- [AgentTextContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentTextContent) (class): Text content within an agent message.

- [AgentTextDeltaEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentTextDeltaEvent) (class): Contains incremental text content as the AI generates its response.

- [AgentTextEndEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentTextEndEvent) (class): Signals the completion of text generation in a chat response.

- [AgentThread](/reference/python-sdk/roboto/ai/agent_thread/agent_thread#roboto.ai.agent_thread.agent_thread.AgentThread) (class): An interactive AI agent session within the Roboto platform.

- [AgentThreadDelta](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadDelta) (class): Incremental update to an agent thread.

- [AgentThreadGoalRecord](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadGoalRecord) (class): Customer-visible read shape of a goal declared on an agent thread.

- [AgentThreadGoalView](/reference/python-sdk/roboto/ai/agent_thread/agent_thread_goal_view#roboto.ai.agent_thread.agent_thread_goal_view.AgentThreadGoalView) (class): SDK-side wrapper around an [`AgentThreadGoalRecord`](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadGoalRecord).

- [AgentThreadRecord](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadRecord) (class): Complete record of an agent thread.

- [AgentThreadStatus](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadStatus) (class): Enumeration of possible agent thread states.

- [AgentThreadSubject](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.AgentThreadSubject) (class): Canonical record of an entity an [`AgentThread`](/reference/python-sdk/roboto/ai/agent_thread/agent_thread#roboto.ai.agent_thread.agent_thread.AgentThread) applies to.

- [AgentToolDetailResponse](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.AgentToolDetailResponse) (class): Unsanitized tool request and response details for an agent tool invocation.

- [AgentToolResultContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentToolResultContent) (class): Tool execution result content within an agent message.

- [AgentToolResultEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentToolResultEvent) (class): Contains the result of a tool invocation.

- [AgentToolUseContent](/reference/python-sdk/roboto/ai/core/content#roboto.ai.core.content.AgentToolUseContent) (class): Tool usage request content within an agent message.

- [AgentToolUseEvent](/reference/python-sdk/roboto/ai/core/event#roboto.ai.core.event.AgentToolUseEvent) (class): Signals that the AI is invoking a tool to gather information.

- [AnalysisScope](/reference/python-sdk/roboto/ai/core/context#roboto.ai.core.context.AnalysisScope) (class): The slice of data an agent is expected to analyze.

- [AvailableSkillSpec](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.AvailableSkillSpec) (class): One entry in a thread's explicit AI-invokable skill set.

- [ClientTool](/reference/python-sdk/roboto/ai/agent_thread/client_tool#roboto.ai.agent_thread.client_tool.ClientTool) (class): A client-side tool with an execution callback.

- [ClientToolResult](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.ClientToolResult) (class): Result of executing a client-side tool.

- [ClientToolResultStatus](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.ClientToolResultStatus) (class): Outcome of executing a client-side tool.

- [ClientToolSpec](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.ClientToolSpec) (class): Declarative specification for a client-side tool.

- [FeedbackCategory](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.FeedbackCategory) (class): Taxonomy of feedback categories.

- [FeedbackSentiment](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.FeedbackSentiment) (class): Overall rating direction for a piece of AI-chat feedback.

- [ForkAgentThreadRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.ForkAgentThreadRequest) (class): Request payload for forking an agent thread at a specific message.

- [InvokeSkillSpec](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.InvokeSkillSpec) (class): Spec for invoking a skill as part of a turn trigger.

- [NEGATIVE_CATEGORIES](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.NEGATIVE_CATEGORIES) (data): `NEGATIVE_CATEGORIES: frozenset[FeedbackCategory]`

- [POSITIVE_CATEGORIES](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.POSITIVE_CATEGORIES) (data): `POSITIVE_CATEGORIES: frozenset[FeedbackCategory]`

- [PinThreadRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.PinThreadRequest) (class): Request body for `POST /v1/ai/threads/<thread_id>/pin`, which pins or unpins a thread for the caller.

- [RobotoAgentGoalsFailedException](/reference/python-sdk/roboto/ai/agent_thread/agent_thread#roboto.ai.agent_thread.agent_thread.RobotoAgentGoalsFailedException) (exception): Raised by [`AgentThread.run()`](/reference/python-sdk/roboto/ai/agent_thread/agent_thread#roboto.ai.agent_thread.agent_thread.AgentThread.run) when a goal-bearing turn exhausts its corrective re-prompt budget without satisfying every declared goal.

- [SendMessageRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.SendMessageRequest) (class): Request payload for sending a message to an agent thread.

- [StartAgentThreadRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.StartAgentThreadRequest) (class): Request payload for starting a new agent thread.

- [SubmitFeedbackRequest](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.SubmitFeedbackRequest) (class): Request body for submitting feedback on an assistant message.

- [SubmitToolResultsRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.SubmitToolResultsRequest) (class): Request payload for submitting client-side tool execution results.

- [ThreadOrigin](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.ThreadOrigin) (class): The surface an [`AgentThreadRecord`](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadRecord) was started from, and the one that owns it.

- [ThreadVisibility](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.ThreadVisibility) (class): Read-scope for an [`AgentThreadRecord`](/reference/python-sdk/roboto/ai/core/record#roboto.ai.core.record.AgentThreadRecord).

- [UpdateThreadVisibilityRequest](/reference/python-sdk/roboto/ai/agent_thread/record#roboto.ai.agent_thread.record.UpdateThreadVisibilityRequest) (class): Request payload for re-scoping who may read an agent thread.

- [UserFeedbackRecord](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.UserFeedbackRecord) (class): Customer-facing projection of `AgentFeedbackRecord`.

- [category_is_valid_for_sentiment()](/reference/python-sdk/roboto/ai/agent_thread/feedback#roboto.ai.agent_thread.feedback.category_is_valid_for_sentiment) (function): Report whether `category` is a permitted choice under `sentiment`.

- [client_tool()](/reference/python-sdk/roboto/ai/agent_thread/client_tool#roboto.ai.agent_thread.client_tool.client_tool) (function): Decorator that converts a function into a [`ClientTool`](/reference/python-sdk/roboto/ai/agent_thread/client_tool#roboto.ai.agent_thread.client_tool.ClientTool).