Letta Agents MCP Server

오픈API-MCP-서버

Letta API를 위한 MCP(Model Context Protocol) 서버.

설명

이 서버는 API에 대한 MCP(Model Context Protocol) 인터페이스를 제공합니다.

설치

1. 종속성 설치:

지엑스피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(Model Context Protocol)를 구현하며 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 매개변수

업서트_툴

• ID : PUT-v1-tools-
• 설명 : 도구 만들기 또는 업데이트
• 방법 : PUT
• 경로 : /v1/tools/

매개변수 :

• user_id : user_id 매개변수

add_base_tools

• 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 매개변수

add_composio_tool

• 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 매개변수

list_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 매개변수

서버별 mcp 도구 목록

• 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 매개변수

add_mcp_tool

• 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 매개변수

delete_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로 에이전트 검색
• 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 : memory_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 : memory_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 매개변수

업서트_그룹

• 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 : GET-v1-identities-
• 설명 : 데이터베이스에 있는 모든 ID 목록을 가져옵니다.
• 방법 : GET
• 경로 : /v1/identities/

매개변수 :

• name : 이름 매개변수
• project_id : project_id 매개변수
• 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 매개변수

업서트_아이덴티티

• ID : PUT-v1-identities-
• 설명 : /v1/identities/에 PUT 요청을 만듭니다.
• 방법 : PUT
• 경로 : /v1/identities/

매개변수 :

• user_id : user_id 매개변수
• X-Project : X-Project 매개변수

검색_신원

• 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 : PATCH-v1-identities-identity-id
• 설명 : /v1/identities/{identity_id}에 PATCH 요청을 만듭니다.
• 방법 : PATCH
• 경로 : /v1/identities/{identity_id}

매개변수 :

• identity_id : identity_id 매개변수(필수)
• user_id : user_id 매개변수

삭제_아이덴티티

• ID : DELETE-v1-identities-identity-id
• 설명 : 식별자 키로 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 : 포함할 레이블(예: 인간, 페르소나)
• 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/

매개변수가 필요하지 않습니다.

create_sandbox_config_v1_sandbox_config__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 매개변수

create_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 매개변수

create_default_local_sandbox_config_v1_sandbox_config_local_default_post

• ID : POST-v1-sandbox-config-local-default
• 설명 : /v1/sandbox-config/local/default에 POST 요청을 만듭니다.
• 방법 : POST
• 경로 : /v1/sandbox-config/local/default

매개변수 :

• user-id : 사용자 ID 매개변수

create_custom_local_sandbox_config_v1_sandbox_config_local_post

• ID : POST-v1-sandbox-config-local
• 설명 : pip_requirements를 포함하여 사용자 정의 LocalSandboxConfig를 생성하거나 업데이트합니다.
• 방법 : POST
• 경로 : /v1/sandbox-config/local

매개변수 :

• user-id : 사용자 ID 매개변수

업데이트_샌드박스_구성_v1_샌드박스_구성__샌드박스_구성_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 매개변수

delete_sandbox_config_v1_sandbox_config__sandbox_config_id__삭제

• 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 샌드박스 구성 로컬 venv_post를 강제로 다시 만듭니다.

• ID : POST-v1-sandbox-config-local-recreate-venv
• 설명 : 로컬 샌드박스의 가상 환경을 강제로 다시 생성합니다. venv를 삭제하고 다시 생성한 후 필요한 종속성을 다시 설치합니다.
• 방법 : POST
• 경로 : /v1/sandbox-config/local/recreate-venv

매개변수 :

• user-id : 사용자 ID 매개변수

샌드박스 환경 변수 v1 샌드박스 구성 생성 샌드박스 구성 ID 환경 변수 게시

• 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 매개변수

list_sandbox_env_vars_v1_sandbox_config__sandbox_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 매개변수

업데이트_샌드박스_환경_변수_v1_샌드박스_구성_환경_변수__환경_변수_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 매개변수

delete_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_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 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 시작하는 100개의 객체를 수신하는 경우, 후속 호출에 before=obj_foo를 포함하여 목록의 이전 페이지를 가져올 수 있습니다. after: 페이지 매김에 사용할 커서. after 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 끝나는 100개의 객체를 수신하는 경우, 후속 호출에 after=obj_foo를 포함하여 목록의 다음 페이지를 가져올 수 있습니다. limit: 반환할 최대 메시지 수 order: 객체의 created_at 타임스탬프를 기준으로 정렬합니다. 오름차순은 asc, 내림차순은 desc입니다. role: 역할(user/assistant/system/tool)로 필터링 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 datetime 이후의 단계를 반환합니다(예: "2025-01-29T15:01:19-08:00")
• end_date : 이 ISO datetime 이전의 단계를 반환합니다(예: "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 매개변수

authenticate_user_v1_auth_post

• ID : POST-v1-auth
• 설명 : 사용자를 인증하고 사용자 관련 데이터가 포함된 응답을 보냅니다.

현재 이것은 단순히 UUID 플레이스홀더를 반환하는 플레이스홀더입니다.

• 방법 : POST
• 경로 : /v1/auth

매개변수가 필요하지 않습니다.

특허

MIT