[dotnet-port-api] agent-as-tool: session propagation and argument customization

Abierto
  • ¿Algo no está bien?
#1,139 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Activo
Stack tecnológico
go
Área
ai-infra-agents, backend-api-design

Línea de trabajo

Start with the tool/agenttool constructor and its Call(ctx, argsJSON) entry point, then compare the referenced Python _agents.py and .NET AgentExtensions.cs behavior. Resolve the listed session, default, and approval questions with maintainers before implementation. Done means an agreed public API for argument customization and session propagation, with behavior matching the decision.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Parity gap surfaced comparing tool/agenttool against .NET/Python.

Gap

agenttool hardcodes a single query string argument and runs the sub-agent with an independent context, returning only resp.String(). It cannot:

  1. Propagate the parent session to the sub-agent (so a sub-agent-as-tool starts stateless every call).
  2. Customize the argument name/description.

Note: the tool name/description defaults and the query arg name already match .NET (AgentExtensions.cs), so those are intentionally aligned — only session propagation and arg customization are missing.

Reference

  • Python Agent.as_tool(arg_name="task", arg_description=..., propagate_session=..., ...) (_agents.py).
  • .NET AsAIFunction(this AIAgent, options, session) accepts a session (AgentExtensions.cs).

Proposed shape (needs maintainer input)

Add optional config to the agenttool constructor, e.g.:

agenttool.New(a, agenttool.Config{
    ArgName:        "task",         // default "query" (matches .NET)
    ArgDescription: "...",
    PropagateSession: true,          // thread the caller's *agent.Session into the sub-run
})

Open questions:

  1. How to obtain the caller session at Call time — thread it via context, or capture from the invoking run? (Go tool Call(ctx, argsJSON) has no session param today.)
  2. Should session propagation be opt-in (default off, matching a stateless tool) or default on (matching Python's common usage)?
  3. Whether to also surface sub-agent approval/user-input requests (Python raises UserInputRequiredException; .NET returns .Text — Go currently matches .NET).

Filing issue-first per CONTRIBUTING (new public API). Happy to implement once the direction is settled.

Lenguaje dominante
Go
Estrellas
671
Forks
68
Merge medio
18 h 11 min
PR fusionados (30 d)
82

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de microsoft/agent-framework-go

Todos los issues de microsoft/agent-framework-go

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.