> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# OpenAI 응답 API 대화

OpenAI Responses API Conversations 표면은 Mastra Agents의 대화 관리 측면을 Responses API로 제공합니다. Mastra에서 스레드 기반 대화를 생성, 검색, 삭제 및 검사하는 방법을 제공합니다.

이 API는 [OpenAI Responses API](https://mastra.zisheng.pro/ko/reference/client-js/responses)를 보완합니다. Stored Responses 호출은 `conversation_id`를 반환하며, Mastra에서 이 값은 원시 Memory `threadId`입니다. 해당 스레드를 직접 다루려면 `client.conversations`를 사용하세요. 이 API는 현재 실험적입니다.

## OpenAI 응답과의 관계

생성 및 지속을 위해 OpenAI Responses API를 사용하십시오.

```typescript
const response = await client.responses.create({
  agent_id: 'support-agent',
  input: 'Start a support thread',
  store: true,
})

console.log(response.conversation_id)
```

저장된 스레드를 검사하거나 관리하려면 Conversations API를 사용하세요.

```typescript
const conversation = await client.conversations.retrieve(response.conversation_id!)
const items = await client.conversations.items.list(response.conversation_id!)
```

## 사용예

```typescript
import { MastraClient } from '@mastra/client-js'

const client = new MastraClient({
  baseUrl: 'http://localhost:4111',
})

const conversation = await client.conversations.create({
  agent_id: 'support-agent',
})

console.log(conversation.id)
```

## 행동 양식

### 수명주기

#### `create(params)`

선택한 Agent에 대한 새 대화 스레드를 만듭니다.

```typescript
const conversation = await client.conversations.create({
  agent_id: 'support-agent',
  title: 'Billing support',
})
```

**보고:** `Promise<Conversation>`.

#### `retrieve(conversationId, requestContext?)`

스레드 ID로 대화를 검색합니다.

```typescript
const conversation = await client.conversations.retrieve('thread_123')

console.log(conversation.thread)
```

**보고:** `Promise<Conversation>`.

#### `delete(conversationId, requestContext?)`

스레드 ID로 대화를 삭제합니다.

```typescript
const deleted = await client.conversations.delete('thread_123')

console.log(deleted.deleted)
```

**보고:** `Promise<ConversationDeleted>`.

### 품목

#### `items.list(conversationId, requestContext?)`

대화에 대해 저장된 항목을 나열합니다.

```typescript
const items = await client.conversations.items.list('thread_123')

console.log(items.data)
```

**보고:** `Promise<ConversationItemsPage>`.

## 응답 형태

`create()`와 `retrieve()`는 다음을 포함하는 대화 객체를 반환합니다.

- `id`: 원시 스레드 ID
- `object`: 언제나`'conversation'`
- `thread`: 저장된 스레드 기록

`delete()`보고:

- `id`: 원시 스레드 ID
- `object`: 언제나`'conversation.deleted'`
- `deleted`: 언제나`true`

`items.list()`보고:

- `object`: 항상 `'list'`
- `data`: `message`, `function_call`, `function_call_output` 같은 대화 항목
- `first_id`: 페이지의 첫 번째 항목 ID
- `last_id`: 페이지의 마지막 항목 ID
- `has_more`: 현재 페이지 외에 항목이 더 있는지 여부

## 매개변수

**agent\_id** (`string`): 필수입니다. 대화 Memory를 소유하는 등록된 Mastra Agent입니다.

**conversation\_id** (`string`): 원시 스레드 ID로 사용할 선택적 대화 ID입니다.

**resource\_id** (`string`): 대화 스레드와 연결할 선택적 리소스 ID입니다.

**title** (`string`): 대화와 함께 저장되는 선택적 스레드 제목입니다.

**metadata** (`Record<string, unknown>`): 대화와 함께 저장되는 선택적 스레드 메타데이터입니다.

**requestContext** (`RequestContext | Record<string, any>`): Mastra 서버로 전달되는 선택적 요청 컨텍스트입니다.