openapi-mcp-server

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

説明

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

Related MCP server: agentforge

インストール

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

npm install

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

cp .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 バージョンの両方で提供されます。

# Run JavaScript version
npm start

# Or run TypeScript version (compiles on the fly)
npm run start:ts

TypeScriptバージョンのビルド

npm run build
cd dist
node server.js

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

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

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

import { MCP } from "claude-js";
import { createStdio } from "claude-js/mcp";

// Create stdin/stdout transport
const transport = createStdio({ command: "node path/to/server.js" });

// Connect to the MCP server
const mcp = new MCP({ transport });
await mcp.connect();

// List available tools
const { tools } = await mcp.listTools();
console.log("Available tools:", tools);

// Call a tool
const result = await mcp.callTool({
    id: "TOOL-ID",
    arguments: { param1: "value1" }
});
console.log("Tool result:", result);

利用可能なツール

この 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

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

ライセンス

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