# IRPCAgent.AgentCreateSummarization

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md) > [Aino agents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/AgentCreateSummarization/

Badges: `Vault API / standard` `write` `session` `idempotent` `returns metadata structure version`

Creates an Aino summary of a set of objects. Used by M-Files clients; the request and response
formats are internal to them.

- **Service:** [Aino agents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/index.md) `MFiles.IRPCAgent`
- **gRPC method:** `/MFiles.IRPCAgent/AgentCreateSummarization`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/agent-create-summarization`
- **Request:** [`AgentRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AgentRequest/index.md)
- **Response:** [`AgentResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AgentResponse/index.md)
- **Book and level:** Vault API, standard
- **Kind:** write
- **Session:** Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
- **Idempotent:** yes
- **Returns metadata structure version:** yes (in the mfiles-metadata-version-bin trailer)
- **Streaming:** none (unary)

<a id="remarks"></a>

## Remarks

- Requires a vault session of a user and a vault where Aino summarization is available.
- The server checks that the caller can read every object named in the request; if not, the
  call fails and nothing is sent to the agent.
- Same operation as [CreateSummarization](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/CreateSummarization/index.md).

<a id="request"></a>

## Request: AgentRequest

A request to an Aino agent.

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `data` | `string` | The request document, in a format internal to the M-Files clients. |

<a id="response"></a>

## Response: AgentResponse

The answer of an Aino agent.

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `data` | `string` | The answer document, in a format internal to the M-Files clients. |

<a id="related"></a>

## Related methods

- [IRPCSearch.CreateSummarization](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/CreateSummarization/index.md): Creates an Aino summary for the M-Files clients.