> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

エージェントを構築し、デプロイし、数分以内に最初の通話を実行します。

## 前提条件

* 無料の Cartesia アカウント（[こちらから登録](https://play.cartesia.ai)）
* Python 3.9+
* LLM API キー（Anthropic、OpenAI、Google など）
* [uv](https://docs.astral.sh/uv/)（Python のパッケージおよびプロジェクト管理ツール）

## CLI のインストール

```bash theme={null}
curl -fsSL https://cartesia.sh | sh
cartesia auth login
```

## uv のインストール

[uv](https://docs.astral.sh/uv/) をインストールします。依存関係と仮想環境を管理するための高速な Python パッケージマネージャーです。

```bash theme={null}
curl -LsSf https://astral.sh/uv/install.sh | sh
```

## エージェントを作成する

新しいプロジェクトを作成して依存関係をインストールします。uv が仮想環境を自動的にセットアップし、パッケージを管理します。

```bash theme={null}
uv init my-voice-agent && cd my-voice-agent
uv add cartesia-line
```

`main.py` を作成します：

```python theme={null}
import os
from line.llm_agent import LlmAgent, LlmConfig, end_call
from line.voice_agent_app import VoiceAgentApp

async def get_agent(env, call_request):
    return LlmAgent(
        model="anthropic/claude-haiku-4-5-20251001", # Or "gpt-5-nano", "gemini/gemini-2.5-flash", etc.
        api_key=os.getenv("ANTHROPIC_API_KEY"),
        tools=[end_call],
        config=LlmConfig(
            system_prompt="You are a helpful assistant.",
            introduction="Hello! How can I help you today?",
        ),
    )

app = VoiceAgentApp(get_agent=get_agent)

if __name__ == "__main__":
    app.run()
```

## ローカルでテストする

エージェントサーバーを起動します。

```bash theme={null}
ANTHROPIC_API_KEY=your-api-key PORT=8000 uv run python main.py
```

別のターミナルで、以下を実行するだけでエージェントとチャットできます：

```bash theme={null}
cartesia chat 8000
```

これにより、デプロイ前にエージェントの推論をテストできます。

## デプロイ

プロジェクトをリンクしてデプロイします。

```bash theme={null}
cartesia init    # Choose "Create new" and name your agent
cartesia deploy
```

エージェントは Cartesia のマネージドランタイム上で 30 秒以内にデプロイされます。

## 環境変数を設定する

デプロイされたエージェント用に API キーを設定します。

```bash theme={null}
cartesia env set ANTHROPIC_API_KEY=your-api-key
```

または `.env` ファイルからインポートします：

```bash theme={null}
cartesia env set --from .env
```

## 通話を発信する

電話からエージェントに発信します。

```bash theme={null}
cartesia call +1XXXXXXXXXX
```

または [プレイグラウンド](https://play.cartesia.ai/agents) から Web 経由で発信します。

## 次のステップ

<CardGroup cols={2}>
  <Card title="ツールを追加" icon="wrench" href="/line/sdk/tools">
    データベース、API、外部サービスに接続する
  </Card>

  <Card title="プロンプトを設定" icon="robot" href="/line/sdk/agents">
    システムプロンプトと会話フローをカスタマイズする
  </Card>

  <Card title="WebSocket API" icon="globe" href="/line/integrations/websocket-api">
    WebSocket 経由で Web クライアントを接続する
  </Card>

  <Card title="エージェントビルダー" icon="sparkles" href="/line/start-building/agent-builder">
    プレイグラウンドで視覚的にエージェントを構築する
  </Card>
</CardGroup>