Letta Agents MCP Server

openapi-mcp-server

Letta API 用のモデル コンテキスト プロトコル (MCP) サーバー。

説明

このサーバーは、API へのモデル コンテキスト プロトコル (MCP) インターフェイスを提供します。

インストール

1. 依存関係をインストールします:

2. .env.exampleに基づいて.envファイルを作成します。

3. .envファイルを編集して、API 構成と承認の詳細を追加します。

構成

.envファイルでは次の環境変数を設定できます。

• API_BASE_URL : APIのベースURL（必須）
• SERVER_NAME : MCPサーバーの名前（デフォルト: "openapi-mcp-server")
• SERVER_VERSION : MCPサーバーのバージョン（デフォルト: "1.0.0"）
• DEBUG : デバッグログを有効にする (true/false) (デフォルト: false)

使用法

サーバーの実行

サーバーは、JavaScript バージョンと TypeScript バージョンの両方で提供されます。

TypeScriptバージョンのビルド

MCPツールプロバイダーとしての使用

このサーバーはモデルコンテキストプロトコル (MCP) を実装しており、Claude.js クライアントやその他の MCP コンシューマーなど、MCP 互換のコンシューマーで使用できます。

Claude.js クライアントからこのサーバーに接続する例:

利用可能なツール

この MCP サーバーは次のツールを提供します。

削除ツール

• ID : DELETE-v1-tools-tool-id
• 説明: 名前でツールを削除します
• 方法: DELETE
• パス: /v1/tools/{tool_id}

パラメータ:

• tool_id : tool_idパラメータ（必須）
• user_id : user_idパラメータ

取得ツール

• ID : GET-v1-tools-tool-id
• 説明: IDでツールを取得する
• メソッド: GET
• パス: /v1/tools/{tool_id}

パラメータ:

• tool_id : tool_idパラメータ（必須）
• user_id : user_idパラメータ

修正ツール

• ID : PATCH-v1-tools-tool-id
• 説明: 既存のツールを更新する
• 方法： PATCH
• パス: /v1/tools/{tool_id}

パラメータ:

• tool_id : tool_idパラメータ（必須）
• user_id : user_idパラメータ

リストツール

• ID : GET-v1-tools-
• 説明: ユーザーの組織に属するエージェントが利用できるすべてのツールのリストを取得します
• メソッド: GET
• パス: /v1/tools/

パラメータ:

• after : パラメータの後
• limit : 制限パラメータ
• name : 名前パラメータ
• user_id : user_idパラメータ

作成ツール

• ID : POST-v1-tools-
• 説明: 新しいツールを作成する
• メソッド: POST
• パス: /v1/tools/

パラメータ:

• user_id : user_idパラメータ

upsert_tool

• ID : PUT-v1-tools-
• 説明: ツールを作成または更新する
• メソッド: PUT
• パス: /v1/tools/

パラメータ:

• user_id : user_idパラメータ

ベースツールを追加する

• ID : POST-v1-tools-add-base-tools
• 説明: アップサートベースツール
• メソッド: POST
• パス: /v1/tools/add-base-tools

パラメータ:

• user_id : user_idパラメータ

ソースからツールを実行する

• ID : POST-v1-tools-run
• 説明: ソースからツールをビルドし、指定された引数で実行します
• メソッド: POST
• パス: /v1/tools/run

パラメータ:

• user_id : user_idパラメータ

リスト_コンポジション_アプリ

• ID : GET-v1-tools-composio-apps
• 説明: すべての Composio アプリのリストを取得します
• メソッド: GET
• パス: /v1/tools/composio/apps

パラメータ:

• user-id : ユーザーIDパラメータ

アプリごとのコンポジションアクションのリスト

• ID : GET-v1-tools-composio-apps-composio-app-name-actions
• 説明: 特定のアプリのすべての Composio アクションのリストを取得します
• メソッド: GET
• パス: /v1/tools/composio/apps/{composio_app_name}/actions

パラメータ:

• composio_app_name : composio_app_name パラメーター (必須)
• user_id : user_idパラメータ

追加コンポジションツール

• ID : POST-v1-tools-composio-composio-action-name
• 説明: アクション名で新しい Composio ツールを追加します (Composio は各ツールをActionと呼びます)
• メソッド: POST
• パス: /v1/tools/composio/{composio_action_name}

パラメータ:

• composio_action_name : composio_action_name パラメータ（必須）
• user_id : user_idパラメータ

mcp_servers の一覧

• ID : GET-v1-tools-mcp-servers
• 説明: 設定されているすべてのMCPサーバーのリストを取得します
• メソッド: GET
• パス: /v1/tools/mcp/servers

パラメータ:

• user-id : ユーザーIDパラメータ

add_mcp_server

• ID : PUT-v1-tools-mcp-servers
• 説明: Letta MCP サーバー構成に新しい MCP サーバーを追加します
• メソッド: PUT
• パス: /v1/tools/mcp/servers

パラメータ:

• user_id : user_idパラメータ

list_mcp_tools_by_server

• ID : GET-v1-tools-mcp-servers-mcp-server-name-tools
• 説明: 特定のMCPサーバーのすべてのツールのリストを取得します
• メソッド: GET
• パス: /v1/tools/mcp/servers/{mcp_server_name}/tools

パラメータ:

• mcp_server_name : mcp_server_name パラメータ（必須）
• user_id : user_idパラメータ

追加_mcp_ツール

• ID : POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-name
• 説明: MCPサーバー+ツール名で新しいMCPツールをLettaサーバーとして登録します
• メソッド: POST
• パス: /v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}

パラメータ:

• mcp_server_name : mcp_server_name パラメータ（必須）
• mcp_tool_name : mcp_tool_name パラメータ（必須）
• user_id : user_idパラメータ

削除_mcp_server

• ID : DELETE-v1-tools-mcp-servers-mcp-server-name
• 説明: Letta MCP サーバー構成に新しい MCP サーバーを追加します
• 方法: DELETE
• パス: /v1/tools/mcp/servers/{mcp_server_name}

パラメータ:

• mcp_server_name : mcp_server_name パラメータ（必須）
• user_id : user_idパラメータ

取得元

• ID : GET-v1-sources-source-id
• 説明: すべてのソースを取得
• メソッド: GET
• パス: /v1/sources/{source_id}

パラメータ:

• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

ソースの変更

• ID : PATCH-v1-sources-source-id
• 説明: 既存のデータ ソースの名前またはドキュメントを更新します。
• 方法： PATCH
• パス: /v1/sources/{source_id}

パラメータ:

• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

削除元

• ID : DELETE-v1-sources-source-id
• 説明: データ ソースを削除します。
• 方法: DELETE
• パス: /v1/sources/{source_id}

パラメータ:

• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

名前でソースIDを取得する

• ID : GET-v1-sources-name-source-name
• 説明: 名前でソースを取得する
• メソッド: GET
• パス: /v1/sources/name/{source_name}

パラメータ:

• source_name : source_nameパラメータ（必須）
• user_id : user_idパラメータ

リストソース

• ID : GET-v1-sources-
• 説明: ユーザーが作成したすべてのデータ ソースを一覧表示します。
• メソッド: GET
• パス: /v1/sources/

パラメータ:

• user_id : user_idパラメータ

作成ソース

• ID : POST-v1-sources-
• 説明: 新しいデータ ソースを作成します。
• メソッド: POST
• パス: /v1/sources/

パラメータ:

• user_id : user_idパラメータ

ソースにファイルをアップロードする

• ID : POST-v1-sources-source-id-upload
• 説明: データ ソースにファイルをアップロードします。
• メソッド: POST
• パス: /v1/sources/{source_id}/upload

パラメータ:

• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

リストソースパッセージ

• ID : GET-v1-sources-source-id-passages
• 説明: データ ソースに関連付けられているすべてのパッセージを一覧表示します。
• メソッド: GET
• パス: /v1/sources/{source_id}/passages

パラメータ:

• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

ソースファイルのリスト

• ID : GET-v1-sources-source-id-files
• 説明: データ ソースに関連付けられたページ分割されたファイルを一覧表示します。
• メソッド: GET
• パス: /v1/sources/{source_id}/files

パラメータ:

• source_id : source_idパラメータ（必須）
• limit : 返されるファイルの数
• after : 次の結果セットを取得するためのページネーションカーソル
• user_id : user_idパラメータ

ソースからファイルを削除する

• ID : DELETE-v1-sources-source-id-file-id
• 説明: データ ソースを削除します。
• 方法: DELETE
• パス: /v1/sources/{source_id}/{file_id}

パラメータ:

• source_id : source_idパラメータ（必須）
• file_id : file_idパラメータ（必須）
• user_id : user_idパラメータ

エージェント一覧

• ID : GET-v1-agents-
• 説明: 特定のユーザーに関連付けられているすべてのエージェントを一覧表示します。

このエンドポイントは、指定されたユーザー ID に関連付けられているすべてのエージェントとその構成のリストを取得します。

• メソッド: GET
• パス: /v1/agents/

パラメータ:

• name : エージェントの名前
• tags : エージェントをフィルタリングするためのタグのリスト
• match_all_tags : True の場合、指定されたタグのすべてに一致するエージェントのみを返します。それ以外の場合は、渡されたタグのいずれかを持つエージェントを返します。
• before : ページ区切りのカーソル
• after : ページ区切りのカーソル
• limit : ページネーションの制限
• query_text : エージェントを名前で検索
• project_id : プロジェクトIDでエージェントを検索
• template_id : テンプレートIDでエージェントを検索
• base_template_id : ベーステンプレートIDでエージェントを検索
• identity_id : ID IDでエージェントを検索
• identifier_keys : 識別子キーでエージェントを検索
• include_relationships : レスポンスに含めるリレーショナルフィールド（例：'tools'、'sources'、'memory'）を指定します。指定しない場合は、デフォルトですべてのリレーションシップが読み込まれます。このオプションを使用すると、不要な結合が削減され、パフォーマンスを最適化できます。
• ascending : エージェントを古い順に並べ替える(True)か、新しい順に並べ替える(False、デフォルト)か
• user_id : user_idパラメータ

エージェント作成

• ID : POST-v1-agents-
• 説明: 指定された構成で新しいエージェントを作成します。
• メソッド: POST
• パス: /v1/agents/

パラメータ:

• user_id : user_idパラメータ
• X-Project : X-Projectパラメータ

エクスポートエージェントのシリアル化

• ID : GET-v1-agents-agent-id-export
• 説明: エージェントのシリアル化された JSON 表現をエクスポートします。
• メソッド: GET
• パス: /v1/agents/{agent_id}/export

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

インポートエージェントのシリアル化

• ID : POST-v1-agents-import
• 説明: シリアル化されたエージェント ファイルをインポートし、システムにエージェントを再作成します。
• メソッド: POST
• パス: /v1/agents/import

パラメータ:

• append_copy_suffix : True に設定すると、エージェント名の末尾に「_copy」が追加されます。
• override_existing_tools : True に設定すると、アップロードされたツール定義によって既存のツールのソースコードが上書きされます。Letta コアツールは外部から更新できないことに注意してください。
• project_id : アップロードされたエージェントを関連付けるプロジェクト ID。
• user_id : user_idパラメータ

エージェントコンテキストウィンドウの取得

• ID : GET-v1-agents-agent-id-context
• 説明: 特定のエージェントのコンテキスト ウィンドウを取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/context

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントの変更

• ID : PATCH-v1-agents-agent-id
• 説明: 既存のエージェントを更新する
• 方法： PATCH
• パス: /v1/agents/{agent_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

取得エージェント

• ID : GET-v1-agents-agent-id
• 説明: エージェントの状態を取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

エージェント削除

• ID : DELETE-v1-agents-agent-id
• 説明: エージェントを削除します。
• 方法: DELETE
• パス: /v1/agents/{agent_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

リストエージェントツール

• ID : GET-v1-agents-agent-id-tools
• 説明: 既存のエージェントからツールを取得する
• メソッド: GET
• パス: /v1/agents/{agent_id}/tools

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

アタッチツール

• ID : PATCH-v1-agents-agent-id-tools-attach-tool-id
• 説明: エージェントにツールをアタッチします。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/tools/attach/{tool_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• tool_id : tool_idパラメータ（必須）
• user_id : user_idパラメータ

デタッチツール

• ID : PATCH-v1-agents-agent-id-tools-detach-tool-id
• 説明: エージェントからツールをデタッチします。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/tools/detach/{tool_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• tool_id : tool_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントにソースをアタッチする

• ID : PATCH-v1-agents-agent-id-sources-attach-source-id
• 説明: エージェントにソースを接続します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/sources/attach/{source_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントからソースをデタッチする

• ID : PATCH-v1-agents-agent-id-sources-detach-source-id
• 説明: エージェントからソースを切り離します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/sources/detach/{source_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• source_id : source_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントソースのリスト

• ID : GET-v1-agents-agent-id-sources
• 説明: エージェントに関連付けられたソースを取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/sources

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントのメモリ取得

• ID : GET-v1-agents-agent-id-core-memory
• 説明: 特定のエージェントのメモリ状態を取得します。このエンドポイントは、ユーザーIDとエージェントIDで識別されるエージェントの現在のメモリ状態を取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/core-memory

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

コアメモリブロックの取得

• ID : GET-v1-agents-agent-id-core-memory-blocks-block-label
• 説明: エージェントからコア メモリ ブロックを取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• block_label : block_labelパラメータ（必須）
• user_id : user_idパラメータ

コアメモリブロックの変更

• ID : PATCH-v1-agents-agent-id-core-memory-blocks-block-label
• 説明: エージェントのコア メモリ ブロックを更新します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• block_label : block_labelパラメータ（必須）
• user_id : user_idパラメータ

コアメモリブロックの一覧

• ID : GET-v1-agents-agent-id-core-memory-blocks
• 説明: 特定のエージェントのコア メモリ ブロックを取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/core-memory/blocks

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

コアメモリブロックを接続する

• ID : PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-id
• 説明: コア メモリ ブロックをエージェントに接続します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

コアメモリブロックのデタッチ

• ID : PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-id
• 説明: エージェントからコア メモリ ブロックをデタッチします。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

リストパッセージ

• ID : GET-v1-agents-agent-id-archival-memory
• 説明: エージェントのアーカイブ メモリ ストア内のメモリを取得します (ページ分割されたクエリ)。
• メソッド: GET
• パス: /v1/agents/{agent_id}/archival-memory

パラメータ:

• agent_id : agent_idパラメータ（必須）
• after : クエリ範囲を開始するメモリの一意の ID。
• before : クエリ範囲を終了するメモリの一意の ID。
• limit : レスポンスに含める結果の数。
• search : テキストで文章を検索
• ascending : 文章を古い順に並べ替えるか(True、デフォルト)、新しい順に並べ替えるか(False)
• user_id : user_idパラメータ

パスの作成

• ID : POST-v1-agents-agent-id-archival-memory
• 説明: エージェントのアーカイブ メモリ ストアにメモリを挿入します。
• メソッド: POST
• パス: /v1/agents/{agent_id}/archival-memory

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

文章の変更

• ID : PATCH-v1-agents-agent-id-archival-memory-memory-id
• 説明: エージェントのアーカイブ メモリ ストア内のメモリを変更します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/archival-memory/{memory_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• memory_id : メモリIDパラメータ（必須）
• user_id : user_idパラメータ

削除する

• ID : DELETE-v1-agents-agent-id-archival-memory-memory-id
• 説明: エージェントのアーカイブ メモリ ストアからメモリを削除します。
• 方法: DELETE
• パス: /v1/agents/{agent_id}/archival-memory/{memory_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• memory_id : メモリIDパラメータ（必須）
• user_id : user_idパラメータ

リストメッセージ

• ID : GET-v1-agents-agent-id-messages
• 説明: エージェントのメッセージ履歴を取得します。
• メソッド: GET
• パス: /v1/agents/{agent_id}/messages

パラメータ:

• agent_id : agent_idパラメータ（必須）
• after : 返されるメッセージを取得する前のメッセージ。
• before : 返されるメッセージを取得する前のメッセージ。
• limit : 取得するメッセージの最大数。
• use_assistant_message : アシスタントメッセージを使用するかどうか
• assistant_message_tool_name : 指定されたメッセージ ツールの名前。
• assistant_message_tool_kwarg : メッセージ引数の名前。
• user_id : user_idパラメータ

メッセージを送信

• ID : POST-v1-agents-agent-id-messages
• 説明: ユーザーメッセージを処理し、エージェントの応答を返します。このエンドポイントはユーザーからのメッセージを受け取り、エージェントを介して処理します。
• メソッド: POST
• パス: /v1/agents/{agent_id}/messages

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

メッセージの変更

• ID : PATCH-v1-agents-agent-id-messages-message-id
• 説明: エージェントに関連付けられたメッセージの詳細を更新します。
• 方法： PATCH
• パス: /v1/agents/{agent_id}/messages/{message_id}

パラメータ:

• agent_id : agent_idパラメータ（必須）
• message_id : message_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントメッセージストリームの作成

• ID : POST-v1-agents-agent-id-messages-stream
• 説明: ユーザーメッセージを処理し、エージェントのレスポンスを返します。このエンドポイントはユーザーからのメッセージを受け取り、エージェントを介して処理します。レスポンスのステップは常にストリーミングされ、'stream_tokens' が True に設定されている場合はトークンもストリーミングされます。
• メソッド: POST
• パス: /v1/agents/{agent_id}/messages/stream

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

エージェントメッセージ非同期作成

• ID : POST-v1-agents-agent-id-messages-async
• 説明: ユーザーメッセージを非同期に処理し、実行オブジェクトを返します。実際の処理はバックグラウンドで行われ、実行IDを使用してステータスを確認できます。
• メソッド: POST
• パス: /v1/agents/{agent_id}/messages/async

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

リセットメッセージ

• ID : PATCH-v1-agents-agent-id-reset-messages
• 説明: エージェントのメッセージをリセットします
• 方法： PATCH
• パス: /v1/agents/{agent_id}/reset-messages

パラメータ:

• agent_id : agent_idパラメータ（必須）
• add_default_initial_messages : true の場合、リセット後にデフォルトの初期メッセージを追加します。
• user_id : user_idパラメータ

グループを作成する

• ID : POST-v1-groups-
• 説明: 指定された構成で新しいマルチエージェント グループを作成します。
• メソッド: POST
• パス: /v1/groups/

パラメータ:

• user_id : user_idパラメータ
• X-Project : X-Projectパラメータ

リストグループ

• ID : GET-v1-groups-
• 説明: クエリに一致するすべてのマルチエージェント グループを取得します。
• メソッド: GET
• パス: /v1/groups/

パラメータ:

• manager_type : マネージャーの種類でグループを検索
• before : ページ区切りのカーソル
• after : ページ区切りのカーソル
• limit : ページ区切りの制限
• project_id : プロジェクトIDでグループを検索
• user_id : user_idパラメータ

upsert_group

• ID : PUT-v1-groups-
• 説明: 指定された構成で新しいマルチエージェント グループを作成します。
• メソッド: PUT
• パス: /v1/groups/

パラメータ:

• user_id : user_idパラメータ
• X-Project : X-Projectパラメータ

グループを削除

• ID : DELETE-v1-groups-group-id
• 説明: マルチエージェント グループを削除します。
• 方法: DELETE
• パス: /v1/groups/{group_id}

パラメータ:

• group_id : group_idパラメータ（必須）
• user_id : user_idパラメータ

グループメッセージを送信する

• ID : POST-v1-groups-group-id-messages
• 説明: ユーザーメッセージを処理し、グループのレスポンスを返します。このエンドポイントは、ユーザーからのメッセージを受け取り、指定されたパターンに基づいてグループ内のエージェントを通じてメッセージを処理します。
• メソッド: POST
• パス: /v1/groups/{group_id}/messages

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user_id : user_idパラメータ

グループメッセージ一覧

• ID : GET-v1-groups-group-id-messages
• 説明: エージェントのメッセージ履歴を取得します。
• メソッド: GET
• パス: /v1/groups/{group_id}/messages

パラメータ:

• group_id : group_idパラメータ（必須）
• after : 返されるメッセージを取得する前のメッセージ。
• before : 返されるメッセージを取得する前のメッセージ。
• limit : 取得するメッセージの最大数。
• use_assistant_message : アシスタントメッセージを使用するかどうか
• assistant_message_tool_name : 指定されたメッセージ ツールの名前。
• assistant_message_tool_kwarg : メッセージ引数の名前。
• user_id : user_idパラメータ

グループメッセージのストリーミング送信

• ID : POST-v1-groups-group-id-messages-stream
• 説明: ユーザーメッセージを処理し、グループのレスポンスを返します。このエンドポイントは、ユーザーからのメッセージを受け取り、指定されたパターンに基づいてグループ内のエージェントを介して処理します。レスポンスのステップは常にストリーミングされ、'stream_tokens' が True に設定されている場合はトークンもストリーミングされます。
• メソッド: POST
• パス: /v1/groups/{group_id}/messages/stream

パラメータ:

• group_id : group_idパラメータ（必須）
• user_id : user_idパラメータ

リストID

• ID : GET-v1-identities-
• 説明: データベース内のすべてのIDのリストを取得します
• メソッド: GET
• パス: /v1/identities/

パラメータ:

• name : 名前パラメータ
• project_id : project_idパラメータ
• identifier_key : identifier_key パラメータ
• identity_type : identity_typeパラメータ
• before : 前のパラメータ
• after : パラメータの後
• limit : 制限パラメータ
• user_id : user_idパラメータ

アイデンティティ作成

• ID : POST-v1-identities-
• 説明: /v1/identities/ に POST リクエストを送信します
• メソッド: POST
• パス: /v1/identities/

パラメータ:

• user_id : user_idパラメータ
• X-Project : X-Projectパラメータ

upsert_identity

• ID : PUT-v1-identities-
• 説明: /v1/identities/ に PUT リクエストを送信します。
• メソッド: PUT
• パス: /v1/identities/

パラメータ:

• user_id : user_idパラメータ
• X-Project : X-Projectパラメータ

ID取得

• ID : GET-v1-identities-identity-id
• 説明: /v1/identities/{identity_id} に GET リクエストを送信します。
• メソッド: GET
• パス: /v1/identities/{identity_id}

パラメータ:

• identity_id : identity_idパラメータ（必須）
• user_id : user_idパラメータ

更新ID

• ID : PATCH-v1-identities-identity-id
• 説明: /v1/identities/{identity_id} に PATCH リクエストを送信します
• 方法： PATCH
• パス: /v1/identities/{identity_id}

パラメータ:

• identity_id : identity_idパラメータ（必須）
• user_id : user_idパラメータ

削除ID

• ID : DELETE-v1-identities-identity-id
• 説明: 識別子キーでアイデンティティを削除します
• 方法: DELETE
• パス: /v1/identities/{identity_id}

パラメータ:

• identity_id : identity_idパラメータ（必須）
• user_id : user_idパラメータ

リストモデル

• ID : GET-v1-models-
• 説明: /v1/models/ に GET リクエストを送信します
• メソッド: GET
• パス: /v1/models/

パラメータは必要ありません。

リスト埋め込みモデル

• ID : GET-v1-models-embedding
• 説明: /v1/models/embedding に GET リクエストを送信します
• メソッド: GET
• パス: /v1/models/embedding

パラメータは必要ありません。

リストブロック

• ID : GET-v1-blocks-
• 説明: /v1/blocks/ に GET リクエストを送信します
• メソッド: GET
• パス: /v1/blocks/

パラメータ:

• label : 含めるラベル (例: human、persona)
• templates_only : テンプレートのみを含めるかどうか
• name : ブロックの名前
• identity_id : 識別子IDでエージェントを検索
• identifier_keys : 識別子キーでエージェントを検索
• user_id : user_idパラメータ

ブロックを作成する

• ID : POST-v1-blocks-
• 説明: /v1/blocks/ に POST リクエストを送信します
• メソッド: POST
• パス: /v1/blocks/

パラメータ:

• user_id : user_idパラメータ

ブロックの変更

• ID : PATCH-v1-blocks-block-id
• 説明: /v1/blocks/{block_id} に PATCH リクエストを送信します
• 方法： PATCH
• パス: /v1/blocks/{block_id}

パラメータ:

• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

削除ブロック

• ID : DELETE-v1-blocks-block-id
• 説明: /v1/blocks/{block_id} に DELETE リクエストを送信します。
• 方法: DELETE
• パス: /v1/blocks/{block_id}

パラメータ:

• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

ブロックの取得

• ID : GET-v1-blocks-block-id
• 説明: /v1/blocks/{block_id} に GET リクエストを送信します。
• メソッド: GET
• パス: /v1/blocks/{block_id}

パラメータ:

• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

ブロック用エージェント一覧

• ID : GET-v1-blocks-block-id-agents
• 説明: 指定されたブロックに関連付けられているすべてのエージェントを取得します。ブロックが存在しない場合は404エラーが発生します。
• メソッド: GET
• パス: /v1/blocks/{block_id}/agents

パラメータ:

• block_id : block_idパラメータ（必須）
• user_id : user_idパラメータ

リストジョブ

• ID : GET-v1-jobs-
• 説明: すべてのジョブを一覧表示します。
• メソッド: GET
• パス: /v1/jobs/

パラメータ:

• source_id : ソースに関連付けられたジョブのみを一覧表示します。
• user_id : user_idパラメータ

アクティブな求人の一覧

• ID : GET-v1-jobs-active
• 説明: すべてのアクティブなジョブを一覧表示します。
• メソッド: GET
• パス: /v1/jobs/active

パラメータ:

• user_id : user_idパラメータ

ジョブの取得

• ID : GET-v1-jobs-job-id
• 説明: ジョブのステータスを取得します。
• メソッド: GET
• パス: /v1/jobs/{job_id}

パラメータ:

• job_id : job_idパラメータ（必須）
• user_id : user_idパラメータ

ジョブの削除

• ID : DELETE-v1-jobs-job-id
• 説明: job_id でジョブを削除します。
• 方法: DELETE
• パス: /v1/jobs/{job_id}

パラメータ:

• job_id : job_idパラメータ（必須）
• user_id : user_idパラメータ

ヘルスチェック

• ID : GET-v1-health-
• 説明: /v1/health/ に GET リクエストを送信します
• メソッド: GET
• パス: /v1/health/

パラメータは必要ありません。

サンドボックス設定の作成_v1_サンドボックス設定__post

• ID : POST-v1-sandbox-config-
• 説明: /v1/sandbox-config/ に POST リクエストを送信します
• メソッド: POST
• パス: /v1/sandbox-config/

パラメータ:

• user-id : ユーザーIDパラメータ

list_sandbox_configs_v1_sandbox_config__get

• ID : GET-v1-sandbox-config-
• 説明: /v1/sandbox-config/ に GET リクエストを送信します。
• メソッド: GET
• パス: /v1/sandbox-config/

パラメータ:

• limit : 返される結果の数
• after : 次の結果セットを取得するためのページネーションカーソル
• sandbox_type : この特定のサンドボックスタイプをフィルターします
• user-id : ユーザーIDパラメータ

作成_default_e2b_sandbox_config_v1_sandbox_config_e2b_default_post

• ID : POST-v1-sandbox-config-e2b-default
• 説明: /v1/sandbox-config/e2b/default にPOSTリクエストを送信します
• メソッド: POST
• パス: /v1/sandbox-config/e2b/default

パラメータ:

• user-id : ユーザーIDパラメータ

ローカルサンドボックスのデフォルト設定を投稿する

• ID : POST-v1-sandbox-config-local-default
• 説明: /v1/sandbox-config/local/default にPOSTリクエストを送信します
• メソッド: POST
• パス: /v1/sandbox-config/local/default

パラメータ:

• user-id : ユーザーIDパラメータ

カスタムローカルサンドボックス設定 v1 サンドボックス設定 ローカル投稿を作成します

• ID : POST-v1-sandbox-config-local
• 説明: pip_requirements を含むカスタム LocalSandboxConfig を作成または更新します。
• メソッド: POST
• パス: /v1/sandbox-config/local

パラメータ:

• user-id : ユーザーIDパラメータ

アップデート_サンドボックス_config_v1_サンドボックス_config__サンドボックス_config_id__パッチ

• ID : PATCH-v1-sandbox-config-sandbox-config-id
• 説明: /v1/sandbox-config/{sandbox_config_id} に PATCH リクエストを送信します
• 方法： PATCH
• パス: /v1/sandbox-config/{sandbox_config_id}

パラメータ:

• sandbox_config_id : sandbox_config_id パラメータ (必須)
• user-id : ユーザーIDパラメータ

削除_sandbox_config_v1_sandbox_config__sandbox_config_id__delete

• ID : DELETE-v1-sandbox-config-sandbox-config-id
• 説明: /v1/sandbox-config/{sandbox_config_id} に DELETE リクエストを実行します。
• 方法: DELETE
• パス: /v1/sandbox-config/{sandbox_config_id}

パラメータ:

• sandbox_config_id : sandbox_config_id パラメータ (必須)
• user-id : ユーザーIDパラメータ

ローカルサンドボックスの再作成を強制する_venv_v1_sandbox_config_local_recreate_venv_post

• ID : POST-v1-sandbox-config-local-recreate-venv
• 説明: ローカルサンドボックスの仮想環境を強制的に再作成します。venv を削除して再作成し、必要な依存関係を再インストールします。
• メソッド: POST
• パス: /v1/sandbox-config/local/recreate-venv

パラメータ:

• user-id : ユーザーIDパラメータ

サンドボックス環境変数_v1_sandbox_config__sandbox_config_id__環境変数_postを作成します

• ID : POST-v1-sandbox-config-sandbox-config-id-environment-variable
• 説明: /v1/sandbox-config/{sandbox_config_id}/environment-variable にPOSTリクエストを送信します。
• メソッド: POST
• パス: /v1/sandbox-config/{sandbox_config_id}/environment-variable

パラメータ:

• sandbox_config_id : sandbox_config_id パラメータ (必須)
• user-id : ユーザーIDパラメータ

リスト_サンドボックス_env_vars_v1_sandbox_config__サンドボックス_config_id__環境変数_get

• ID : GET-v1-sandbox-config-sandbox-config-id-environment-variable
• 説明: /v1/sandbox-config/{sandbox_config_id}/environment-variable にGETリクエストを送信します。
• メソッド: GET
• パス: /v1/sandbox-config/{sandbox_config_id}/environment-variable

パラメータ:

• sandbox_config_id : sandbox_config_id パラメータ (必須)
• limit : 返される結果の数
• after : 次の結果セットを取得するためのページネーションカーソル
• user-id : ユーザーIDパラメータ

アップデート_サンドボックス_env_var_v1_サンドボックス_config_環境変数__env_var_id__パッチ

• ID : PATCH-v1-sandbox-config-environment-variable-env-var-id
• 説明: /v1/sandbox-config/environment-variable/{env_var_id} に PATCH リクエストを送信します。
• 方法： PATCH
• パス: /v1/sandbox-config/environment-variable/{env_var_id}

パラメータ:

• env_var_id : env_var_id パラメータ（必須）
• user-id : ユーザーIDパラメータ

サンドボックス環境変数の削除

• ID : DELETE-v1-sandbox-config-environment-variable-env-var-id
• 説明: /v1/sandbox-config/environment-variable/{env_var_id} に DELETE リクエストを実行します。
• 方法: DELETE
• パス: /v1/sandbox-config/environment-variable/{env_var_id}

パラメータ:

• env_var_id : env_var_id パラメータ（必須）
• user-id : ユーザーIDパラメータ

リストプロバイダー

• ID : GET-v1-providers-
• 説明: データベース内のすべてのカスタムプロバイダーのリストを取得します
• メソッド: GET
• パス: /v1/providers/

パラメータ:

• after : パラメータの後
• limit : 制限パラメータ
• user_id : user_idパラメータ

プロバイダーの作成

• ID : POST-v1-providers-
• 説明: 新しいカスタムプロバイダーを作成する
• メソッド: POST
• パス: /v1/providers/

パラメータ:

• user_id : user_idパラメータ

プロバイダーの変更

• ID : PATCH-v1-providers-
• 説明: 既存のカスタムプロバイダーを更新する
• 方法： PATCH
• パス: /v1/providers/

パラメータ:

• user_id : user_idパラメータ

プロバイダーの削除

• ID : DELETE-v1-providers-
• 説明: 既存のカスタムプロバイダーを削除します
• 方法: DELETE
• パス: /v1/providers/

パラメータ:

• provider_id : 削除するprovider_idキー。(必須)
• user_id : user_idパラメータ

リスト実行

• ID : GET-v1-runs-
• 説明: すべての実行を一覧表示します。
• メソッド: GET
• パス: /v1/runs/

パラメータ:

• user_id : user_idパラメータ

アクティブな実行の一覧

• ID : GET-v1-runs-active
• 説明: すべてのアクティブな実行を一覧表示します。
• メソッド: GET
• パス: /v1/runs/active

パラメータ:

• user_id : user_idパラメータ

取得実行

• ID : GET-v1-runs-run-id
• 説明: 実行のステータスを取得します。
• メソッド: GET
• パス: /v1/runs/{run_id}

パラメータ:

• run_id : run_id パラメータ（必須）
• user_id : user_idパラメータ

削除実行

• ID : DELETE-v1-runs-run-id
• 説明: run_id で実行を削除します。
• 方法: DELETE
• パス: /v1/runs/{run_id}

パラメータ:

• run_id : run_id パラメータ（必須）
• user_id : user_idパラメータ

リスト実行メッセージ

• ID : GET-v1-runs-run-id-messages
• 説明: フィルタリング オプションを使用して実行に関連付けられたメッセージを取得します。

引数: run_id: 実行ID before: ページ区切りで使用するカーソル。before beforeリスト内の位置を定義するオブジェクトIDです。例えば、リストリクエストを行い、obj_fooで始まる100個のオブジェクトを受け取った場合、後続の呼び出しでbefore=obj_fooを含めることでリストの前のページを取得できます。 after: ページ区切りで使用するカーソル。after afterリスト内の位置を定義するオブジェクトIDです。例えば、リストリクエストを行い、obj_fooで終わる100個のオブジェクトを受け取った場合、後続の呼び出しでafter=obj_fooを含めることでリストの次のページを取得できます。 limit: 返されるメッセージの最大数 order: オブジェクトのcreated_atタイムスタンプによるソート順。昇順の場合はasc、降順の場合はdesc。 role: ロール（ユーザー/アシスタント/システム/ツール）によるフィルタリング return_message_object: Messageオブジェクトを返すか、LettaMessageオブジェクトを返すか user_id: リクエストを行ったユーザーのID

戻り値: 実行に関連付けられたメッセージのリスト。デフォルトはList[LettaMessage]です。

• メソッド: GET
• パス: /v1/runs/{run_id}/messages

パラメータ:

• run_id : run_id パラメータ（必須）
• before : ページ区切りのカーソル
• after : ページ区切りのカーソル
• limit : 返されるメッセージの最大数
• order : オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。
• role : 役割でフィルタリング
• user_id : user_idパラメータ

実行使用状況の取得

• ID : GET-v1-runs-run-id-usage
• 説明: 実行の使用状況統計を取得します。
• メソッド: GET
• パス: /v1/runs/{run_id}/usage

パラメータ:

• run_id : run_id パラメータ（必須）
• user_id : user_idパラメータ

実行ステップのリスト

• ID : GET-v1-runs-run-id-steps
• 説明: フィルタリング オプションを使用して実行に関連付けられたメッセージを取得します。

引数: run_id: 実行の ID before: ページ区切りで使用するカーソル。 beforeリスト内の位置を定義するオブジェクト ID です。たとえば、リスト要求を行って、obj_foo で始まる 100 個のオブジェクトを受け取った場合、後続の呼び出しで before=obj_foo を含めることでリストの前のページを取得できます。 after: ページ区切りで使用するカーソル。 afterリスト内の位置を定義するオブジェクト ID です。たとえば、リスト要求を行って、obj_foo で終わる 100 個のオブジェクトを受け取った場合、後続の呼び出しで after=obj_foo を含めることでリストの次のページを取得できます。 limit: 返す最大ステップ数 order: オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。

戻り値: 実行に関連付けられたステップのリスト。

• メソッド: GET
• パス: /v1/runs/{run_id}/steps

パラメータ:

• run_id : run_id パラメータ（必須）
• before : ページ区切りのカーソル
• after : ページ区切りのカーソル
• limit : 返されるメッセージの最大数
• order : オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。
• user_id : user_idパラメータ

リストステップ

• ID : GET-v1-steps
• 説明: オプションのページ区切りと日付フィルター付きのリストステップ。日付はISO 8601形式で指定してください（例：2025-01-29T15:01:19-08:00）。
• メソッド: GET
• パス: /v1/steps

パラメータ:

• before : このステップIDの前のステップを返す
• after : このステップID以降のステップを返す
• limit : 返されるステップの最大数
• order : ソート順（昇順または降順）
• start_date : このISO日時以降のステップを返します（例： "2025-01-29T15:01:19-08:00"）
• end_date : このISO日時より前のステップを返します（例： "2025-01-29T15:01:19-08:00"）
• model : ステップに使用されたモデルの名前でフィルタリングします
• agent_id : ステップを実行したエージェントのIDでフィルタリングします
• user_id : user_idパラメータ

取得ステップ

• ID : GET-v1-steps-step-id
• 説明: ID でステップを取得します。
• メソッド: GET
• パス: /v1/steps/{step_id}

パラメータ:

• step_id : step_idパラメータ（必須）
• user_id : user_idパラメータ

更新ステップトランザクションID

• ID : PATCH-v1-steps-step-id-transaction-transaction-id
• 説明: ステップのトランザクション ID を更新します。
• 方法： PATCH
• パス: /v1/steps/{step_id}/transaction/{transaction_id}

パラメータ:

• step_id : step_idパラメータ（必須）
• transaction_id : transaction_idパラメータ（必須）
• user_id : user_idパラメータ

リストタグ

• ID : GET-v1-tags-
• 説明: データベース内のすべてのタグのリストを取得します
• メソッド: GET
• パス: /v1/tags/

パラメータ:

• after : パラメータの後
• limit : 制限パラメータ
• query_text : クエリテキストパラメータ
• user_id : user_idパラメータ

ボイスチャット補完の作成

• ID : POST-v1-voice-beta-agent-id-chat-completions
• 説明: /v1/voice-beta/{agent_id}/chat/completions にPOSTリクエストを送信します。
• メソッド: POST
• パス: /v1/voice-beta/{agent_id}/chat/completions

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user-id : ユーザーIDパラメータ

リストユーザー

• ID : GET-v1-admin-users-
• 説明: データベース内のすべてのユーザーのリストを取得します
• メソッド: GET
• パス: /v1/admin/users/

パラメータ:

• after : パラメータの後
• limit : 制限パラメータ

ユーザー作成

• ID : POST-v1-admin-users-
• 説明: データベースに新しいユーザーを作成する
• メソッド: POST
• パス: /v1/admin/users/

パラメータは必要ありません。

更新ユーザー

• ID : PUT-v1-admin-users-
• 説明: データベース内のユーザーを更新する
• メソッド: PUT
• パス: /v1/admin/users/

パラメータは必要ありません。

ユーザー削除

• ID : DELETE-v1-admin-users-
• 説明: /v1/admin/users/ に DELETE リクエストを発行する
• 方法: DELETE
• パス: /v1/admin/users/

パラメータ:

• user_id : 削除する user_id キー。(必須)

リスト組織

• ID : GET-v1-admin-orgs-
• 説明: データベース内のすべての組織のリストを取得します
• メソッド: GET
• パス: /v1/admin/orgs/

パラメータ:

• after : パラメータの後
• limit : 制限パラメータ

組織の作成

• ID : POST-v1-admin-orgs-
• 説明: データベースに新しい組織を作成する
• メソッド: POST
• パス: /v1/admin/orgs/

パラメータは必要ありません。

組織IDによる削除

• ID : DELETE-v1-admin-orgs-
• 説明: /v1/admin/orgs/ に DELETE リクエストを実行します。
• 方法: DELETE
• パス: /v1/admin/orgs/

パラメータ:

• org_id : 削除する org_id キー。(必須)

組織の更新

• ID : PATCH-v1-admin-orgs-
• 説明: /v1/admin/orgs/ に PATCH リクエストを送信します
• 方法： PATCH
• パス: /v1/admin/orgs/

パラメータ:

• org_id : 更新する org_id キー。(必須)

チャット補完の作成

• ID : POST-openai-v1-agent-id-chat-completions
• 説明: /openai/v1/{agent_id}/chat/completions にPOSTリクエストを送信します。
• メソッド: POST
• パス: /openai/v1/{agent_id}/chat/completions

パラメータ:

• agent_id : agent_idパラメータ（必須）
• user-id : ユーザーIDパラメータ

認証_ユーザー_v1_認証_投稿

• ID : POST-v1-auth
• 説明: ユーザーを認証し、ユーザー関連データを含む応答を送信します。

現在、これは単にUUIDプレースホルダーを返すプレースホルダーです

• メソッド: POST
• パス: /v1/auth

パラメータは必要ありません。

ライセンス

マサチューセッツ工科大学