Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновите свойства объекта agentCardManifest .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
| Делегированные (рабочая или учебная учетная запись) |
AgentCardManifest.ReadWrite.All |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Приложение |
AgentCardManifest.ReadWrite.All |
AgentCardManifest.ReadWrite.ManagedBy |
Важно!
При использовании делегированных разрешений пользователю, прошедшему проверку подлинности, должна быть назначена поддерживаемая Microsoft Entra роль или пользовательская роль, которая предоставляет разрешения, необходимые для этой операции.
Администратор реестра агентов — это наименее привилегированная роль, поддерживаемая для этой операции.
HTTP-запрос
PATCH /agentRegistry/agentCardManifests/{agentCardManifestId}
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
| Свойство |
Тип |
Описание |
| displayName |
String |
Отображаемое имя агента. Необязательный параметр. |
| description |
String |
Описание назначения агента. Необязательный параметр. |
| iconUrl |
String |
URL-адрес изображения значка агента. Необязательный параметр. |
| protocolVersion |
String |
Версия протокола, поддерживаемая агентом. Необязательный параметр. |
| version |
String |
Версия реализации агента. Необязательный параметр. |
| DocumentationUrl |
String |
URL-адрес документации агента. Необязательный параметр. |
| defaultInputModes |
Коллекция строк |
Поддерживаемые режимы ввода по умолчанию. Необязательный параметр. |
| defaultOutputModes |
Коллекция строк |
Поддерживаемые режимы вывода по умолчанию. Необязательный параметр. |
| Поставщика |
agentProvider |
Сведения об организации, предоставляющей агент. Необязательный параметр. |
| securitySchemes |
securitySchemes |
Словарь определений схем безопасности с ключом по имени схемы. Необязательный параметр. |
| Безопасности |
коллекция securityRequirement |
Требования к безопасности — массив ссылок на схемы безопасности. Необязательный параметр. |
| capabilities |
agentCapabilities |
Определенные возможности, поддерживаемые агентом. Необязательный параметр. |
| skills. |
Коллекция agentSkill |
Навыки и возможности, которые может выполнять агент. Необязательный параметр. |
| supportsAuthenticatedExtendedCard |
Логический |
Поддерживает ли агент расширенный карта получение с проверкой подлинности. Необязательный параметр. |
| ownerIds |
Коллекция строк |
Список идентификаторов владельца для карта манифеста агента может быть пользователем или субъектами-службами. Необязательный параметр. |
| Managedby |
String |
Идентификатор приложения, управляющий этим манифестом. Необязательный параметр. |
| originatingStore |
String |
Имя хранилища или системы, в которой был создан агент. Необязательный параметр. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект agentCardManifest в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/agentRegistry/agentCardManifests/{agentCardManifestId}
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.agentCardManifest",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"protocolVersion": "String",
"displayName": "String",
"description": "String",
"iconUrl": "String",
"provider": {
"@odata.type": "microsoft.graph.agentProvider"
},
"version": "String",
"documentationUrl": "String",
"capabilities": {
"@odata.type": "microsoft.graph.agentCapabilities"
},
"securitySchemes": {
"@odata.type": "microsoft.graph.securitySchemes"
},
"security": [
{
"@odata.type": "microsoft.graph.securityRequirement"
}
],
"defaultInputModes": [
"String"
],
"defaultOutputModes": [
"String"
],
"skills": [
{
"@odata.type": "microsoft.graph.agentSkill"
}
],
"supportsAuthenticatedExtendedCard": "Boolean"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new AgentCardManifest
{
OdataType = "#microsoft.graph.agentCardManifest",
OwnerIds = new List<string>
{
"String",
},
ManagedBy = "String",
OriginatingStore = "String",
CreatedBy = "String",
ProtocolVersion = "String",
DisplayName = "String",
Description = "String",
IconUrl = "String",
Provider = new AgentProvider
{
OdataType = "microsoft.graph.agentProvider",
},
Version = "String",
DocumentationUrl = "String",
Capabilities = new AgentCapabilities
{
OdataType = "microsoft.graph.agentCapabilities",
},
SecuritySchemes = new SecuritySchemes
{
OdataType = "microsoft.graph.securitySchemes",
},
Security = new List<SecurityRequirement>
{
new SecurityRequirement
{
OdataType = "microsoft.graph.securityRequirement",
},
},
DefaultInputModes = new List<string>
{
"String",
},
DefaultOutputModes = new List<string>
{
"String",
},
Skills = new List<AgentSkill>
{
new AgentSkill
{
OdataType = "microsoft.graph.agentSkill",
},
},
SupportsAuthenticatedExtendedCard = boolean,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AgentRegistry.AgentCardManifests["{agentCardManifest-id}"].PatchAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewAgentCardManifest()
ownerIds := []string {
"String",
}
requestBody.SetOwnerIds(ownerIds)
managedBy := "String"
requestBody.SetManagedBy(&managedBy)
originatingStore := "String"
requestBody.SetOriginatingStore(&originatingStore)
createdBy := "String"
requestBody.SetCreatedBy(&createdBy)
protocolVersion := "String"
requestBody.SetProtocolVersion(&protocolVersion)
displayName := "String"
requestBody.SetDisplayName(&displayName)
description := "String"
requestBody.SetDescription(&description)
iconUrl := "String"
requestBody.SetIconUrl(&iconUrl)
provider := graphmodels.NewAgentProvider()
requestBody.SetProvider(provider)
version := "String"
requestBody.SetVersion(&version)
documentationUrl := "String"
requestBody.SetDocumentationUrl(&documentationUrl)
capabilities := graphmodels.NewAgentCapabilities()
requestBody.SetCapabilities(capabilities)
securitySchemes := graphmodels.NewSecuritySchemes()
requestBody.SetSecuritySchemes(securitySchemes)
securityRequirement := graphmodels.NewSecurityRequirement()
security := []graphmodels.SecurityRequirementable {
securityRequirement,
}
requestBody.SetSecurity(security)
defaultInputModes := []string {
"String",
}
requestBody.SetDefaultInputModes(defaultInputModes)
defaultOutputModes := []string {
"String",
}
requestBody.SetDefaultOutputModes(defaultOutputModes)
agentSkill := graphmodels.NewAgentSkill()
skills := []graphmodels.AgentSkillable {
agentSkill,
}
requestBody.SetSkills(skills)
supportsAuthenticatedExtendedCard := boolean
requestBody.SetSupportsAuthenticatedExtendedCard(&supportsAuthenticatedExtendedCard)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
agentCardManifests, err := graphClient.AgentRegistry().AgentCardManifests().ByAgentCardManifestId("agentCardManifest-id").Patch(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
AgentCardManifest agentCardManifest = new AgentCardManifest();
agentCardManifest.setOdataType("#microsoft.graph.agentCardManifest");
LinkedList<String> ownerIds = new LinkedList<String>();
ownerIds.add("String");
agentCardManifest.setOwnerIds(ownerIds);
agentCardManifest.setManagedBy("String");
agentCardManifest.setOriginatingStore("String");
agentCardManifest.setCreatedBy("String");
agentCardManifest.setProtocolVersion("String");
agentCardManifest.setDisplayName("String");
agentCardManifest.setDescription("String");
agentCardManifest.setIconUrl("String");
AgentProvider provider = new AgentProvider();
provider.setOdataType("microsoft.graph.agentProvider");
agentCardManifest.setProvider(provider);
agentCardManifest.setVersion("String");
agentCardManifest.setDocumentationUrl("String");
AgentCapabilities capabilities = new AgentCapabilities();
capabilities.setOdataType("microsoft.graph.agentCapabilities");
agentCardManifest.setCapabilities(capabilities);
SecuritySchemes securitySchemes = new SecuritySchemes();
securitySchemes.setOdataType("microsoft.graph.securitySchemes");
agentCardManifest.setSecuritySchemes(securitySchemes);
LinkedList<SecurityRequirement> security = new LinkedList<SecurityRequirement>();
SecurityRequirement securityRequirement = new SecurityRequirement();
securityRequirement.setOdataType("microsoft.graph.securityRequirement");
security.add(securityRequirement);
agentCardManifest.setSecurity(security);
LinkedList<String> defaultInputModes = new LinkedList<String>();
defaultInputModes.add("String");
agentCardManifest.setDefaultInputModes(defaultInputModes);
LinkedList<String> defaultOutputModes = new LinkedList<String>();
defaultOutputModes.add("String");
agentCardManifest.setDefaultOutputModes(defaultOutputModes);
LinkedList<AgentSkill> skills = new LinkedList<AgentSkill>();
AgentSkill agentSkill = new AgentSkill();
agentSkill.setOdataType("microsoft.graph.agentSkill");
skills.add(agentSkill);
agentCardManifest.setSkills(skills);
agentCardManifest.setSupportsAuthenticatedExtendedCard(boolean);
AgentCardManifest result = graphClient.agentRegistry().agentCardManifests().byAgentCardManifestId("{agentCardManifest-id}").patch(agentCardManifest);
const options = {
authProvider,
};
const client = Client.init(options);
const agentCardManifest = {
'@odata.type': '#microsoft.graph.agentCardManifest',
ownerIds: [
'String'
],
managedBy: 'String',
originatingStore: 'String',
createdBy: 'String',
protocolVersion: 'String',
displayName: 'String',
description: 'String',
iconUrl: 'String',
provider: {
'@odata.type': 'microsoft.graph.agentProvider'
},
version: 'String',
documentationUrl: 'String',
capabilities: {
'@odata.type': 'microsoft.graph.agentCapabilities'
},
securitySchemes: {
'@odata.type': 'microsoft.graph.securitySchemes'
},
security: [
{
'@odata.type': 'microsoft.graph.securityRequirement'
}
],
defaultInputModes: [
'String'
],
defaultOutputModes: [
'String'
],
skills: [
{
'@odata.type': 'microsoft.graph.agentSkill'
}
],
supportsAuthenticatedExtendedCard: 'Boolean'
};
await client.api('/agentRegistry/agentCardManifests/{agentCardManifestId}')
.version('beta')
.update(agentCardManifest);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\AgentCardManifest;
use Microsoft\Graph\Beta\Generated\Models\AgentProvider;
use Microsoft\Graph\Beta\Generated\Models\AgentCapabilities;
use Microsoft\Graph\Beta\Generated\Models\SecuritySchemes;
use Microsoft\Graph\Beta\Generated\Models\SecurityRequirement;
use Microsoft\Graph\Beta\Generated\Models\AgentSkill;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new AgentCardManifest();
$requestBody->setOdataType('#microsoft.graph.agentCardManifest');
$requestBody->setOwnerIds(['String', ]);
$requestBody->setManagedBy('String');
$requestBody->setOriginatingStore('String');
$requestBody->setCreatedBy('String');
$requestBody->setProtocolVersion('String');
$requestBody->setDisplayName('String');
$requestBody->setDescription('String');
$requestBody->setIconUrl('String');
$provider = new AgentProvider();
$provider->setOdataType('microsoft.graph.agentProvider');
$requestBody->setProvider($provider);
$requestBody->setVersion('String');
$requestBody->setDocumentationUrl('String');
$capabilities = new AgentCapabilities();
$capabilities->setOdataType('microsoft.graph.agentCapabilities');
$requestBody->setCapabilities($capabilities);
$securitySchemes = new SecuritySchemes();
$securitySchemes->setOdataType('microsoft.graph.securitySchemes');
$requestBody->setSecuritySchemes($securitySchemes);
$securitySecurityRequirement1 = new SecurityRequirement();
$securitySecurityRequirement1->setOdataType('microsoft.graph.securityRequirement');
$securityArray []= $securitySecurityRequirement1;
$requestBody->setSecurity($securityArray);
$requestBody->setDefaultInputModes(['String', ]);
$requestBody->setDefaultOutputModes(['String', ]);
$skillsAgentSkill1 = new AgentSkill();
$skillsAgentSkill1->setOdataType('microsoft.graph.agentSkill');
$skillsArray []= $skillsAgentSkill1;
$requestBody->setSkills($skillsArray);
$requestBody->setSupportsAuthenticatedExtendedCard(boolean);
$result = $graphServiceClient->agentRegistry()->agentCardManifests()->byAgentCardManifestId('agentCardManifest-id')->patch($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.agent_card_manifest import AgentCardManifest
from msgraph_beta.generated.models.agent_provider import AgentProvider
from msgraph_beta.generated.models.agent_capabilities import AgentCapabilities
from msgraph_beta.generated.models.security_schemes import SecuritySchemes
from msgraph_beta.generated.models.security_requirement import SecurityRequirement
from msgraph_beta.generated.models.agent_skill import AgentSkill
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AgentCardManifest(
odata_type = "#microsoft.graph.agentCardManifest",
owner_ids = [
"String",
],
managed_by = "String",
originating_store = "String",
created_by = "String",
protocol_version = "String",
display_name = "String",
description = "String",
icon_url = "String",
provider = AgentProvider(
odata_type = "microsoft.graph.agentProvider",
),
version = "String",
documentation_url = "String",
capabilities = AgentCapabilities(
odata_type = "microsoft.graph.agentCapabilities",
),
security_schemes = SecuritySchemes(
odata_type = "microsoft.graph.securitySchemes",
),
security = [
SecurityRequirement(
odata_type = "microsoft.graph.securityRequirement",
),
],
default_input_modes = [
"String",
],
default_output_modes = [
"String",
],
skills = [
AgentSkill(
odata_type = "microsoft.graph.agentSkill",
),
],
supports_authenticated_extended_card = Boolean,
)
result = await graph_client.agent_registry.agent_card_manifests.by_agent_card_manifest_id('agentCardManifest-id').patch(request_body)
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.agentCardManifest",
"id": "5d1d9ba4-36ed-2e0c-c182-9da69c5e398d",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"protocolVersion": "String",
"displayName": "String",
"description": "String",
"iconUrl": "String",
"provider": {
"@odata.type": "microsoft.graph.agentProvider"
},
"version": "String",
"documentationUrl": "String",
"capabilities": {
"@odata.type": "microsoft.graph.agentCapabilities"
},
"securitySchemes": {
"@odata.type": "microsoft.graph.securitySchemes"
},
"security": [
{
"@odata.type": "microsoft.graph.securityRequirement"
}
],
"defaultInputModes": [
"String"
],
"defaultOutputModes": [
"String"
],
"skills": [
{
"@odata.type": "microsoft.graph.agentSkill"
}
],
"supportsAuthenticatedExtendedCard": "Boolean"
}