Construindo um agente de código com o SDK da OpenAI e .NET

Agentes de código não são um único prompt gigante. São um loop com ferramentas: pensar, ler arquivos, editar trechos, buscar no repositório e repetir até a tarefa fechar.

O pipeline mínimo

Um agente útil em .NET costuma expor quatro capacidades:

• —Plan — decompor o pedido em passos verificáveis.
• —Read — carregar só os arquivos relevantes (evite context dumps).
• —Edit — patches pequenos e revisáveis, não reescritas totais.
• —Grep — busca semântica ou por texto para achar símbolos e usos.

public interface ICodingAgentStep
{
    Task<AgentObservation> RunAsync(AgentState state, CancellationToken ct);
}

Orquestração em C#

Com o SDK da OpenAI (ou outro provedor), mantenha o estado fora do modelo: histórico de passos, diffs pendentes e critérios de parada. O LLM sugere a próxima ação; seu código valida e executa.

Quando o agente erra, prefira corrigir o loop (melhor observação, limites de escopo) em vez de aumentar o tamanho do prompt.