Ceeds Academy教材アプリ教材・症状語・タグで検索
索引グラフ試す
AI▸LLM活用▸Claude

AI: LLM を API で使う(Messages・役割・温度)

hands-on所要 30分最新草稿
前提: AI: プロンプト設計(明確な指示・例示・出力形式・段階思考)→次: AI: RAG(検索拡張生成・根拠付け)次: AI: エージェントと安全(ツール使用・ハルシネーション・プロンプトインジェクション)
意味グラフ(この教材と内容的に近い教材・1ネスト)
例え(Analogies)
LLM API=専門家への電話相談

電話(API)で専門家(モデル)に用件(メッセージ)を伝え、回答を受け取る。話し方の温度感(temperature)や回答の長さ(max_tokens)を指定できる。電話番号(APIキー)は他人に渡さない。

概要

📍 AI / Anthropic ▸ Claude ▸ Messages API | 種別: hands-on | facts_as_of 2026-06(例: Claude Opus 4.8。モデル版は公式で確認)

公式ドキュメント — hands-on

🎞 スライド

LLM を API で呼ぶ

メッセージを送り、応答を受け取る

呼び出しの流れ(テキスト図)

[messages: role=user/assistant/system]
│ model・max_tokens・temperature を指定
▼
[API] ──応答──▶ [content[0].text]

鍵の置き場所

APIキー → 環境変数(ANTHROPIC_API_KEY)/コード・リポに書かない

—
クリックで一覧(遷移しない)
出典(sources)

docs.anthropic.com (Messages API) ; 2026-06確認

確認問題(Review-Questions)
APIキーの正しい扱いは?択一
基礎公式
解答・解説▾ 開く

環境変数に置きコードに書かない・コミットしない。

Anthropic Messages APIでuserの発話を送る最小構造は?コード
基礎公式
解答・解説▾ 開く

messages=[{"role":"user","content":"..."}] と model / max_tokens を指定。

運営メモ・チェックリスト(配信除外)

🔒 運営メモ(公開除外)

  • Anthropic SDK / Claude Opus 4.8。review 6ヶ月(モデル/SDK更新)。requires: ai-02-prompting。unlocks: ai-04-rag, ai-05-agents-safety。taxonomy=llm-foundations+claude、domains=AI+Anthropic。references: sec-03-secrets(キー)。OpenAI/Geminiは同構造の別SDK。
  • 例え=Analogies(電話で専門家に依頼)。確認問題=Review-Questions。
目次
例え概要公式ドキュメント出典確認問題
鮮度
最新
更新: 2026-06-15
次回棚卸し: 2026-12-15
周期: 6か月
版: Anthropic SDK / Claude Opus 4.8 (claude-opus-4-8)

概要

LLM を API で呼ぶ=メッセージ(role: user/assistant/system)を送り応答を得る。モデル・最大トークン・温度を指定。例は Anthropic Messages API。

公式ドキュメント準拠(Anthropic Messages API)

import anthropic
client = anthropic.Anthropic()  # キーは環境変数 ANTHROPIC_API_KEY

msg = client.messages.create(
    model="claude-opus-4-8",     # 例。最新のモデルIDは公式モデル一覧で確認
    max_tokens=1024,
    messages=[{"role": "user", "content": "三行で要約して: ..."}],
)
print(msg.content[0].text)
  • role(user/assistant/system)、model、max_tokens、temperature。ツール使用/MCP で外部連携。
  • ⚠️ APIキーは環境変数(コード/リポに書かない・コミット禁止)。

出典: Anthropic: Messages API(facts_as_of 2026-06)

🧭 誤解訂正集

よくある誤解 正しい理解
キーはコードに書く 環境変数に置く(コミット禁止)
ベンダーごとに別物 role/model/messages は共通概念(ai-03↔openai-01)
temperature は固定 用途で調整(厳密さ重視なら低く)

📖 用語

  • Messages API … メッセージ列を送って応答を得る Anthropic の API。
  • role(役割) … 各メッセージの発話者(user/assistant/system)。
  • system(システムメッセージ) … 振る舞いの前提・役割を与える指示。
  • max_tokens … 応答として生成する最大トークン数。
  • temperature … 出力の多様性を調整する値。
  • ツール使用 / MCP … LLM から外部ツール・データに接続する仕組み。

✅ 確認の目安(can-do)

role/model/max_tokens/temperature の意味を説明し、**「APIキーをどこに置くか・なぜか」**を含めて最小の呼び出しを書ける。

⚠️ エラー復旧集

症状 原因 復旧
401 Unauthorized APIキー 環境変数を確認(コードに貼らない)
429 Rate limit レート制限 リトライ/バックオフ
出力が途中で切れる max_tokens 不足 上限を増やす