10-03-02 — Connectors e Power Platform Integration

Tipos de conectores no Copilot Studio

Criando um Custom Connector para sua API .NET

// Sua API .NET — exemplo de endpoint que será exposto como conector
[ApiController]
[Route("api/tickets")]
public class TicketsController : ControllerBase
{
    [HttpPost("create")]
    [ProducesResponseType(typeof(TicketResponse), 200)]
    public async Task CreateTicket([FromBody] CreateTicketRequest request)
    {
        // Lógica de negócio
        var ticket = await _ticketService.CreateAsync(request);
        return Ok(new TicketResponse 
        { 
            Id = ticket.Id, 
            Number = ticket.Number,
            Status = "Aberto" 
        });
    }
    
    [HttpGet("{id}")]
    public async Task GetTicket(int id) { /* ... */ }
}

// Swagger é gerado automaticamente — use como base para o custom connector
// Acesse: https://sua-api.azurewebsites.net/swagger/v1/swagger.json

Importando como Custom Connector

1. No Power Platform Admin Center → Data → Custom Connectors → New
2. Import from OpenAPI file → cole o swagger.json da sua API
3. Configure autenticação (API Key, OAuth, Basic)
4. Teste os endpoints
5. No Copilot Studio → Action → Add action → Custom connector → selecione o seu

Power Automate Flows como Actions

Para automações de múltiplos passos (ex: criar ticket + enviar email + atualizar Dynamics), use um Power Automate flow chamado pelo topic.

Connectors como ferramentas (tool use)

No modo generative com custom engine, os connectors podem ser expostos como tools para o LLM decidir quando usar — análogo ao function calling do OpenAI.

// Expondo conector como ferramenta para o SK no custom engine
var kernel = new Kernel();

// Plugin que encapsula o conector Power Platform
kernel.ImportPluginFromType<TicketPlugin>("Tickets");

// O LLM decide quando chamar essa ferramenta
var result = await kernel.InvokePromptAsync(
    "O usuário quer abrir um chamado de TI sobre problema com VPN. " +
    "Use as ferramentas disponíveis para criar o chamado.",
    new KernelArguments { ["enablePlanning"] = true });