LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • Client
  • AsyncClient
  • Run Helpers
  • Run Trees
  • Evaluation
  • Schemas
  • Utilities
  • Wrappers
  • Anonymizer
  • Testing
  • Expect API
  • Middleware
  • Pytest Plugin
  • Deployment SDK
⌘I

Chat LangChain

What can I help with?

Enter to send·Shift+Enter new line

Menu

OverviewClientAsyncClientRun HelpersRun TreesEvaluationSchemasUtilitiesWrappersAnonymizerTestingExpect APIMiddlewarePytest PluginDeployment SDK
Language
Theme
PythonlangsmithresourcesagentsAsyncAgentsResource
Class●Since v0.14

AsyncAgentsResource

Copy
AsyncAgentsResource(
    self,
    client: AsyncLangsmith,
)

Bases

AsyncAPIResource

Methods

View source on GitHub
method
with_raw_response
method
with_streaming_response
method
create
method
retrieve
method
update
method
list
method
delete

This property can be used as a prefix for any HTTP method call to return the raw response object instead of the parsed content.

For more information, see https://www.github.com/langchain-ai/langsmith-python#accessing-raw-response-data-eg-headers

An alternative to .with_raw_response that doesn't eagerly read the response body.

For more information, see https://www.github.com/langchain-ai/langsmith-python#with_streaming_response

Creates an Agent with a caller-assigned ID.

Returns 409 if the ID already exists. Creates all four environments unless production_only is set for a FLEET agent. agent_type defaults to CUSTOM. Requires permission to create projects. The response does not include runtime bindings.

Returns an Agent with the environments visible to the caller.

The path value is the user-assigned Agent ID. Pass include=runtime_bindings to embed each environment's runtime bindings.

Updates an Agent's name, source_type, or agent_type.

Omitted fields keep their values. Changing agent_type requires workspaces:manage in addition to project update access; repeating the current type is a no-op. Source type can change only for an EXTERNAL Agent without runtime bindings. The id is immutable and is rejected when present. Requires update permission on every environment project.

Returns Agents visible to the caller.

Each item is the same Agent shape as GET /api/v1/agents/{agent_id}, including the environments the caller may read. The list never embeds runtime bindings. An unknown query parameter, including limit, returns 400; use page_size to set the page size.

Permanently deletes an Agent, along with its environments, runtime bindings, runtimes, and tracing projects. This cannot be undone. Deleting an Agent that does not exist returns 204.