Visão geral da API de Registro de Agente (versão prévia)

Importante

As APIs sob a /beta versão estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

A API de Registro de Agente permite que desenvolvedores e administradores registrem e gerenciem agentes de forma programática em seu ambiente do Microsoft 365. A API permite que os usuários criem registros de agente com metadados associados e um agent card. Os desenvolvedores podem gerenciar operações de ciclo de vida do agente, como criar novos registros, atualizar configurações, recuperar detalhes do registro e excluir registros conforme necessário.

Principais recursos

  • Crie registros de agente com metadados e manifestos de card de agente.
  • Recupere detalhes completos do registro de um agente por ID.
  • Atualizar propriedades específicas de um registro de agente existente.
  • Exclua os registros de agente que não são mais necessários.

Exemplos de cenários

  • Um desenvolvedor da Contoso deseja registrar um agente de Assistente de Vendas personalizado que se integre ao seu sistema de CRM. Usando a API de registro de agente, eles podem criar um registro com os metadados do agente, fornecer uma card de agente e definir permissões de proprietário.
  • Um administrador recupera os detalhes de um registro de agente existente para revisar sua configuração e agent card.
  • Um desenvolvedor atualiza o nome de exibição e a descrição de um registro de agente existente após uma renomeação de produto.
  • Um administrador exclui um registro de agente desatualizado que não está mais em uso.

Lista de APIs

Operação Método HTTP Descrição
Criar agentRegistration POST /copilot/agentRegistrations Crie um novo registro de agente.
Get agentRegistration GET /copilot/agentRegistrations/{id} Obtenha detalhes de um registro de agente específico.
Atualizar agentRegistration PATCH /copilot/agentRegistrations/{id} Atualizar um registro de agente existente.
Excluir agentRegistration DELETE /copilot/agentRegistrations/{id} Excluir um registro de agente.

Recursos