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"
import { slackTools } from "@guildai-services/guildai~slack"
// ...
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.
