# Working with the Assistant

The assistant client lets you create and manage AI assistants that can answer questions
over your uploaded documents.

## Create an assistant

```python
from pinecone import Pinecone

pc = Pinecone(api_key="your-api-key")

assistant = pc.assistant.create(
    name="my-assistant",
    instructions="Answer questions based on the uploaded documents.",
)
print(assistant.name)    # "my-assistant"
print(assistant.status)  # "Initializing" immediately after creation
```

The assistant transitions through ``Initializing`` → ``Ready``. ``create`` returns
immediately; poll with ``describe`` to wait for readiness.

## List and describe assistants

``list`` returns all assistants in the project:

```python
for asst in pc.assistant.list():
    print(asst.name, asst.status)
```

``describe`` returns details for a single assistant:

```python
asst = pc.assistant.describe(name="my-assistant")
print(asst.name)         # "my-assistant"
print(asst.status)       # "Ready"
print(asst.instructions) # the instruction string
```

## Upload a file

Pass a local file path to upload context documents for the assistant to read:

```python
file = pc.assistant.upload_file(
    assistant_name="my-assistant",
    file_path="data.pdf",
)
print(file.id)     # file ID used for later operations
print(file.name)   # "data.pdf"
print(file.status) # "Processing" → "Available"
```

## Chat

Send a conversation and receive a response:

```python
response = pc.assistant.chat(
    assistant_name="my-assistant",
    messages=[{"role": "user", "content": "What is the main topic of the document?"}],
)
print(response.message.content)
```

## Streaming chat

Pass ``stream=True`` to receive tokens incrementally:

```python
stream = pc.assistant.chat(
    assistant_name="my-assistant",
    messages=[{"role": "user", "content": "Summarize the document."}],
    stream=True,
)
for chunk in stream:
    print(chunk, end="", flush=True)
```

## Delete a file

Remove an uploaded file from an assistant:

```python
pc.assistant.delete_file(
    assistant_name="my-assistant",
    file_id="file-id-here",
)
```

Raises {exc}`~pinecone.exceptions.NotFoundError` if the file does not exist.

## Delete an assistant

```python
pc.assistant.delete(name="my-assistant")
```

Raises {exc}`~pinecone.exceptions.NotFoundError` if the assistant does not exist.