Agent self-identification

guildai~get_self returns the calling agent’s own identity — agent details, running version, session context, and workspace — in a single idempotent call. No parameters are required; the runtime resolves identity automatically from execution context. The primary use case is attribution: call guildai_get_self just before posting to an external system — a pull request comment, Slack message, or Jira ticket — to attach accurate source information without threading identity details through prompts or agent inputs.

const self = await task.tools.guildai_get_self({})

guildai_get_self is automatically available to every running agent. No tool set import or credential configuration is required.

Response payload

Field	Type	Description
`agent`	object \| null	Agent details. Null when the session is running under the built-in assistant rather than a published agent.
`version`	object \| null	Agent version details. Null when the session is running under the built-in assistant.
`session`	object	Current session details.
`workspace`	object	Current workspace details.

`agent` fields

Field	Type	Description
`id`	string	Agent ID.
`name`	string	Agent name.
`full_name`	string	Agent full name in `owner~name` format.
`is_public`	boolean	Whether the agent is publicly visible.
`public_profile_url`	string \| null	URL to the agent’s public profile page (`{FRONTEND_URL}/hub/agents/{owner}~{name}`). Null when the agent is private.
`owner`	object	Agent owner. See owner fields.

`version` fields

Field	Type	Description
`id`	string	Version ID.
`status`	string	Publication status: `DRAFT`, `PUBLISHING`, or `PUBLISHED`.
`version_number`	string \| null	Version number. Null when `status` is `DRAFT`.

`session` fields

Field	Type	Description
`id`	string	Session ID.
`session_type`	string	Session type: `chat`, `agent_test`, `time`, or `webhook`.
`session_url`	string	URL to the current session in the Guild UI.
`workspace_url`	string	URL to the current workspace in the Guild UI.

`workspace` fields

Field	Type	Description
`id`	string	Workspace ID.
`name`	string	Workspace name.
`full_name`	string	Workspace full name in `owner/workspace` format.
`owner`	object	Workspace owner. See owner fields.

`owner` fields

Both agent.owner and workspace.owner share this shape.

Field	Type	Description
`id`	string	Owner ID.
`type`	string	Owner type: `user` or `organization`.
`name`	string	Owner name.

Attribution example

Call guildai_get_self once at the start of any run that will post to an external service, then reuse the result for each outbound action:

import { gitHubTools } from "@guildai-services/guildai~github"

// ...

const self = await task.tools.guildai_get_self({})

// Build a reusable attribution link
const attribution = self.agent
  ? `[${self.agent.full_name}](${self.session.session_url})`
  : `[Guild Assistant](${self.session.session_url})`

// Post a GitHub PR comment attributed to this agent
await task.tools.github_issues_create_comment({
  owner: "myorg",
  repo: "myrepo",
  issue_number: prNumber,
  body: `Review complete — posted by ${attribution}.`,
})

// Post a Slack message attributed to this agent
await task.tools.slack_chat_postMessage({
  channel: "#deploys",
  text: `Deploy triggered by ${attribution} in workspace \`${self.workspace.full_name}\`.`,
})

guildai_get_self is cheap and idempotent. Call it once per run and reuse the result across all external actions in the same agent invocation.

Reference

Configuration

Agent self-identification

Response payload

`agent` fields

`version` fields

`session` fields

`workspace` fields

`owner` fields

Attribution example

​Response payload

​agent fields

​version fields

​session fields

​workspace fields

​owner fields

​Attribution example

Response payload

`agent` fields

`version` fields

`session` fields

`workspace` fields

`owner` fields

Attribution example