copilotConversation: chatOverStream

重要

/beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。

Microsoft 365 Copilot Chat API を使用すると、organization内で定義されたアクセス制御を尊重しながら、Microsoft 365 Copilotで複数ターンの会話を作成して続行できます。チャット API を使用して、Microsoft 365 Copilotでストリーミングされた会話を続行します。

このドキュメントでは、Chat API を使用したストリーミングされた Copilot 会話の継続について説明します。 Copilot 会話を作成する方法、またはチャット API を使用して同期会話を続行する方法について説明します。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類	最小特権アクセス許可	より高い特権のアクセス許可
委任 (職場または学校のアカウント)	Sites.Read.All、Mail.Read、People。Read.All、OnlineMeetingTranscript.Read.All、Chat.Read、ChannelMessage.Read.All、ExternalItem.Read.All*	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	サポートされていません。	サポートされていません。

* Microsoft 365 Copilot Chat API を正常に呼び出すには、これらすべての Microsoft Graph アクセス許可が必要です。

HTTP 要求

POST https://graph.microsoft.com/beta/copilot/conversations/{conversationId}/chatOverStream

要求ヘッダー

名前	説明
`Authorization`	`Bearer {token}`. 必須です。認証と認可についての詳細をご覧ください。
`Content-Type`	`application/json.` 必須。

要求本文

要求本文で、パラメーターの JSON 表現を指定します。

次の表に、このアクションを呼び出すときに使用できる省略可能なパラメーターと必要なパラメーターを示します。

パラメーター	型	説明
`message`	copilotConversationRequestMessageParameter	Copilot 会話に送信されるチャットメッセージ。必須です。
`additionalContext`	copilotContextMessage コレクション	Copilot 会話の追加コンテキスト。このパラメーターは、追加の接地データを提供します。省略可能。
`locationHint`	copilotConversationLocation	ユーザーの位置情報。必須です。
`contextualResources`	copilotContextualResources	コンテキストとして使用する必要がある OneDrive ファイルと SharePoint ファイルを提供し、Web 検索の接地を切り替えます。省略可能。

応答

成功した場合、このメソッドはサーバー送信イベントのストリーム (SSE) を返し、状態は 200 OK と Content-Type のtext/event-stream。各SSEには copilotConversation が含まれています。

例

例 1: Microsoft 365 Copilot Chat API にチャットメッセージを送信する

次の例は、ストリーミングされたエンドポイントを使用して Chat API にプロンプトを送信する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/copilot/conversations/d0f6bffa-49d4-43c6-b93b-e7183f92b765/chatOverStream
Content-Type: application/json

{
  "message": {
    "text": "What meeting do I have at 9 AM tomorrow morning?"
  },
  "locationHint": {
    "timeZone": "America/New_York"
  }
}

応答

次の例は応答を示しています。ほとんどのイベントストリームは、簡潔にするために例から編集されます。

HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:01:20.9535583Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "65781ab5-79ce-4159-950f-edc04c51e909",
      "text": "You asked about your meeting scheduled for **9 AM tomorrow**, and I found **1 meeting** on your calendar.\n\n### 🗓️ Scheduled Meeting\n- **Title**: <Event>Contoso Engineering Standup</Event>\n- **Time**: Tomorrow from **9:00 AM to 9:30 AM**\n- **Organizer**: <Person>John Doe</Person>[^1^]\n- **Location**: Microsoft Teams Meeting\n- **Invitee Status**: No one has accepted the meeting invite yet[^1^]\n\nLet me know if you'd like help preparing for this meeting or checking who else was invited.",
      "createdDateTime": "2025-09-30T22:00:49.7881529Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked about your meeting scheduled for **9 AM tomorrow**, and I found **1 meeting** on your calendar.\n\n### 🗓️ Scheduled Meeting\n- **Title**: [Contoso Engineering Standup](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d&EntityRepresentationId=8c968792-ca7a-42d6-8b44-9e5212b2d240)\n- **Time**: Tomorrow from **9:00 AM to 9:30 AM**\n- **Organizer**: [John Doe](https://www.office.com/search?q=John+Doe&EntityRepresentationId=55cdb988-cbf5-44db-b75d-a431ca839c70) [1](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d)\n- **Location**: Microsoft Teams Meeting\n- **Invitee Status**: No one has accepted the meeting invite yet [1](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d)\n\nLet me know if you'd like help preparing for this meeting or checking who else was invited.",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d&EntityRepresentationId=8c968792-ca7a-42d6-8b44-9e5212b2d240",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://www.office.com/search?q=John+Doe&EntityRepresentationId=55cdb988-cbf5-44db-b75d-a431ca839c70",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "citation",
          "providerDisplayName": "Contoso Engineering Standup",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:137

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:01:22.9022796Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": []
}
id:141

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:00:44.7918493Z",
  "displayName": "What meeting do I have at 9 AM tomorrow morning?",
  "state": "active",
  "turnCount": 1,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "8c74f6a7-ae3c-4ac6-845e-01e5008c6d87",
      "text": "What meeting do I have at 9 AM tomorrow morning?",
      "createdDateTime": "2025-09-30T22:00:44.7918493Z",
      "adaptiveCards": [],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    },
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "65781ab5-79ce-4159-950f-edc04c51e909",
      "text": "You asked about your meeting scheduled for **9 AM tomorrow**, and I found **1 meeting** on your calendar.\n\n### 🗓️ Scheduled Meeting\n- **Title**: <Event>Contoso Engineering Standup</Event>\n- **Time**: Tomorrow from **9:00 AM to 9:30 AM**\n- **Organizer**: <Person>John Doe</Person>[^1^]\n- **Location**: Microsoft Teams Meeting\n- **Invitee Status**: No one has accepted the meeting invite yet[^1^]\n\nLet me know if you'd like help preparing for this meeting or checking who else was invited.",
      "createdDateTime": "2025-09-30T22:00:49.7881529Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked about your meeting scheduled for **9 AM tomorrow**, and I found **1 meeting** on your calendar.\n\n### 🗓️ Scheduled Meeting\n- **Title**: [Contoso Engineering Standup](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d&EntityRepresentationId=8c968792-ca7a-42d6-8b44-9e5212b2d240)\n- **Time**: Tomorrow from **9:00 AM to 9:30 AM**\n- **Organizer**: [John Doe](https://www.office.com/search?q=John+Doe&EntityRepresentationId=55cdb988-cbf5-44db-b75d-a431ca839c70) [1](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d)\n- **Location**: Microsoft Teams Meeting\n- **Invitee Status**: No one has accepted the meeting invite yet [1](https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d)\n\nLet me know if you'd like help preparing for this meeting or checking who else was invited.",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d&EntityRepresentationId=8c968792-ca7a-42d6-8b44-9e5212b2d240",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://www.office.com/search?q=John+Doe&EntityRepresentationId=55cdb988-cbf5-44db-b75d-a431ca839c70",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "citation",
          "providerDisplayName": "Contoso Engineering Standup",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://teams.microsoft.com/l/meeting/details?eventId=AAMkADg5ZjdjZGNiLWRiMzItNDA3MC1iNDNlLTdlMGY4ZDc0ZjdlZgBGAAAAAACm2kxZvrUtTa-iv1uzeNCxBwA4nsl0tFf4R7qmHdVqpNbsAAAAAAENAAA4nsl0tFf4R7qmHdVqpNbsAAAVa4BBAAA%3d",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:142

例 2: Microsoft 365 Copilot Chat API へのチャットメッセージのコンテキストとして OneDrive または SharePoint ファイルを使用する

次の例は、チャット API にメッセージを送信するときに、OneDrive または SharePoint ファイルをコンテキストとして使用する方法を示しています。チャットメッセージを送信するときに、複数の OneDrive ファイルと SharePoint ファイルをコンテキストとして使用できます。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/copilot/conversations/d0f6bffa-49d4-43c6-b93b-e7183f92b765/chatOverStream
Content-Type: application/json

{
  "message": {
    "text": "Summarize this document for me."
  },
  "locationHint": {
    "timeZone": "America/New_York"
  },
  "contextualResources": {
    "files": [
      {
        "uri": "https://contoso.sharepoint.com/sites/Engineering/Shared%20Documents/Specs/Business-Model.docx"
      }
    ]
  }
}

応答

次の例は応答を示しています。ほとんどのイベントストリームは、簡潔にするために例から編集されます。

HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:22:24.4694391Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "bb926a9c-3b77-4477-b5bd-12abd8ff51e3",
      "text": "You asked for a summary of the document **<File>Business-Model.docx</File>**. Here\u2019s a concise overview based on its content:\n\n---\n\n## **Summary: What Is a Business Model?**\n\n### **Definition & Importance**\n- A **business model** is a holistic framework for creating, delivering, and capturing value. It\u2019s not just about how a company makes money, but how it creates value for customers, partners, and itself over the long term.\n- Business models are essential for startups and established companies alike, as they help unlock sustainable value and guide experimentation in the marketplace.\n\n### **Key Distinctions**\n- **Not a Business Plan:** A business model is different from a business plan. While a business plan is a static document with projections and assumptions, a business model is dynamic and focused on real-world experimentation.\n- **Not Just Revenue Strategy:** Monetization is only one part of a business model. Other components include operations, customer acquisition, retention, supply chain, and more.\n\n### **Design & Experimentation**\n- Business model design is about building a sustainable value chain, starting with a clear value proposition and focusing on a specific niche before scaling.\n- Experimentation is crucial\u2014entrepreneurs must test and iterate on their models to find what works in the real world.\n\n### **Innovation**\n- **Technological vs. Business Model Innovation:** While technology can enable new business models, true innovation often comes from rethinking how value is created and delivered, not just from new tech.\n- **Competitive Moats:** Business model innovation can create lasting competitive advantages, especially in the digital era where network effects and platform models are prevalent.\n\n### **Components of a Business Model**\n- **Business Model Canvas:** A popular framework that includes key partners, activities, value proposition, customer relationships, segments, resources, channels, cost structure, and revenue streams.\n- **Lean Startup Canvas:** Focuses on experimentation, customer feedback, and iterative design, especially for startups.\n\n### **FourWeekMBA Perspective**\n- Emphasizes simplicity, noise reduction, branding, distribution, and profitability.\n- Divides business model components into \u201cpeople\u201d (brand, value proposition, positioning) and \u201cfinancial\u201d (customer segments, channels, profit formula) dimensions.\n\n### **Types of Business Models**\nThe document details **30+ business model types**, including:\n- **Hidden Revenue (Asymmetric):** Monetizing user data (e.g., Company1, Company2)\n- **One-for-One:** Social impact with each sale (e.g., TOMS Shoes)\n- **Razor and Blade:** Selling a core product cheaply, accessories at a premium (e.g., Company3)\n- **Peer-to-Peer:** Platforms connecting users directly (e.g., Company4)\n- **Multi-Sided Platforms:** Serving multiple customer groups (e.g., Company5)\n- **Freemium, Subscription, Affiliate, Consulting, Agency, Vertically Integrated, E-commerce Marketplace, Discount, Attention Merchant, Privacy-focused, Franchise, On-Demand, User-Generated Content, Educational, Chain/Franchise Mix, Instant News, Blockchain-based, Multi-brand, Family-owned, Humanist Enterprise, Direct-to-Consumer, Enterprise Sales, Distribution-based**, and more.\n\n### **Key Takeaways**\n- There\u2019s no single \u201cbest\u201d business model\u2014success depends on context, timing, and market conditions.\n- Business models must evolve as markets and technologies change.\n- Experimentation, clear value propositions, and understanding both people and financial dimensions are critical for building a sustainable business.\n\n---\n\nWould you like a deeper dive into any specific business model type or framework mentioned in the document?",
      "createdDateTime": "2025-09-30T22:18:39.5526475Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked for a summary of the document **[Business-Model.docx](https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502)**. Here's a concise overview based on its content:\n\n---\n\n## **Summary: What Is a Business Model?**\n\n### **Definition & Importance**\n- A **business model** is a holistic framework for creating, delivering, and capturing value. It's not just about how a company makes money, but how it creates value for customers, partners, and itself over the long term.\n- Business models are essential for startups and established companies alike, as they help unlock sustainable value and guide experimentation in the marketplace.\n\n### **Key Distinctions**\n- **Not a Business Plan:** A business model is different from a business plan. While a business plan is a static document with projections and assumptions, a business model is dynamic and focused on real-world experimentation.\n- **Not Just Revenue Strategy:** Monetization is only one part of a business model. Other components include operations, customer acquisition, retention, supply chain, and more.\n\n### **Design & Experimentation**\n- Business model design is about building a sustainable value chain, starting with a clear value proposition and focusing on a specific niche before scaling.\n- Experimentation is crucial—entrepreneurs must test and iterate on their models to find what works in the real world.\n\n### **Innovation**\n- **Technological vs. Business Model Innovation:** While technology can enable new business models, true innovation often comes from rethinking how value is created and delivered, not just from new tech.\n- **Competitive Moats:** Business model innovation can create lasting competitive advantages, especially in the digital era where network effects and platform models are prevalent.\n\n### **Components of a Business Model**\n- **Business Model Canvas:** A popular framework that includes key partners, activities, value proposition, customer relationships, segments, resources, channels, cost structure, and revenue streams.\n- **Lean Startup Canvas:** Focuses on experimentation, customer feedback, and iterative design, especially for startups.\n\n### **FourWeekMBA Perspective**\n- Emphasizes simplicity, noise reduction, branding, distribution, and profitability.\n- Divides business model components into \"people\" (brand, value proposition, positioning) and \"financial\" (customer segments, channels, profit formula) dimensions.\n\n### **Types of Business Models**\nThe document details **30+ business model types**, including:\n- **Hidden Revenue (Asymmetric):** Monetizing user data (e.g., Company1, Company2)\n- **One-for-One:** Social impact with each sale (e.g., TOMS Shoes)\n- **Razor and Blade:** Selling a core product cheaply, accessories at a premium (e.g., Company3)\n- **Peer-to-Peer:** Platforms connecting users directly (e.g., Company4)\n- **Multi-Sided Platforms:** Serving multiple customer groups (e.g., Company5)\n- **Freemium, Subscription, Affiliate, Consulting, Agency, Vertically Integrated, E-commerce Marketplace, Discount, Attention Merchant, Privacy-focused, Franchise, On-Demand, User-Generated Content, Educational, Chain/Franchise Mix, Instant News, Blockchain-based, Multi-brand, Family-owned, Humanist Enterprise, Direct-to-Consumer, Enterprise Sales, Distribution-based**, and more.\n\n### **Key Takeaways**\n- There's no single \"best\" business model—success depends on context, timing, and market conditions.\n- Business models must evolve as markets and technologies change.\n- Experimentation, clear value propositions, and understanding both people and financial dimensions are critical for building a sustainable business.\n\n---\n\nWould you like a deeper dive into any specific business model type or framework mentioned in the document?",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "citation",
          "providerDisplayName": "529425287-What-Is-a-Business-Model",
          "attributionSource": "grounding",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:750

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:22:26.0001517Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": []
}
id:754

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T22:18:31.7402377Z",
  "displayName": "What meeting do I have at 9 AM tomorrow morning?",
  "state": "active",
  "turnCount": 2,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "a4c65bce-f72d-4511-880c-99264f5c5d16",
      "text": "Summarize this document for me.",
      "createdDateTime": "2025-09-30T22:18:31.7402377Z",
      "adaptiveCards": [],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    },
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "bb926a9c-3b77-4477-b5bd-12abd8ff51e3",
      "text": "You asked for a summary of the document **<File>Business-Model.docx</File>**. Here\u2019s a concise overview based on its content:\n\n---\n\n## **Summary: What Is a Business Model?**\n\n### **Definition & Importance**\n- A **business model** is a holistic framework for creating, delivering, and capturing value. It\u2019s not just about how a company makes money, but how it creates value for customers, partners, and itself over the long term.\n- Business models are essential for startups and established companies alike, as they help unlock sustainable value and guide experimentation in the marketplace.\n\n### **Key Distinctions**\n- **Not a Business Plan:** A business model is different from a business plan. While a business plan is a static document with projections and assumptions, a business model is dynamic and focused on real-world experimentation.\n- **Not Just Revenue Strategy:** Monetization is only one part of a business model. Other components include operations, customer acquisition, retention, supply chain, and more.\n\n### **Design & Experimentation**\n- Business model design is about building a sustainable value chain, starting with a clear value proposition and focusing on a specific niche before scaling.\n- Experimentation is crucial\u2014entrepreneurs must test and iterate on their models to find what works in the real world.\n\n### **Innovation**\n- **Technological vs. Business Model Innovation:** While technology can enable new business models, true innovation often comes from rethinking how value is created and delivered, not just from new tech.\n- **Competitive Moats:** Business model innovation can create lasting competitive advantages, especially in the digital era where network effects and platform models are prevalent.\n\n### **Components of a Business Model**\n- **Business Model Canvas:** A popular framework that includes key partners, activities, value proposition, customer relationships, segments, resources, channels, cost structure, and revenue streams.\n- **Lean Startup Canvas:** Focuses on experimentation, customer feedback, and iterative design, especially for startups.\n\n### **FourWeekMBA Perspective**\n- Emphasizes simplicity, noise reduction, branding, distribution, and profitability.\n- Divides business model components into \u201cpeople\u201d (brand, value proposition, positioning) and \u201cfinancial\u201d (customer segments, channels, profit formula) dimensions.\n\n### **Types of Business Models**\nThe document details **30+ business model types**, including:\n- **Hidden Revenue (Asymmetric):** Monetizing user data (e.g., Company1, Company2)\n- **One-for-One:** Social impact with each sale (e.g., TOMS Shoes)\n- **Razor and Blade:** Selling a core product cheaply, accessories at a premium (e.g., Company3)\n- **Peer-to-Peer:** Platforms connecting users directly (e.g., Company4)\n- **Multi-Sided Platforms:** Serving multiple customer groups (e.g., Company5)\n- **Freemium, Subscription, Affiliate, Consulting, Agency, Vertically Integrated, E-commerce Marketplace, Discount, Attention Merchant, Privacy-focused, Franchise, On-Demand, User-Generated Content, Educational, Chain/Franchise Mix, Instant News, Blockchain-based, Multi-brand, Family-owned, Humanist Enterprise, Direct-to-Consumer, Enterprise Sales, Distribution-based**, and more.\n\n### **Key Takeaways**\n- There\u2019s no single \u201cbest\u201d business model\u2014success depends on context, timing, and market conditions.\n- Business models must evolve as markets and technologies change.\n- Experimentation, clear value propositions, and understanding both people and financial dimensions are critical for building a sustainable business.\n\n---\n\nWould you like a deeper dive into any specific business model type or framework mentioned in the document?",
      "createdDateTime": "2025-09-30T22:18:39.5526475Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked for a summary of the document **[Business-Model.docx](https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502)**. Here's a concise overview based on its content:\n\n---\n\n## **Summary: What Is a Business Model?**\n\n### **Definition & Importance**\n- A **business model** is a holistic framework for creating, delivering, and capturing value. It's not just about how a company makes money, but how it creates value for customers, partners, and itself over the long term.\n- Business models are essential for startups and established companies alike, as they help unlock sustainable value and guide experimentation in the marketplace.\n\n### **Key Distinctions**\n- **Not a Business Plan:** A business model is different from a business plan. While a business plan is a static document with projections and assumptions, a business model is dynamic and focused on real-world experimentation.\n- **Not Just Revenue Strategy:** Monetization is only one part of a business model. Other components include operations, customer acquisition, retention, supply chain, and more.\n\n### **Design & Experimentation**\n- Business model design is about building a sustainable value chain, starting with a clear value proposition and focusing on a specific niche before scaling.\n- Experimentation is crucial—entrepreneurs must test and iterate on their models to find what works in the real world.\n\n### **Innovation**\n- **Technological vs. Business Model Innovation:** While technology can enable new business models, true innovation often comes from rethinking how value is created and delivered, not just from new tech.\n- **Competitive Moats:** Business model innovation can create lasting competitive advantages, especially in the digital era where network effects and platform models are prevalent.\n\n### **Components of a Business Model**\n- **Business Model Canvas:** A popular framework that includes key partners, activities, value proposition, customer relationships, segments, resources, channels, cost structure, and revenue streams.\n- **Lean Startup Canvas:** Focuses on experimentation, customer feedback, and iterative design, especially for startups.\n\n### **FourWeekMBA Perspective**\n- Emphasizes simplicity, noise reduction, branding, distribution, and profitability.\n- Divides business model components into \"people\" (brand, value proposition, positioning) and \"financial\" (customer segments, channels, profit formula) dimensions.\n\n### **Types of Business Models**\nThe document details **30+ business model types**, including:\n- **Hidden Revenue (Asymmetric):** Monetizing user data (e.g., Company1, Company2)\n- **One-for-One:** Social impact with each sale (e.g., TOMS Shoes)\n- **Razor and Blade:** Selling a core product cheaply, accessories at a premium (e.g., Company3)\n- **Peer-to-Peer:** Platforms connecting users directly (e.g., Company4)\n- **Multi-Sided Platforms:** Serving multiple customer groups (e.g., Company5)\n- **Freemium, Subscription, Affiliate, Consulting, Agency, Vertically Integrated, E-commerce Marketplace, Discount, Attention Merchant, Privacy-focused, Franchise, On-Demand, User-Generated Content, Educational, Chain/Franchise Mix, Instant News, Blockchain-based, Multi-brand, Family-owned, Humanist Enterprise, Direct-to-Consumer, Enterprise Sales, Distribution-based**, and more.\n\n### **Key Takeaways**\n- There's no single \"best\" business model—success depends on context, timing, and market conditions.\n- Business models must evolve as markets and technologies change.\n- Experimentation, clear value propositions, and understanding both people and financial dimensions are critical for building a sustainable business.\n\n---\n\nWould you like a deeper dive into any specific business model type or framework mentioned in the document?",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        },
        {
          "attributionType": "citation",
          "providerDisplayName": "529425287-What-Is-a-Business-Model",
          "attributionSource": "grounding",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:755

例 3: Microsoft 365 Copilot Chat API にチャットメッセージを送信するときに Web 検索の根拠を切り替える

次の例は、チャット API にチャットメッセージを送信するときに Web 検索の根拠をオフにする方法を示しています。 Web 検索の接地をオフに切り替えた場合、チャットメッセージに応答するためにエンタープライズ検索の接地のみが使用されます。 Web 検索の接地を切り替える操作は、1 ターン操作です。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/copilot/conversations/d0f6bffa-49d4-43c6-b93b-e7183f92b765/chatOverStream
Content-Type: application/json

{
  "message": {
    "text": "What is the highest grossing movie at the global box office this year?"
  },
  "locationHint": {
    "timeZone": "America/New_York"
  },
  "contextualResources": {
    "webContext": {
      "isWebEnabled": false
    }
  }
}

応答

次の例は応答を示しています。ほとんどのイベントストリームは、簡潔にするために例から編集されます。

HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T23:28:08.0226573Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "f1ed80bd-033a-412a-a228-02c68dd6f4cf",
      "text": "You asked: **What is the highest grossing movie at the global box office this year?**\n\nI do not have access to real-time web search or external box office databases, and there are no internal enterprise resources or files provided that contain up-to-date box office data for movies released this year. The uploaded document, **<File>Business-Model.docx</File>**, does not contain information about movies or box office statistics.\n\n**To find the most current and accurate answer**, I recommend checking reputable entertainment industry sources such as:\n- https://www.source1.com/\n- https://www.source2.com/\n- https://source3.com/\n- https://source4.com/\n\nIf you have a specific internal report or file related to box office performance, please upload it or provide more details, and I'll be happy to summarize or analyze it for you!",
      "createdDateTime": "2025-09-30T23:27:24.5020727Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked: **What is the highest grossing movie at the global box office this year?**\n\nI do not have access to real-time web search or external box office databases, and there are no internal enterprise resources or files provided that contain up-to-date box office data for movies released this year. The uploaded document, **[Business-Model.docx](https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502)**, does not contain information about movies or box office statistics.\n\n**To find the most current and accurate answer**, I recommend checking reputable entertainment industry sources such as:\n- https://www.source1.com/\n- https://www.source2.com/\n- https://source3.com/\n- https://source4.com/\n\nIf you have a specific internal report or file related to box office performance, please upload it or provide more details, and I'll be happy to summarize or analyze it for you!",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:207

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T23:28:09.270304Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": []
}
id:209

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-09-30T23:27:21.1084028Z",
  "displayName": "What meeting do I have at 9 AM tomorrow morning?",
  "state": "active",
  "turnCount": 3,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "d6471430-d4f8-4283-83a2-22a5d9d967a8",
      "text": "What is the highest grossing movie at the global box office this year?",
      "createdDateTime": "2025-09-30T23:27:21.1084028Z",
      "adaptiveCards": [],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    },
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "f1ed80bd-033a-412a-a228-02c68dd6f4cf",
      "text": "You asked: **What is the highest grossing movie at the global box office this year?**\n\nI do not have access to real-time web search or external box office databases, and there are no internal enterprise resources or files provided that contain up-to-date box office data for movies released this year. The uploaded document, **<File>Business-Model.docx</File>**, does not contain information about movies or box office statistics.\n\n**To find the most current and accurate answer**, I recommend checking reputable entertainment industry sources such as:\n- https://www.source1.com/\n- https://www.source2.com/\n- https://source3.com/\n- https://source4.com/\n\nIf you have a specific internal report or file related to box office performance, please upload it or provide more details, and I'll be happy to summarize or analyze it for you!",
      "createdDateTime": "2025-09-30T23:27:24.5020727Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked: **What is the highest grossing movie at the global box office this year?**\n\nI do not have access to real-time web search or external box office databases, and there are no internal enterprise resources or files provided that contain up-to-date box office data for movies released this year. The uploaded document, **[Business-Model.docx](https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502)**, does not contain information about movies or box office statistics.\n\n**To find the most current and accurate answer**, I recommend checking reputable entertainment industry sources such as:\n- https://www.source1.com/\n- https://www.source2.com/\n- https://source3.com/\n- https://source4.com/\n\nIf you have a specific internal report or file related to box office performance, please upload it or provide more details, and I'll be happy to summarize or analyze it for you!",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [
        {
          "attributionType": "annotation",
          "providerDisplayName": "",
          "attributionSource": "model",
          "seeMoreWebUrl": "https://contoso.sharepoint.com/sites/Engineering/_layouts/15/Doc.aspx?sourcedoc=%7B8148C99B-78BD-4969-ABD5-A46862073990%7D&file=Business-Model.docx&action=default&mobileredirect=true&EntityRepresentationId=ce9ee99a-786c-44f5-a809-f6a8166a8502",
          "imageWebUrl": "",
          "imageFavIcon": "",
          "imageWidth": 0,
          "imageHeight": 0
        }
      ],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:210

例 4: チャットメッセージを含むコンテキストを Microsoft 365 Copilot Chat API に送信する

次の例は、チャットメッセージを含むより多くのコンテキストを Chat API に送信する方法を示しています。この余分なコンテキストにより、ドキュメント、記事、Web サイトからの抜粋など、チャット API が推論を行う基盤が提供されます。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/copilot/conversations/d0f6bffa-49d4-43c6-b93b-e7183f92b765/chatOverStream
Content-Type: application/json

{
  "message": {
    "text": "What is the birthday of my best friend, John Doe?"
  },
  "additionalContext": [
    {
      "text": "John Doe's birthday is on January 1st."
    }
  ],
  "locationHint": {
    "timeZone": "America/New_York"
  }
}

応答

次の例は応答を示しています。ほとんどのイベントストリームは、簡潔にするために例から編集されます。

HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-10-01T00:11:19.747816Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "ab9e1ebc-925c-4d96-900e-d85fb9cb1181",
      "text": "You asked: **\"What is the birthday of my best friend, John Doe?\"**\n\nBased on the information available, **John Doe's birthday is on January 1st**[^external^].\n\nIf you need this recorded for future reference or want to add more details about John Doe, just let me know!",
      "createdDateTime": "2025-10-01T00:10:59.3842333Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked: **\"What is the birthday of my best friend, John Doe?\"**\n\nBased on the information available, **John Doe's birthday is on January 1st**[^external^].\n\nIf you need this recorded for future reference or want to add more details about John Doe, just let me know!",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:68

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-10-01T00:11:20.8974283Z",
  "displayName": "Intermediate Conversation Update",
  "state": "active",
  "turnCount": 0,
  "messages": []
}
id:70

data: {
  "id": "d0f6bffa-49d4-43c6-b93b-e7183f92b765",
  "agentId": null,
  "createdDateTime": "2025-10-01T00:10:56.6481261Z",
  "displayName": "What meeting do I have at 9 AM tomorrow morning?",
  "state": "active",
  "turnCount": 4,
  "messages": [
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "18bedd46-2de8-4dc7-86ec-5798215832d4",
      "text": "What is the birthday of my best friend, John Doe?",
      "createdDateTime": "2025-10-01T00:10:56.6481261Z",
      "adaptiveCards": [],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    },
    {
      "@odata.type": "#microsoft.graph.copilotConversationResponseMessage",
      "id": "ab9e1ebc-925c-4d96-900e-d85fb9cb1181",
      "text": "You asked: **\"What is the birthday of my best friend, John Doe?\"**\n\nBased on the information available, **John Doe's birthday is on January 1st**[^external^].\n\nIf you need this recorded for future reference or want to add more details about John Doe, just let me know!",
      "createdDateTime": "2025-10-01T00:10:59.3842333Z",
      "adaptiveCards": [
        {
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
            {
              "type": "TextBlock",
              "text": "You asked: **\"What is the birthday of my best friend, John Doe?\"**\n\nBased on the information available, **John Doe's birthday is on January 1st**[^external^].\n\nIf you need this recorded for future reference or want to add more details about John Doe, just let me know!",
              "wrap": true
            }
          ]
        }
      ],
      "attributions": [],
      "sensitivityLabel": {
        "sensitivityLabelId": null,
        "displayName": null,
        "tooltip": null,
        "priority": null,
        "color": null,
        "isEncrypted": null
      }
    }
  ]
}
id:71

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-17

次の方法で共有

copilotConversation: chatOverStream

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

例 1: Microsoft 365 Copilot Chat API にチャット メッセージを送信する

要求

応答

例 2: Microsoft 365 Copilot Chat API へのチャット メッセージのコンテキストとして OneDrive または SharePoint ファイルを使用する

要求

応答

例 3: Microsoft 365 Copilot Chat API にチャット メッセージを送信するときに Web 検索の根拠を切り替える

要求

応答

例 4: チャット メッセージを含むコンテキストを Microsoft 365 Copilot Chat API に送信する

要求

応答

関連コンテンツ

フィードバック

その他のリソース

例 1: Microsoft 365 Copilot Chat API にチャットメッセージを送信する

例 2: Microsoft 365 Copilot Chat API へのチャットメッセージのコンテキストとして OneDrive または SharePoint ファイルを使用する

例 3: Microsoft 365 Copilot Chat API にチャットメッセージを送信するときに Web 検索の根拠を切り替える

例 4: チャットメッセージを含むコンテキストを Microsoft 365 Copilot Chat API に送信する