> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Herramientas del servidor
> Permite que los modelos llamen a herramientas de Phaseo durante una solicitud.
Las herramientas del servidor son herramientas que Phaseo ejecuta durante una solicitud al modelo. El modelo decide cuándo llamarlas, Phaseo las ejecuta en el servidor y devuelve el resultado al ciclo del modelo.
Usa herramientas del servidor cuando el modelo necesite la hora actual, contexto web, texto de una página o el consejo de otro modelo, sin tener que crear tu propio ejecutor de herramientas.
Las herramientas del servidor están en fase beta. Los formatos de solicitud y los datos de respuesta pueden cambiar a medida que evolucione el soporte de los proveedores.
## Herramientas disponibles
| Herramienta | Tipo | Úsala para |
| - | - | - |
| Fecha y hora | `phaseo:datetime` | Fecha y hora actuales en hasta 5 zonas horarias |
| Búsqueda web | `phaseo:web_search` | Búsquedas web dirigidas por el modelo durante una solicitud |
| Obtención de páginas web | `phaseo:web_fetch` | Obtención y extracción de texto de URL concretas |
| Asesor | `phaseo:advisor` | Consulta a otro modelo durante la generación |
| Subagente | `phaseo:subagent` | Delegación de una tarea concreta a un modelo auxiliar |
| Fusión | `phaseo:fusion` | Análisis en paralelo seguido de una síntesis del modelo |
| Buscar modelos | `phaseo:search_models` | Búsqueda de modelos adecuados en el catálogo actualizado |
| Generación de imágenes | `phaseo:image_generation` | Creación de imágenes desde el ciclo de herramientas del modelo |
| Aplicar parche | `phaseo:apply_patch` | Generación de parches de archivos validados en la API Responses |
## Cómo funcionan las herramientas del servidor
1. Añade una o varias herramientas del servidor al arreglo `tools`.
2. El modelo decide si necesita una herramienta y emite una llamada.
3. Phaseo intercepta la llamada a la herramienta del servidor, la ejecuta y devuelve el resultado al modelo.
4. El modelo continúa y redacta la respuesta final.
Puedes usar herramientas del servidor junto con tus propias herramientas de función. Phaseo solo ejecuta las herramientas del servidor; tu aplicación sigue gestionando las llamadas `function` habituales.
## Inicio rápido
```bash theme={null}
curl https://api.phaseo.app/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5-nano",
"messages": [
{ "role": "user", "content": "What are the latest AI policy updates this week?" }
],
"tools": [
{ "type": "phaseo:web_search" },
{ "type": "phaseo:datetime", "parameters": { "timezones": ["Europe/London", "UTC"] } }
]
}'
```
## Combinar con herramientas de función
```json theme={null}
{
"model": "openai/gpt-5-nano",
"messages": [
{ "role": "user", "content": "Find recent funding news and save the best item." }
],
"tools": [
{ "type": "phaseo:web_search", "parameters": { "max_results": 3 } },
{
"type": "function",
"function": {
"name": "save_research_item",
"description": "Save a selected research item",
"parameters": {
"type": "object",
"properties": {
"title": { "type": "string" },
"url": { "type": "string" }
},
"required": ["title", "url"]
}
}
}
]
}
```
Si el modelo llama a `phaseo:web_search`, Phaseo ejecuta esa llamada automáticamente. Si llama a `save_research_item`, tu aplicación recibe la llamada a la función y debe devolver su resultado en una solicitud posterior.
## Endpoints compatibles
Las herramientas del servidor son compatibles con:
* `/v1/chat/completions`
* `/v1/responses`
* `/v1/messages`
También se admiten solicitudes en streaming. Para las herramientas del servidor gestionadas por el gateway, Phaseo puede materializar el turno de llamada a la herramienta del proveedor, ejecutarla, continuar el ciclo y generar un stream sintético con la respuesta final.
## Seguimiento del uso
El uso de herramientas del servidor se informa en `usage.server_tool_use`:
```json theme={null}
{
"usage": {
"input_tokens": 105,
"output_tokens": 250,
"server_tool_use": {
"datetime_requests": 1,
"web_search_requests": 2,
"web_search_results": 8,
"web_fetch_requests": 1,
"advisor_requests": 1,
"subagent_requests": 1,
"fusion_requests": 1,
"search_models_requests": 1,
"image_generation_requests": 1
}
}
}
```
Los precios también pueden usar medidores de herramientas del servidor como `server_tool_web_search_requests`, `server_tool_web_search_extra_results`, `server_tool_web_fetch_requests`, `server_tool_advisor_requests`, `server_tool_image_generation_requests`, `native_web_search_requests` y `native_web_fetch_requests` si están configurados en las tarjetas de precios de los modelos.
## Páginas de herramientas
Proporciona al modelo la fecha y la hora actuales.
Permite que el modelo busque en la web cuando necesite información actualizada.
Permite que el modelo obtenga y lea URL concretas.
Permite que un modelo consulte a otro durante la generación.
Permite que el modelo delegue tareas concretas a un modelo auxiliar.
Ejecuta análisis en paralelo con varios modelos y sintetiza los resultados.
Permite que el modelo busque un modelo adecuado en el catálogo actualizado de Phaseo.
Permite que el modelo cree imágenes mientras responde.
Genera un parche validado para crear, actualizar o eliminar archivos.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.