> ## Documentation Index > Fetch the complete documentation index at: https://docs.dify.ai/llms.txt > Use this file to discover all available pages before exploring further. # アノテーションを作成 > **対象アプリ**：Chatflow、チャットボット、Agent。 新しいアノテーションを作成します。アノテーションは、アプリがレスポンスを生成する代わりに直接マッチして返すことができる、事前定義された質問と回答のペアを提供します。 ## OpenAPI ````yaml /ja/api-reference/openapi_service.json post /apps/annotations openapi: 3.0.1 info: title: Dify サービス API description: >- Dify アプリケーションとナレッジベースのための REST API です。アプリケーション系エンドポイントはアプリの API キーで、ナレッジ系エンドポイントはナレッジベースの API キーで認証します。 version: 1.0.0 servers: - url: https://{api_base_url} description: Dify サービス API のベース URL です。セルフホスト環境では、独自の API ベース URL に置き換えてください。 variables: api_base_url: default: api.dify.ai/v1 description: API ベース URL のホストとパス（`https://` を除く）。 security: - ApiKeyAuth: [] tags: - name: チャットメッセージ description: チャットメッセージとインタラクションに関連する操作です。 - name: ファイル操作 description: ファイルのアップロードとプレビューの操作です。 - name: エンドユーザー description: エンドユーザー情報に関連する操作です。 - name: メッセージフィードバック description: ユーザーフィードバックの操作です。 - name: 会話管理 description: 会話管理に関連する操作です。 - name: 音声・テキスト変換 description: テキスト読み上げと音声認識の操作です。 - name: アプリケーション設定 description: アプリケーション設定と情報を取得する操作です。 - name: アノテーション管理 description: ダイレクト返信用のアノテーション管理に関連する操作です。 - name: 人間の入力 description: 人間の入力を要する一時停止中のワークフローの再開操作です。 - name: ワークフロー実行 description: ワークフローの実行と管理のための操作です。 - name: 完了メッセージ description: テキスト生成に関連する操作です。 - name: ナレッジベース description: ナレッジベースの作成、設定、取得を含むナレッジベース管理の操作です。 - name: ドキュメント description: ナレッジベース内のドキュメントの作成、更新、管理のための操作です。 - name: チャンク description: ドキュメントチャンクと子チャンクの管理のための操作です。 - name: メタデータ description: ナレッジベースのメタデータフィールドとドキュメントメタデータ値の管理のための操作です。 - name: タグ管理 description: ナレッジベースタグとタグバインディングの管理のための操作です。 - name: モデル description: 利用可能なモデルを取得するための操作です。 - name: ナレッジパイプライン description: データソースプラグインとパイプライン実行を含むナレッジパイプラインの管理と実行のための操作です。 paths: /apps/annotations: post: tags: - アノテーション管理 summary: アノテーションを作成 description: >- **対象アプリ**：Chatflow、チャットボット、Agent。 新しいアノテーションを作成します。アノテーションは、アプリがレスポンスを生成する代わりに直接マッチして返すことができる、事前定義された質問と回答のペアを提供します。 operationId: createChatAnnotationJa requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateAnnotationRequest' examples: createAnnotation: summary: リクエスト例 value: question: What is Dify? answer: Dify is an open-source LLM application development platform. responses: '201': description: アノテーションが正常に作成されました。 content: application/json: schema: $ref: '#/components/schemas/AnnotationItem' examples: createdAnnotation: summary: レスポンス例 value: id: a1b2c3d4-5678-90ab-cdef-1234567890ab question: What is Dify? answer: >- Dify is an open-source LLM application development platform. hit_count: 0 created_at: 1705407629 components: schemas: CreateAnnotationRequest: type: object description: 新しいアノテーションを作成するためのリクエストボディです。 required: - question - answer properties: question: type: string description: アノテーションの質問です。 answer: type: string description: アノテーションの回答です。 AnnotationItem: type: object properties: id: type: string format: uuid description: アノテーションの一意識別子です。 question: type: string nullable: true description: このアノテーションをトリガーする質問テキストです。 answer: type: string nullable: true description: アノテーションがマッチした際に返される定義済みの回答です。 hit_count: type: integer nullable: true description: このアノテーションがマッチして返信として返された回数です。 created_at: type: integer format: int64 nullable: true description: 作成タイムスタンプ（Unix エポック秒）。 securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API_KEY description: >- API Key 認証です。すべての API リクエストにおいて、`Authorization` HTTP ヘッダーに `Bearer ` プレフィックスを付けた API Key を含めてください。例：`Authorization: Bearer {API_KEY}`。**API Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key の漏洩は深刻な結果につながる可能性があります。**API Key が欠落または無効な場合、HTTP `401` とエラーコード `unauthorized` が返されます。 ````